PHP Conference Japan 2024

cubrid_move_cursor

(PECL CUBRID >= 8.3.0)

cubrid_move_cursor移動結果集中的游標

說明

cubrid_move_cursor(資源 $req_identifier, int $offset, int $origin = CUBRID_CURSOR_CURRENT): bool

cubrid_move_cursor() 函式用於移動 req_identifier 的目前游標位置,根據 offset 參數設定的值,以及 origin 參數設定的方向進行移動。您可以使用 CUBRID_CURSOR_FIRSTorigin 參數設定為結果的第一個位置,使用 CUBRID_CURSOR_CURRENT 設定為結果的目前位置,或使用 CUBRID_CURSOR_LAST 設定為結果的最後一個位置。如果未明確指定 origin 參數,則此函式會使用 CUBRID_CURSOR_CURRENT 作為預設值。

如果游標移動範圍的值超出有效限制,則游標會移動到游標有效範圍之後的下一個位置。例如,如果您在大小為 10 的結果中移動 20 個單位,則游標將移動到第 11 個位置並返回 CUBRID_NO_MORE_DATA

參數

req_identifier

請求識別碼。

offset

您想要移動游標的單位數。

origin

您想要從哪裡移動游標的位置:CUBRID_CURSOR_FIRSTCUBRID_CURSOR_CURRENTCUBRID_CURSOR_LAST

傳回值

成功時傳回 true,失敗時傳回 false

範例

範例 #1 cubrid_move_cursor() 函式範例

<?php
$conn
= cubrid_connect("127.0.0.1", 33000, "demodb", "dba");

$req = cubrid_execute($conn, "SELECT * FROM code");
cubrid_move_cursor($req, 1, CUBRID_CURSOR_LAST);

$result = cubrid_fetch_row($req);
var_dump($result);

cubrid_move_cursor($req, 1, CUBRID_CURSOR_FIRST);
$result = cubrid_fetch_row($req);
var_dump($result);

cubrid_move_cursor($req, 1, CUBRID_CURSOR_CURRENT);
$result = cubrid_fetch_row($req);
var_dump($result);

cubrid_close_request($req);
cubrid_disconnect($conn);
?>

以上範例將輸出

array(2) {
  [0]=>
  string(1) "G"
  [1]=>
  string(4) "Gold"
}
array(2) {
  [0]=>
  string(1) "X"
  [1]=>
  string(5) "Mixed"
}
array(2) {
  [0]=>
  string(1) "M"
  [1]=>
  string(3) "Man"
}

另請參閱

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top