PHP mysqli_stmt_data_seek() 函数用法及示例

PHP MySQLi 参考手册

mysqli_stmt_data_seek()函数查找语句结果集中的任意行。

定义和用法

该函数接受一个语句对象和一个整数值作为参数,并在给定语句的结果集中查找指定的行(如果有)。调用此函数(使用mysqli_stmt_data_seek())之前,请确保已存储了结果集。

语法

mysqli_stmt_data_seek($stmt);

参数

序号参数及说明
1

stmt(必需)

这是表示准备好的语句的对象。

2

offset(必需)

这是表示所需行的整数值(必须在0到结果集中的行总数之间)。

返回值

PHP mysqli_stmt_data_seek()函数返回不返回任何值。

PHP版本

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

在线示例

以下示例演示了mysqli_stmt_data_seek()函数的用法(面向过程风格)-

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

   //检索表的内容
   $stmt = mysqli_prepare($con, "SELECT * FROM myplayers");

   //执行语句
   mysqli_stmt_execute($stmt);

   //将结果中的值绑定到变量
   mysqli_stmt_bind_result($stmt, $id, $fname, $lname, $pob, $country);

   //存储结果
   mysqli_stmt_store_result($stmt);

   //移动搜索
   mysqli_stmt_data_seek($stmt, 2);
   mysqli_stmt_fetch($stmt);
   print("Id: ".$id."\n");
   print("fname: ".$fname."\n");
   print("lname: ".$lname."\n");
   print("pob: ".$pob."\n");
   print("country: ".$country."\n");
   print("\n");

   //结束语句
   mysqli_stmt_close($stmt);

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

输出结果

创建表.....
插入记录.....
Id: 3
fname: Kumara
lname: Sangakkara
pob: Matale
country: Srilanka

在线示例

在面向对象风格中,此函数的语法为$stmt-> data_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");

   //执行语句
   $stmt->execute();

   //将变量绑定到结果集
   $stmt->bind_result($name, $age);

   $stmt->store_result();

   //移动搜索
   $stmt->data_seek(2);

   $stmt->fetch();
   print("Name: ".$name."\n");
   print("Age: ".$age."\n");

   //结束语句
   $stmt->close();

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

输出结果

创建表.....
Name: Sarmista
Age: 27

PHP MySQLi 参考手册