PHP mysqli fetch_field() 函数

示例 - 面向对象风格

返回结果集中的下一个字段（列），然后打印每个字段的名称、表和最大长度：

<?php
$mysqli = new mysqli("localhost","my_user","my_password","my_db");

if ($mysqli -> connect_errno) {
echo "Failed to connect to MySQL: " . $mysqli -> connect_error;
exit();
}

$sql = "SELECT Lastname, Age FROM Persons ORDER BY Lastname";

if ($result = $mysqli -> query($sql)) {
// Get field information for all fields
while ($fieldinfo = $result -> fetch_field()) {
    printf("Name: %s\n", $fieldinfo -> name);
    printf("Table: %s\n", $fieldinfo -> table);
    printf("Max. Len: %d\n", $fieldinfo -> max_length);
  }
$result -> free_result();
}

$mysqli -> close();
?>

查看底部的程序样式示例。

定义和用法

fetch_field() / mysqli_fetch_field() 函数将结果集中的下一个字段（列）作为对象返回。

语法

面向对象风格：

$mysqli_result -> fetch_field()

程序风格：

mysqli_fetch_field( result)

参数值

Parameter	Description
result	Required. Specifies a result set identifier returned by mysqli_query(), mysqli_store_result() or mysqli_use_result()

技术细节

返回值：	返回包含字段定义信息的对象。如果没有可用信息，则为 FALSE。该对象具有以下属性： name - 列的名称 orgname - 原始列名称（如果指定了别名）表 - 表的名称 orgtable - 原始表名称（如果指定了别名） def - 保留默认值，目前始终"" db - 数据库（PHP 5.3.6 中的新功能） Catalog - 目录名称，始终"def"（自 PHP 5.3.6 起） max_length - 字段的最大宽度 length - 表定义中指定的字段宽度 charsetnr - 字段的字符集编号 flags - 字段的位标志 type - 用于字段的数据类型小数 - 用于整数字段；使用的小数位数
PHP 版本：	5+

返回值：

返回包含字段定义信息的对象。如果没有可用信息，则为 FALSE。该对象具有以下属性：

name - 列的名称
orgname - 原始列名称（如果指定了别名）
表 - 表的名称
orgtable - 原始表名称（如果指定了别名）
def - 保留默认值，目前始终""
db - 数据库（PHP 5.3.6 中的新功能）
Catalog - 目录名称，始终"def"（自 PHP 5.3.6 起）
max_length - 字段的最大宽度
length - 表定义中指定的字段宽度
charsetnr - 字段的字符集编号
flags - 字段的位标志
type - 用于字段的数据类型
小数 - 用于整数字段；使用的小数位数

PHP 版本：

示例 - 程序风格

返回结果集中的下一个字段（列），然后打印每个字段的名称、表和最大长度：

<?php
$con = mysqli_connect("localhost","my_user","my_password","my_db");

if (mysqli_connect_errno()) {
echo "Failed to connect to MySQL: " . mysqli_connect_error();
exit();
}

$sql = "SELECT Lastname, Age FROM Persons ORDER BY Lastname";

if ($result = mysqli_query($con, $sql)) {
// Get field information for all fields
while ($fieldinfo = mysqli_fetch_field($result)) {
    printf("Name: %s\n", $fieldinfo -> name);
    printf("Table: %s\n", $fieldinfo -> table);
    printf("max. Len: %d\n", $fieldinfo -> max_length);
  }
mysqli_free_result($result);
}

mysqli_close($con);
?>

❮ PHP MySQLi 参考