PHP mysqli_data_seek()用法及代碼示例

定義和用法

PHP 結果對象(屬於 mysqli_result 類)表示 MySQL 結果，由 SELECT 或 DESCRIBE 或 EXPLAIN 查詢返回。

mysqli_data_seek() 函數接受一個結果對象和一個表示偏移量的整數值作為參數，並將給定結果對象的數據查找移動到指定的行。

用法

mysqli_data_seek($result, $offset);

參數

Sr.No	參數及說明
1	result(Mandatory) 這是一個表示結果對象的標識符。
2	offset(Mandatory) 這是一個整數值，表示您需要將給定結果對象中的數據查找移動到的偏移量。

返回值

PHP mysqli_data_seek() 函數返回一個布爾值，即成功時為 TRUE，失敗時為 FALSE。

PHP版本

這個函數最初是在 PHP 版本 5 中引入的，適用於所有後續版本。

示例

以下示例演示了 mysqli_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("Table Created.....\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("Record Inserted.....\n");

   //Retrieving the contents of the table
   $res = mysqli_query($con, "SELECT * FROM myplayers");

   //Seek to 2nd row
   mysqli_data_seek($res, 1);

   //Fetching the contents of the row
   $row = mysqli_fetch_row($res);
   print_r($row);

   //Closing the statement
   mysqli_free_result($res);

   //Closing the connection
   mysqli_close($con);
?>

這將產生以下結果 -

Table Created.....
Record Inserted.....
Array
(
    [0] => 2
    [1] => Jonathan
    [2] => Trott
    [3] => CapeTown
    [4] => SouthAfrica
)

示例

在麵向對象的風格中，這個函數的語法是 $result->data_seek;以下是麵向對象樣式 $minus 中此函數的示例；

<?php
   //Creating a connection
   $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("Table Created.....\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';

   //Executing the statement
   $stmt->execute();

   //Retrieving the result
   $res = $stmt->get_result();

   //Seek to 3rd row
   $res->data_seek(2);

   //Fetching the contents of the row
   $row = $res->fetch_row();
   print_r($row);

   //Closing the statement
   $stmt->close();

   //Closing the connection
   $con->close();
?>

這將產生以下結果 -

Table Created.....
Array
(
    [0] => Raghav
    [1] => 35
)