Get the name of the specified field in a result

- « mysql_field_len

- mysql_field_seek »

- PHP Manual
- MySQL Functions
- Get the name of the specified field in a result

# mysql_field_name

(PHP 4, PHP 5)

mysql_field_name — Get the name of the specified field in a result

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() [name] or [orgname]
- PDOStatement::getColumnMeta() [name]

### Description

mysql_field_name(resource `$result`, int `$field_offset`): string|false

mysql_field_name() returns the name of the specified field index.

### 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 name of the specified field index on success or `false` on failure.

### Examples

Example #1 mysql_field_name() example

    <?php/* The users table consists of three fields: *   user_id *   username *   password. */$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');if (!$link) {    die('Could not connect to MySQL server: ' . mysql_error());}$dbname = 'mydb';$db_selected = mysql_select_db($dbname, $link);if (!$db_selected) {    die("Could not set $dbname: " . mysql_error());}$res = mysql_query('select * from users', $link);echo mysql_field_name($res, 0) . "\n";echo mysql_field_name($res, 2);?>

The above example will output:

    user_id
    password

### Notes

> Note: Field names returned by this function are case-sensitive.

> Note:

> For backward compatibility, the following deprecated alias may be used: mysql_fieldname()

### See Also

- mysql_field_type() - Get the type of the specified field in a result
- mysql_field_len() - Returns the length of the specified field