pg_fetch_array
行を配列として取得する
&reftitle.description;
arraypg_fetch_array
resourceresult
introw
intresult_typePGSQL_BOTH
pg_fetch_array は、取得した行(レコード)を
配列で返します。
pg_fetch_array は拡張版の
pg_fetch_row です。結果配列のフィールド番号に
対応する要素にデータを格納し、それに加えてフィールド名をキーとした
連想配列にも格納します。デフォルトで、両方ともが有効になっています。
&database.fetch-null;
pg_fetch_array は、
pg_fetch_row に比べてきわめて遅いというわけでは
「ありません」。そして、きわめて簡単に使用できます。
&reftitle.parameters;
result
pg_query, pg_query_params
あるいは pg_execute から返される PostgreSQL の
クエリ結果リソース。
row
取得する行番号。最初の行は 0 です。省略したり &null; を指定したりした場合は、
次の行を取得します。
result_type
result_type は、返り値の形式を制御する
オプションのパラメータです。result_type
は定数であり、次の値のどれかとすることが可能です。
PGSQL_ASSOC、PGSQL_NUM
および PGSQL_BOTH。
PGSQL_NUM を使用すると、pg_fetch_array
は数値添字の配列を返します。また、PGSQL_ASSOC
を使用すると連想配列形式で返します。PGSQL_BOTH
がデフォルト設定で、これは数値添字の配列と連想配列の両方を返します。
&reftitle.returnvalues;
0 から始まる数値添字の配列か連想配列(フィールド名をキーとする)、
あるいはその両方を返します。配列の各要素の値は文字列です。
データベースの NULL 値は、&null; として返します。
row が結果の行数より大きい場合や行が存在しない場合、
そしてそれ以外のエラーが発生した場合は &false; を返します。
&reftitle.changelog;
&Version;
&Description;
4.1.0
row パラメータがオプションとなりました。
&reftitle.examples;
pg_fetch_array の例
]]>
&reftitle.seealso;
pg_fetch_row
pg_fetch_object
pg_fetch_result