(PECL CUBRID >= 8.3.0)
cubrid_move_cursor — 移動結果集中的游標
cubrid_move_cursor() 函式用於移動 req_identifier
的目前游標位置,根據 offset
參數設定的值,以及 origin
參數設定的方向進行移動。您可以使用 CUBRID_CURSOR_FIRST
將 origin
參數設定為結果的第一個位置,使用 CUBRID_CURSOR_CURRENT
設定為結果的目前位置,或使用 CUBRID_CURSOR_LAST
設定為結果的最後一個位置。如果未明確指定 origin
參數,則此函式會使用 CUBRID_CURSOR_CURRENT
作為預設值。
如果游標移動範圍的值超出有效限制,則游標會移動到游標有效範圍之後的下一個位置。例如,如果您在大小為 10 的結果中移動 20 個單位,則游標將移動到第 11 個位置並返回 CUBRID_NO_MORE_DATA
。
req_identifier
請求識別碼。
offset
您想要移動游標的單位數。
origin
您想要從哪裡移動游標的位置:CUBRID_CURSOR_FIRST
、CUBRID_CURSOR_CURRENT
或 CUBRID_CURSOR_LAST
。
範例 #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" }