cubrid_data_seek()函式—用法及示例

函式名：cubrid_data_seek()

適用版本：CUBRID PHP Driver Version 8.3.0以上

用法：cubrid_data_seek() 函式用於在結果集中移動指標到指定的行號。它只能在 SELECT 查詢的結果集上使用。

語法：bool cubrid_data_seek ( resource $result, int $row_number )

引數：

• result：結果集資源，透過 cubrid_query() 或 cubrid_execute() 函式返回的結果。
• row_number：指定要移動到的行號。行號從 0 開始計數。

返回值：如果成功移動指標到指定行號，則返回 true。如果失敗，則返回 false。

示例：

// 連線資料庫
$conn = cubrid_connect("localhost", 33000, "demo", "username", "password");

// 查詢資料
$sql = "SELECT * FROM customers";
$result = cubrid_query($conn, $sql);

// 獲取總行數
$row_count = cubrid_num_rows($result);

// 移動指標到第3行
if (cubrid_data_seek($result, 2)) {
    // 獲取第3行資料
    $row = cubrid_fetch_assoc($result);
    echo "第3行資料：" . implode(", ", $row);
} else {
    echo "移動指標到第3行失敗";
}

// 關閉資料庫連線
cubrid_disconnect($conn);

注意事項：

1. 在呼叫 cubrid_data_seek() 函式之前，必須先透過 cubrid_query() 或 cubrid_execute() 函式執行查詢語句並獲得結果集。
2. 行號是從 0 開始計數的，所以移動到第一行使用的是 0，第二行使用的是 1，以此類推。
3. 如果指定的行號越界，即超出結果集的總行數範圍，移動指標將失敗並返回 false。
4. 在使用完成後，記得使用 cubrid_free_result() 函式釋放結果集資源。