PHP mysqli_field_seek() 函数用法及示例

PHP MySQLi 参考手册

mysqli_field_seek()函数把字段指针设置为指定字段的偏移量。

定义和用法

一个PHP结果对象(mysqli_result类)表示由SELECT或DESCRIBE或EXPLAIN查询返回的MySQL结果。

mysqli_field_seek()函数接受结果对象和代表字段编号的整数值作为参数,并将给定结果对象的字段查找移动到指定字段。

语法

mysqli_field_seek($result, $field);

参数

序号参数及说明
1

result(必需)

这是表示结果对象的标识符。

2

field(必需)

这是一个整数值,表示您需要将给定结果对象中的字段搜索移动到的字段编号。

返回值

PHP mysqli_field_seek()函数返回一个布尔值,如果成功则返回TRUE,失败则返回FALSE

PHP版本

此函数最初是在PHP版本5中引入的,并且可以在所有更高版本中使用。

在线示例

以下示例演示了mysqli_field_seek()函数的用法(面向过程风格),设置结果集中第3个字段(列)的字段指针,然后通过 mysqli_fetch_field() 获取字段信息并输出字段名称、表格和最大长度:

<?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");

   //将seek移动到第三个字段
   mysqli_field_seek($res, 2);

   //获取字段
   $info = mysqli_fetch_field($res);
   //当前字段
   $currentfield = mysqli_field_tell($res);
   print("Current Field: ".$currentfield."\n");
   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");


   //结束语句
   mysqli_free_result($res);

   //关闭连接
   mysqli_close($con);
?>

输出结果

创建表.....
插入记录.....
Current Field: 3
Name: Last_Name
Table: myplayers
Max Length: 10
Flags: 0
Type: 253

在线示例

在面向对象风格中,此函数的语法为$result->field_seek;。以下是面向对象风格中此函数的示例;

<?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();

   //将搜索移动到第二个字段
   $result->field_seek(1);

   //获取第二个字段当前字段
   $info = $result->fetch_field();

   $field = $result->current_field;
   print("Current Field: ".$field."\n");
   print("Field Name: ".$info->name."\n");
   print("Field Type: ".$info->type);


   //结束语句
   $stmt->close();
 
   //关闭连接
   $con->close();
?>

输出结果

创建表.....
Current Field: 2
Field Name: AGE
Field Type: 3

PHP MySQLi 参考手册