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]

说明

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() - 返回指定字段的长度