pg_fetch_array

PHP マニュアル
前のページ		次のページ

説明

array pg_fetch_array ( resource result [, int row [, int result_type]] )

pg_fetch_array() は、取得した行（レコード）を配列で返します。

pg_fetch_array() は拡張版の pg_fetch_row() です。結果配列のフィールド番号に対応する要素にデータを格納し、それに加えてフィールド名をキーとした連想配列にも格納します。デフォルトで、両方ともが有効になっています。

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

pg_fetch_array() は、 pg_fetch_row() に比べてきわめて遅いというわけでは「ありません」。そして、きわめて簡単に使用できます。

注意: row は、PHP 4.1.0 でオプションになりました。

注意: result_type は PHP 4.0.0 で追加されました。

パラメータ

result: pg_query(), pg_query_params() あるいは pg_execute() から返される PostgreSQL のクエリ結果リソース。
row: 取得する行番号。最初の行は 0 です。指定されなかった場合、次の行が取得されます。
result_type: result_type は、返り値の形式を制御するオプションのパラメータです。result_type は定数であり、次の値のどれかとすることが可能です。 PGSQL_ASSOC、PGSQL_NUM および PGSQL_BOTH。 PGSQL_NUM を使用すると、pg_fetch_array() は数値添字の配列を返します。また、PGSQL_ASSOC を使用すると連想配列形式で返します。PGSQL_BOTH がデフォルト設定で、これは数値添字の配列と連想配列の両方を返します。

返り値

0 から始まる数値添字の配列か連想配列（フィールド名をキーとする）、あるいはその両方を返します。配列の各要素の値は文字列です。データベースの NULL 値は、NULL として返します。

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

例

例 1. pg_fetch_array() の例


<?php 

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

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

$arr = pg_fetch_array($result, 0, PGSQL_NUM);
echo $arr[0] . " <- Row 1 Author\n";
echo $arr[1] . " <- Row 1 E-mail\n";

// PHP 4.1.0 以降、row パラメータはオプションです。result_type を指定
// したい場合は NULL を渡しておきます。pg_fetch_array を続けてコール
// すると、次の行を取得します。
$arr = pg_fetch_array($result, NULL, PGSQL_ASSOC);
echo $arr["author"] . " <- Row 2 Author\n";
echo $arr["email"] . " <- Row 2 E-mail\n";

$arr = pg_fetch_array($result);
echo $arr["author"] . " <- Row 3 Author\n";
echo $arr[1] . " <- Row 3 E-mail\n";

?>

前のページ	ホーム	次のページ
pg_fetch_all	上に戻る	pg_fetch_assoc

pg_fetch_array

説明

パラメータ

返り値

例

参考