array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.pg-fetch-row.php', 1 => 'pg_fetch_row', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'PostgreSQL 関数', ), 'prev' => array ( 0 => 'function.pg-fetch-result.php', 1 => 'pg_fetch_result', ), 'next' => array ( 0 => 'function.pg-field-is-null.php', 1 => 'pg_field_is_null', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/pgsql/functions/pg-fetch-row.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_row — 数値添字の配列として行を得る
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";
}
?>