取得结果中指定字段的字段名

# mysql_field_name

(PHP 4, PHP 5)

mysql_field_name — 取得结果中指定字段的字段名

警告

本扩展自 PHP 5.5.0 起已废弃，并在自 PHP 7.0.0 开始被移除。应使用 MySQLi 或 PDO_MySQL 扩展来替换之。参见 MySQL：选择 API 指南来获取更多信息。用以替代本函数的有：

- mysqli_fetch_field_direct() [name] or [orgname]
- PDOStatement::getColumnMeta() [name]

### 说明

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

mysql_field_name() 返回指定字段索引的字段名。`result` 必须是一个合法的结果标识符，`field_index` 是该字段的数字偏移量。

> 注意: `field_index` 从 0 开始。 例如，第三个字段的索引值其实是 2，第四个字段的索引值是 3，以此类推。

> 注意: 此函数返回的字段名大小写敏感。

示例 #1 mysql_field_name() 例子

    <?php
    /* The users table consists of three fields:
     *   user_id
     *   username
     *   password.
     */
    $link = mysql_connect('localhost', "mysql_user", "mysql_password");
    $dbname = "mydb";
    mysql_select_db($dbname, $link)
        or 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);
    ?>

以上例子将产生如下输出：

    user_id
    password

为向下兼容仍然可以使用 mysql_fieldname()，但反对这样做。

### 参数

`result`
  resource 型的结果集。此结果集来自对 mysql_query() 的调用。
`field_offset`
  数值型字段偏移量。 `field_offset` 从 `0` 开始。如果 `field_offset` 不存在，则会发出一个 `E_WARNING` 级别的错误

### 返回值

The name of the specified field index on success 或者在失败时返回 `false`.

### 示例

示例 #2 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);
    ?>

以上示例会输出：

    user_id
    password

### 注释

> 注意: 此函数返回的字段名大小写敏感。

> 注意: 为了向下兼容，可以使用下列已废弃的别名： mysql_fieldname()

### 参见

- mysql_field_type() - 取得结果集中指定字段的类型
- mysql_field_len() - 返回指定字段的长度

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open