
mysqli_fetch_field_direct()函数获取单个字段的元数据
定义和用法
PHP 结果对象(mysqli_result类)表示MySQL结果,由SELECT或DESCRIBE或EXPLAIN查询返回。
mysqli_fetch_field_direct()函数接受一个结果对象和一个表示字段编号的整数,并以对象的形式返回指定列/字段的定义信息。
语法
mysqli_fetch_field_direct($result, $field);
参数
| 序号 | 参数及说明 | 
|---|---|
| 1 | result(必需) 这是表示结果对象的标识符。 | 
| 2 | field(必需) 一个整数值,表示您需要其元数据/定义信息的字段。 | 
返回值
PHP mysqli_fetch_field_direct()函数返回一个对象,其中包含指定字段的定义信息。如果指定的字段(数字)不可用,则此函数返回FALSE。
返回的对象包含以下属性:
- name - 列名 
- orgname - 原始的列名(如果指定了别名) 
- table - 表名 
- orgtable - 原始的表名(如果指定了别名) 
- def - 该字段的默认值 
- max_length - 字段的最大宽度 
- length - 在表定义中指定的字段宽度 
- charsetnr - 字段的字符集号 
- flags - 字段的位标志 
- type - 用于字段的数据类型 
- decimals - 整数字段,小数点后的位数 
PHP版本
此函数最初是在PHP版本5中引入的,并且可以在所有更高版本中使用。
在线示例
以下示例演示了mysqli_fetch_field_direct()函数的用法(面向过程风格),返回结果集中第三个字段(列)的 元数据,并输出字段名称、表格和最大长度、数据类型、字段的字符集号:
<?php
   $con = mysqli_connect("localhost", "root", "password", "mydb");
   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("创建表.....\n");
   mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   mysqli_query($con, "INSERT INTO myplayers values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   print("插入记录.....\n");
   //检索表的内容
   $res = mysqli_query($con, "SELECT * FROM myplayers");
   //获取第3个字段的元数据
   $info = mysqli_fetch_field_direct($res, 2);
   print("Name: ".$info->name."\n");
   print("Table: ".$info->table."\n");
   print("Max Length: ".$info->max_length."\n");
   print("Flags: ".$info->flags."\n");
   print("Type: ".$info->type."\n");
   print("Definition: ".$info->def."\n");
   print("Character Set: ".$info->charsetnr."\n");
   //结束语句
   mysqli_free_result($res);
   //关闭连接
   mysqli_close($con);
?>输出结果
创建表..... 插入记录..... Name: Last_Name Table: myplayers Max Length: 10 Flags: 0 Type: 253
在线示例
在面向对象风格中,此函数的语法为$result->fetch_field_direct();。以下是面向对象风格中此函数,返回结果集中某个第二个字段(列)的 元数据,并输出字段名称、表格和最大长度、数据类型、字段的字符集号:
<?php
   //建立连接
   $con = new mysqli("localhost", "root", "password", "mydb");
   $con -> query("CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   $con -> query("insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("创建表.....\n");
   $stmt = $con -> prepare( "SELECT * FROM Test WHERE Name in(?, ?)");
   $stmt -> bind_param("ss", $name1, $name2);
   $name1 = 'Raju';
   $name2 = 'Rahman';
   //执行语句
   $stmt->execute();
   //检索结果
   $result = $stmt->get_result();
   //获取第二个字段的元数据
   $info = $result->fetch_field_direct(1);
   print("Name: ".$info->name."\n");
   print("Table: ".$info->table."\n");
   print("Max Length: ".$info->max_length."\n");
   print("Flags: ".$info->flags."\n");
   print("Type: ".$info->type."\n");
   print("Definition: ".$info->def."\n");
   print("Character Set: ".$info->charsetnr."\n");
   //结束语句
   $stmt->close();
   //关闭连接
   $con->close();
?>输出结果
创建表..... Name: AGE Table: Test Max Length: 0 Flags: 32768 Type: 3 Definition: Character Set: 63
