« pg_result_memory_size
pg_result_status »

pg_result_seek

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_result_seek — 結果インスタンスの内部行オフセットを設定する

説明

function pg_result_seek(PgSql\Result $result, int $row): bool

pg_result_seek()は、結果インスタンスの行の位置を 指定された offset にセットします。

パラメータ

result

pg_query()、pg_query_params() や (様々な関数がありますが、特に) pg_execute() が返した PgSql\Result クラスのインスタンス。

row

PgSql\Result クラスのインスタンス内で、内部オフセットを移動させる行。 行番号はゼロから始まります。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.1.0 result は、PgSql\Result クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource を期待していました。

例

例1 pg_result_seek() の例

<?php

// データベースに接続する
$conn = pg_pconnect("dbname=publisher");

// クエリを実行する
$result = pg_query($conn, "SELECT author, email FROM authors");

// 3 行目をシークする(結果が 3 行あると仮定する)
pg_result_seek($result, 2);

// 3 行目を取得する
$row = pg_fetch_row($result);
 
?>

参考

関連キーワード:
インスタンス   seek   fetch   内部   オフセット   PgSql   query   期待   conn   memory   size   status   PostgreSQL   offset   セット   params   execute   行番号   成功   履歴   resource   データベース   接続   pconnect   dbname
関連する関数・ページ:
function.pg-fetch-result   function.pg-fetch-all   function.pg-fetch-row   function.pg-fetch-object   function.pg-fetch-all-columns   function.mysql-field-seek