mysqli_result::data_seek()函式—用法及示例

函式名：mysqli_result::data_seek()

適用版本：PHP 5 >= 5.3.0, PHP 7, PHP 8

用法：mysqli_result::data_seek() 方法用於將結果集內部的指標移動到指定的行號。它是 mysqli_result 類的一個成員方法。

語法：bool mysqli_result::data_seek(int $offset)

引數：

• $offset：要移動到的行號。行號從0開始計數。

返回值：

• 成功時返回 true。
• 失敗時返回 false。

示例：

// 假設已經建立了資料庫連線 $conn

// 執行查詢語句
$result = mysqli_query($conn, "SELECT * FROM my_table");

// 檢查查詢是否成功
if ($result) {
    // 將結果集的指標移動到第3行（行號從0開始計數）
    $result->data_seek(2);

    // 獲取當前行的資料
    $row = $result->fetch_assoc();

    // 輸出第3行的資料
    echo "第3行的資料：";
    print_r($row);
} else {
    echo "查詢失敗！";
}

上述示例中，我們首先執行了一個查詢語句並將結果儲存在變數 $result 中。然後，我們使用 data_seek() 方法將結果集的指標移動到第3行。接著，透過 fetch_assoc() 方法獲取當前行的資料，並將其輸出到螢幕上。

請注意，data_seek() 方法只能用於可滾動的結果集（即使用 mysqli::use_result() 函式返回的結果集不支援此方法）。另外，行號必須在結果集的有效範圍內，否則將返回 false。