pg_fetch_row

数値添字の配列として行を得る

説明

arrayfalse pg_fetch_row(PgSql\Result $result, intnull $row = null, int $mode = PGSQL_NUM)

pg_fetch_row は、指定した result インスタンスが指す結果から 1 行分のデータを取得します。

注意: この関数は、 NULL フィールドに PHPの null 値を設定します。

パラメータ

result: pg_query、pg_query_params や (様々な関数がありますが、特に) pg_execute が返した PgSql\Result クラスのインスタンス。
row: 取得する行番号。最初の行は 0 です。省略したり null を指定したりした場合は、次の行を取得します。
mode: 返される配列のインデックスを制御するオプションの引数です。 mode は定数で、以下の値を取ることができます。: PGSQL_ASSOC, PGSQL_NUM, PGSQL_BOTH。 PGSQL_NUM を使うと、配列のインデックスを数値にした配列を返します。PGSQL_ASSOC を使うと、連想配列のインデックスを返します。PGSQL_BOTH を指定すると、数値と連想配列のインデックスを両方含めた形で配列を返します。

戻り値

個々の値を文字列として格納した配列を返します。配列の添字は 0 から始まります。データベースの NULL 値は null として返します。

row が結果の行数より大きい場合・行が存在しない場合、そしてそれ以外のエラーが発生した場合は false を返します。

変更履歴

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

例

例1 pg_fetch_row の例


<?php

$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
  echo "An error occurred.\n";
  exit;
}

$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
  echo "An error occurred.\n";
  exit;
}

while ($row = pg_fetch_row($result)) {
  echo "Author: $row[0]  E-mail: $row[1]";
  echo "<br />\n";
}
 
?>

参考

pg_query
pg_fetch_array
pg_fetch_object
pg_fetch_result