mysqli_data_seek()函数调整结果指针到结果集中的一个任意行。
PHP结果对象(属于mysqli_result类)表示由SELECT或DESCRIBE或EXPLAIN查询返回的MySQL结果。
mysqli_data_seek()函数的作用是:接受一个结果对象和一个表示偏移量的整数值作为参数,并将给定结果对象的数据查找移动到指定的行。
mysqli_data_seek($result, $offset);
序号 | 参数及说明 |
---|---|
1 | result(必需) 这是表示结果对象的标识符。 |
2 | offset(必需) 这是一个整数值,表示字段偏移。范围必须在 0 和 行总数 - 1 之间。 |
PHP mysqli_data_seek()函数返回一个布尔值,如果成功,则为TRUE;如果失败,则为FALSE。
此函数最初是在PHP版本5中引入的,并且可以在所有更高版本中使用。
以下示例演示了mysqli_data_seek()函数的用法(面向过程风格),在结果集中寻找行号为 2 的数据:
<?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"); //查找到第二行 mysqli_data_seek($res, 1); //获取行的内容 $row = mysqli_fetch_row($res); print_r($row); //结束语句 mysqli_free_result($res); //关闭连接 mysqli_close($con); ?>
输出结果
创建表..... 插入记录..... Array ( [0] => 2 [1] => Jonathan [2] => Trott [3] => CapeTown [4] => SouthAfrica )
在面向对象风格中,此函数的语法为$result->data_seek;。以下是面向对象风格中此函数的示例,在结果集中寻找行号为 3 的数据:
<?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)"); $con -> query("insert into Test values('Mohan', 28),('Raghav', 35),('Devika', 30)"); print("创建表.....\n"); $stmt = $con -> prepare( "SELECT * FROM Test WHERE Name in(?, ?, ?, ?)"); $stmt -> bind_param("ssss", $name1, $name2, $name3, $name4); $name1 = 'Raju'; $name2 = 'Rahman'; $name3 = 'Raghav'; $name4 = 'Devika'; //执行语句 $stmt->execute(); //检索结果 $res = $stmt->get_result(); //查找到第3行 $res->data_seek(2); //获取行的内容 $row = $res->fetch_row(); print_r($row); //结束语句 $stmt->close(); //关闭连接 $con->close(); ?>
输出结果
创建表..... Array ( [0] => Raghav [1] => 35 )