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版本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