mysql_field_len

(PHP 4, PHP 5)

mysql_field_len — Returns the length of the specified field

Warning

This extension was deprecated in PHP 5.5.0, and it was removed in PHP 7.0.0. Instead, the MySQLi or PDO_MySQL extension should be used. See also MySQL: choosing an API guide. Alternatives to this function include:

mysqli_fetch_field_direct() [length]
PDOStatement::getColumnMeta() [len]

Description

mysql_field_len(resource $result, int $field_offset): int|false

mysql_field_len() returns the length of the specified field.

Parameters

result: The result resource that is being evaluated. This result comes from a call to mysql_query().
field_offset: The numerical field offset. The field_offset starts at 0. If field_offset does not exist, an error of level E_WARNING is also issued.

Return Values

The length of the specified field index on success or false on failure.

Examples

Example #1 mysql_field_len() example

<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
    echo 'Could not run query: ' . mysql_error();
    exit;
}

// Will get the length of the id field as specified in the database
// schema. 
$length = mysql_field_len($result, 0);
echo $length;
?>

Notes

Note:
For backward compatibility, the following deprecated alias may be used: mysql_fieldlen()

User Contributed Notes 2 notes

down

rvwoens at gmail dot com ¶

12 years ago


Note that for some reason the length of fields is 3 times the actual value if you are using UTF8 encoding.. So a varchar(10) field returns 30 here. This renders this function almost useless.

down

-6

adam_nospam_hunger at yahoo dot com ¶

21 years ago


For a mysql type DECIMAL(8,4), the length is returned as 10 (M+2 as per documentation).

add a note