cvs: phpdoc-ja /reference/pgsql/functions pg-execute.xml pg-fetch-all-columns.xml pg-field-type-oid.xml pg-parameter-status.xml pg-prepare.xml
pg-query-params.xml pg-result-error-field.xml pg-send-execute.xml pg-send-prepare.xml pg-send-query-params.xml pg-set-error-verbosity.xml
pg-transaction-status.xml pg-version.xml

From: Date: Fri, 19 Aug 2005 01:17:35 +0000
Subject: cvs: phpdoc-ja /reference/pgsql/functions pg-execute.xml pg-fetch-all-columns.xml pg-field-type-oid.xml pg-parameter-status.xml pg-prepare.xml
pg-query-params.xml pg-result-error-field.xml pg-send-execute.xml pg-send-prepare.xml pg-send-query-params.xml pg-set-error-verbosity.xml
pg-transaction-status.xml pg-version.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-1133@lists.php.net to get a copy of this message
takagi Thu Aug 18 21:17:35 2005 EDT Added files: /phpdoc-ja/reference/pgsql/functions pg-version.xml pg-transaction-status.xml pg-set-error-verbosity.xml pg-send-query-params.xml pg-send-prepare.xml pg-send-execute.xml pg-result-error-field.xml pg-query-params.xml pg-prepare.xml pg-parameter-status.xml pg-field-type-oid.xml pg-fetch-all-columns.xml pg-execute.xml Log: added japanese manual.

http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-version.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-version.xml +++ phpdoc-ja/reference/pgsql/functions/pg-version.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.pg-version"> <refnamediv> <refname>pg_version</refname> <refpurpose> クライアント・プロトコル・サーバのバージョンを配列で返す </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>pg_version</methodname> <methodparam choice="opt"><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> <function>pg_version</function> はクライアント・プロトコル およびサーバのバージョンを配列で返します。プロトコルおよびサーバの バージョンは、PHP が PostgreSQL 7.4 以降とともにコンパイルされている 場合のみ有効です。 </para> <para> 詳細なサーバ情報を取得するには <function>pg_parameter_status</function> を参照ください。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> <literal>client</literal>, <literal>protocol</literal> および <literal>server_version</literal> のキーとその値を持つ配列を 返します(有効な場合)。エラー時や接続が正常でない場合に &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_version</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("host=localhost port=5432 dbname=mary") or die("Could not connect"); $v = pg_version($dbconn); echo $v['client']; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 7.4 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_parameter_status</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-transaction-status.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-transaction-status.xml +++ phpdoc-ja/reference/pgsql/functions/pg-transaction-status.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: takagi Status: ready --> <refentry id='function.pg-transaction-status'> <refnamediv> <refname>pg_transaction_status</refname> <refpurpose>サーバ上で実行中のトランザクションの状態を返す</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>pg_transaction_status</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> サーバ上で実行中のトランザクションの状態を返します。 </para> <caution> <para> PostgreSQL 7.3 サーバで <literal>autocommit</literal> を off に 設定している場合、<function>pg_transaction_status</function> は 不正確な値を返します。サーバ側での自動コミット機能は非推奨と されており、最近のバージョンのサーバでは存在しません。 </para> </caution> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベースの接続リソース。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para><constant>PGSQL_TRANSACTION_IDLE</constant>(アイドル状態)、 <constant>PGSQL_TRANSACTION_ACTIVE</constant>(コマンドの実行中)、 <constant>PGSQL_TRANSACTION_INTRANS</constant>(正常なトランザクション内でアイドル状態)、 あるいは <constant>PGSQL_TRANSACTION_INERROR</constant>(失敗したトランザクション内でアイドル状態) のいずれかを返します。 接続が異常な場合は <constant>PGSQL_TRANSACTION_UNKNOWN</constant> を返します。 <constant>PGSQL_TRANSACTION_ACTIVE</constant> が返されるのは、クエリを サーバに送信した後まだそれが完了していない場合のみです。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_transaction_status</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); $stat = pg_transaction_status($dbconn); if ($stat === PGSQL_TRANSACTION_UNKNOWN) { echo 'Connection is bad'; } else if ($stat === PGSQL_TRANSACTION_IDLE) { echo 'Connection is currently idle'; } else { echo 'Connection is in a transaction state'; } ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-set-error-verbosity.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-set-error-verbosity.xml +++ phpdoc-ja/reference/pgsql/functions/pg-set-error-verbosity.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: takagi Status: ready --> <refentry id="function.pg-set-error-verbosity"> <refnamediv> <refname>pg_set_error_verbosity</refname> <refpurpose> <function>pg_last_error</function> および <function>pg_result_error</function> が返すメッセージの詳細度を指定する </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>pg_set_error_verbosity</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>int</type><parameter>verbosity</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>int</type><methodname>pg_set_error_verbosity</methodname> <methodparam><type>int</type><parameter>verbosity</parameter></methodparam> </methodsynopsis> <para> <function>pg_last_error</function> および <function>pg_result_error</function> が返すメッセージの詳細度を指定します。 </para> <para> <function>pg_set_error_verbosity</function> は詳細度を設定し、その接続の これまでの設定を返します。<constant>PGSQL_ERRORS_TERSE</constant> モードでは、返されるメッセージは深刻度・概要 および 発生位置のみです。 これはたいていの場合 1 行に収まります。デフォルトのモード (<constant>PGSQL_ERRORS_DEFAULT</constant>)では、それに加えて何らかの 詳細情報・ヒントあるいは状況フィールドを含みます(これらは複数行に またがる可能性があります)。<constant>PGSQL_ERRORS_VERBOSE</constant> モードは、有効なフィールドをすべて含みます。詳細度の設定変更内容は それ以降に新しく作成した結果オブジェクトにのみ反映され、既存の 結果オブジェクトには影響を与えません。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>verbosity</parameter></term> <listitem> <para> 指定する詳細度。<constant>PGSQL_ERRORS_TERSE</constant>、 <constant>PGSQL_ERRORS_DEFAULT</constant> あるいは <constant>PGSQL_ERRORS_VERBOSE</constant> 。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 変更前の詳細度レベル。<constant>PGSQL_ERRORS_TERSE</constant>、 <constant>PGSQL_ERRORS_DEFAULT</constant> あるいは <constant>PGSQL_ERRORS_VERBOSE</constant> のいずれかを 返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_set_error_verbosity</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); if (!pg_connection_busy($dbconn)) { pg_send_query($dbconn, "select * from doesnotexist;"); } pg_set_error_verbosity($dbconn, PGSQL_ERRORS_VERBOSE); $res1 = pg_get_result($dbconn); echo pg_result_error($res1); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_last_error</function></member> <member><function>pg_result_error</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-send-query-params.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-send-query-params.xml +++ phpdoc-ja/reference/pgsql/functions/pg-send-query-params.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id='function.pg-send-query-params'> <refnamediv> <refname>pg_send_query_params</refname> <refpurpose>コマンドとパラメータを分割してサーバに送信し、その結果を待たない</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>pg_send_query_params</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam><type>array</type><parameter>params</parameter></methodparam> </methodsynopsis> <para> コマンドとパラメータを分割してサーバに送信します。その結果を待つことは しません。 </para> <para> これは <function>pg_send_query</function> とほぼ同じですが、パラメータが <parameter>query</parameter> とは別に分かれている点が違います。 関数のパラメータは、<function>pg_query_params</function> によって 完全に制御されます。<function>pg_query_params</function> と同様、 7.4 より前の PostgreSQL では動作しません。またクエリ文字列には ひとつのコマンドのみを含めることができます。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベースの接続リソース。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> パラメータ化した SQL 文。ひとつの文のみである必要があります (複数の文をセミコロンで区切る形式は使用できません)。パラメータを 使用する際は $1、$2 などの形式で参照されます。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>params</parameter></term> <listitem> <para> プリペアドステートメント中の $1、$2 などのプレースホルダを 置き換えるパラメータの配列。配列の要素数はプレースホルダの 数と一致する必要があります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para>&return.success;</para> <para> クエリの結果を判断するには <function>pg_get_result</function> を使用します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_send_query_params</function> の使用法</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); // パラメータを使用する。パラメータにはクォートやエスケープが // 必要ないことに注意 pg_send_query_params($dbconn, 'select count(*) from authors where city = $1', array('Perth')); // 基本的な pg_send_query の使用法との比較 $str = pg_escape_string('Perth'); pg_send_query($dbconn, "select count(*) from authors where city = '${str}'"); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_send_query</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-send-prepare.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-send-prepare.xml +++ phpdoc-ja/reference/pgsql/functions/pg-send-prepare.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.pg-send-prepare"> <refnamediv> <refname>pg_send_prepare</refname> <refpurpose> 指定したパラメータでプリペアドステートメントを作成するリクエストを 送信し、その結果を待たない </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>pg_send_prepare</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>stmtname</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> 指定したパラメータでプリペアドステートメントを作成するリクエストを 送信し、その結果を待ちません。 </para> <para> これは <function>pg_prepare</function> の非同期バージョンです。 リクエストが受け付けられた場合に &true; 、そうでない場合に &false; を返します。コールが成功した後、実際にプリペアドステートメントが 作成されたかどうかを調べるには <function>pg_get_result</function> を使用します。関数のパラメータは <function>pg_prepare</function> と同じように処理されます。<function>pg_prepare</function> と同様、 7.4 より前の PostgreSQL のバージョンでは正しく動作しません。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>stmtname</parameter></term> <listitem> <para> プリペアドステートメントにつける名前。接続内で一意である必要があります。 "" が指定された場合は無名ステートメントが作成され、以前に定義された 無名ステートメントを上書きします。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> パラメータ化した SQL 文。ひとつの文のみである必要があります (複数の文をセミコロンで区切る形式は使用できません)。パラメータを 使用する際は $1、$2 などの形式で参照されます。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para>成功した場合に &true; 、失敗した場合に &false; を返します。 クエリの結果を確かめるには <function>pg_get_result</function> を使用します。</para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_send_prepare</function> の使用法</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); // 実行するクエリを準備する if (!pg_connection_busy($dbconn)) { pg_send_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1'); $res1 = pg_get_result($dbconn); } // プリペアドクエリを実行する。文字列 "Joe's Widgets" は // エスケープの必要がないことに注意 if (!pg_connection_busy($dbconn)) { pg_send_execute($dbconn, "my_query", array("Joe's Widgets")); $res2 = pg_get_result($dbconn); } // 同一プリペアドクエリを別のパラメータで実行する if (!pg_connection_busy($dbconn)) { pg_send_execute($dbconn, "my_query", array("Clothes Clothes Clothes")); $res3 = pg_get_result($dbconn); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_connect</function></member> <member><function>pg_pconnect</function></member> <member><function>pg_execute</function></member> <member><function>pg_send_execute</function></member> <member><function>pg_send_query_params</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-send-execute.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-send-execute.xml +++ phpdoc-ja/reference/pgsql/functions/pg-send-execute.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.pg-send-execute"> <refnamediv> <refname>pg_send_execute</refname> <refpurpose> 指定したパラメータでプリペアドステートメントを実行するリクエストを 送信し、その結果を待たない </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>pg_send_execute</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>stmtname</parameter></methodparam> <methodparam><type>array</type><parameter>params</parameter></methodparam> </methodsynopsis> <para> 指定したパラメータでプリペアドステートメントを実行するリクエストを 送信し、その結果を待ちません。 </para> <para> これは <function>pg_send_query_params</function> と似ています。 しかし、実行するコマンドは指定したクエリ文字列で決まるのではなく 事前に準備されたステートメントの名前で決まります。関数のパラメータは <function>pg_execute</function> と同じように処理されます。 <function>pg_execute</function> と同様に、7.4 より前のバージョンの PostgreSQL では動作しません。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>stmtname</parameter></term> <listitem> <para> 実行するプリペアドステートメントの名前。"" が指定された場合は 無名ステートメントが実行されます。名前は、事前に <function>pg_prepare</function>・<function>pg_send_prepare</function> あるいは <literal>PREPARE</literal> SQL コマンドで準備されたものである 必要があります。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>params</parameter></term> <listitem> <para> プリペアドステートメント中の $1、$2 などのプレースホルダを 置き換えるパラメータの配列。配列の要素数はプレースホルダの 数と一致する必要があります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para>成功した場合に &true; 、失敗した場合に &false; を返します。 クエリの結果を確認するには <function>pg_get_result</function> を使用します。</para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_send_execute</function> の使用法</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); // 実行するクエリを準備する if (!pg_connection_busy($dbconn)) { pg_send_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1'); $res1 = pg_get_result($dbconn); } // プリペアドクエリを実行する。 文字列 "Joe's Widgets" は // エスケープの必要がないことに注意 if (!pg_connection_busy($dbconn)) { pg_send_execute($dbconn, "my_query", array("Joe's Widgets")); $res2 = pg_get_result($dbconn); } // 同じプリペアドクエリを異なるパラメータで実行する if (!pg_connection_busy($dbconn)) { pg_send_execute($dbconn, "my_query", array("Clothes Clothes Clothes")); $res3 = pg_get_result($dbconn); } ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_prepare</function></member> <member><function>pg_send_prepare</function></member> <member><function>pg_execute</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-result-error-field.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-result-error-field.xml +++ phpdoc-ja/reference/pgsql/functions/pg-result-error-field.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.7 Maintainer: takagi Status: ready --> <refentry id='function.pg-result-error-field'> <refnamediv> <refname>pg_result_error_field</refname> <refpurpose>エラー報告の各フィールドを返す</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>pg_result_error_field</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>fieldcode</parameter></methodparam> </methodsynopsis> <para> <function>pg_result_error_field</function> は、<parameter>result</parameter> リソースに関するエラーメッセージの特定のフィールドを返します。 PostgreSQL 7.4 以降のサーバでのみ有効です。エラーフィールドは <parameter>fieldcode</parameter> で定義します。 </para> <para> <function>pg_query</function> や <function>pg_query_params</function> はクエリが失敗した場合に &false; を返すので、結果のハンドルを得るには <function>pg_send_query</function> および <function>pg_get_result</function> を使用する必要があります。 </para> <para> 失敗した <function>pg_query</function> クエリから詳細なエラー情報を 取得する必要がある場合は、<function>pg_set_error_verbosity</function> および <function>pg_last_error</function> を使用してその結果をパース します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>result</parameter></term> <listitem> <para> 実行したステートメントのクエリ結果リソース。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>fieldcode</parameter></term> <listitem> <para> 以下の <parameter>fieldcode</parameter> が使用可能です。 <constant>PGSQL_DIAG_SEVERITY</constant>、 <constant>PGSQL_DIAG_SQLSTATE</constant>、<constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>、 <constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>、 <constant>PGSQL_DIAG_MESSAGE_HINT</constant>、<constant>PGSQL_DIAG_STATEMENT_POSITION</constant>、 <constant>PGSQL_DIAG_INTERNAL_POSITION</constant>(PostgreSQL 8.0+ のみ)、 <constant>PGSQL_DIAG_INTERNAL_QUERY</constant>(PostgreSQL 8.0+ のみ)、 <constant>PGSQL_DIAG_CONTEXT</constant>、<constant>PGSQL_DIAG_SOURCE_FILE</constant>、 <constant>PGSQL_DIAG_SOURCE_LINE</constant> あるいは <constant>PGSQL_DIAG_SOURCE_FUNCTION</constant> 。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para>エラーフィールドの内容を文字列で返します。 フィールドが存在しない場合に &null; 、失敗した場合に &false; を返します。</para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_result_error_field</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); if (!pg_connection_busy($dbconn)) { pg_send_query($dbconn, "select * from doesnotexist;"); } $res1 = pg_get_result($dbconn); echo pg_result_error_field($res1, PGSQL_DIAG_SQLSTATE); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_result_error</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-query-params.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-query-params.xml +++ phpdoc-ja/reference/pgsql/functions/pg-query-params.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.pg-query-params"> <refnamediv> <refname>pg_query_params</refname> <refpurpose> SQL コマンドとパラメータを分割してサーバにを送信し、その結果を待つ </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>pg_query_params</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam><type>array</type><parameter>params</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>pg_query_params</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam><type>array</type><parameter>params</parameter></methodparam> </methodsynopsis> <para> コマンドをサーバに送信し、その結果を待ちます。パラメータを SQL コマンド とは別に渡すことが可能です。 </para> <para> <function>pg_query_params</function> は <function>pg_query</function> と似ていますが、追加の機能を有しています。それはパラメータ値が コマンド文字列と分離しているということです。 <function>pg_query_params</function> は PostgreSQL 7.4 以降の接続でのみ サポートされます。それ以前のバージョンでは失敗します。 </para> <para> パラメータを使用する際は、<parameter>query</parameter> 文字列内で $1、$2 のように参照されます。<parameter>params</parameter> で 実際の値を指定します。&null; を指定すると、SQL の <literal>NULL</literal> とみなされます。 </para> <para> <function>pg_query</function> に対する <function>pg_query_params</function> の最大の利点は、パラメータの値を <parameter>query</parameter> 文字列から 分離できることです。そのため、退屈でエラーの元となりやすいクォート・ エスケープなどをしなくてもよくなります。<function>pg_query</function> と異なり、<function>pg_query_params</function> ではひとつの SQL コマンドしか実行できません(クエリ文字列にセミコロンを含めることは 可能です。しかしそれ以降にコマンドを続けることはできません)。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> パラメータ化した SQL 文。ひとつの文のみである必要があります (複数の文をセミコロンで区切る形式は使用できません)。パラメータを 使用する際は $1、$2 などの形式で参照されます。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>params</parameter></term> <listitem> <para> プリペアドステートメント中の $1、$2 などのプレースホルダを 置き換えるパラメータの配列。配列の要素数はプレースホルダの 数と一致する必要があります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 成功した場合にクエリ結果リソース、失敗した場合に &false; を返します。</para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_query_params</function> の使用法</title> <programlisting role="php"> <![CDATA[ <?php // "mary"という名前のデータベースに接続 $dbconn = pg_connect("dbname=mary"); // Joe's Widgets という名前の店を探す。"Joe's Widgets" を // エスケープする必要がないことに注意 $result = pg_query_params($dbconn, 'SELECT * FROM shops WHERE name = $1', array("Joe's Widgets")); // pg_query を使用した場合と比較 $str = pg_escape_string("Joe's Widgets"); $result = pg_query($dbconn, "SELECT * FROM shops WHERE name = '{$str}'"); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_query</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-prepare.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-prepare.xml +++ phpdoc-ja/reference/pgsql/functions/pg-prepare.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.pg-prepare"> <refnamediv> <refname>pg_prepare</refname> <refpurpose> 指定したパラメータでプリペアドステートメントを作成するリクエストを 送信し、その完了を待つ </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>pg_prepare</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>stmtname</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>pg_prepare</methodname> <methodparam><type>string</type><parameter>stmtname</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> <function>pg_prepare</function> は、 <function>pg_execute</function> あるいは <function>pg_send_execute</function> で後に実行するためのプリペアドステートメントを作成します。これにより、 繰り返し使用されるコマンドについての構文解析や実行計画作成が最初の 一度だけですみます。<function>pg_prepare</function> は PostgreSQL 7.4 以降の接続でのみ使用可能です。それ以前のバージョンでは失敗します。 </para> <para> この関数は <parameter>stmtname</parameter> という名前の プリペアドステートメントを <parameter>query</parameter> 文字列から作成します。 この文字列には 1 つの SQL コマンドが含まれている必要があります。 <parameter>stmtname</parameter> を "" にすることで無名ステートメントを 作成することが可能で、既存の無名ステートメントは自動的に上書きされます。 それ以外の場合、もしカレントのセッションで既に定義済みのステートメント名を 使用した場合にはエラーとなります。パラメータを使用する際は、 <parameter>query</parameter> 内で $1、$2 のような形式で参照されます。 </para> <para> <function>pg_prepare</function> で使用するプリペアドステートメントは、 SQLの <literal>PREPARE</literal> 文を実行することでも作成可能です (しかし、パラメータの型を事前に指定する必要がないという点で <function>pg_prepare</function> のほうがより柔軟です)。 また、PHP にはプリペアドステートメントを削除する関数がありませんが、 この目的のためには SQLの <literal>DEALLOCATE</literal> 文が使用可能です。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>stmtname</parameter></term> <listitem> <para> プリペアドステートメントにつける名前。接続内で一意である必要があります。 "" が指定された場合は無名ステートメントが作成され、以前に定義された 無名ステートメントを上書きします。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> パラメータ化した SQL 文。ひとつの文のみである必要があります (複数の文をセミコロンで区切る形式は使用できません)。パラメータを 使用する際は $1、$2 などの形式で参照されます。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 成功した場合にクエリ結果リソース、失敗した場合に &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_prepare</function> の使用法</title> <programlisting role="php"> <![CDATA[ <?php // "mary"という名前のデータベースに接続 $dbconn = pg_connect("dbname=mary"); // 実行するクエリの準備 $result = pg_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1'); // プリペアドクエリを実行する。文字列 "Joe's Widgets" は // エスケープの必要がないことに注意 $result = pg_execute($dbconn, "my_query", array("Joe's Widgets")); // 同一プリペアドクエリを別のパラメータで実行する $result = pg_execute($dbconn, "my_query", array("Clothes Clothes Clothes")); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_execute</function></member> <member><function>pg_send_execute</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-parameter-status.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-parameter-status.xml +++ phpdoc-ja/reference/pgsql/functions/pg-parameter-status.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.9 Maintainer: takagi Status: ready --> <refentry id="function.pg-parameter-status"> <refnamediv> <refname>pg_parameter_status</refname> <refpurpose>サーバのパラメータ設定を検索する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>pg_parameter_status</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>param_name</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>string</type><methodname>pg_parameter_status</methodname> <methodparam><type>string</type><parameter>param_name</parameter></methodparam> </methodsynopsis> <para> サーバのパラメータ設定を検索します。 </para> <para> いくつかのパラメータについては、接続の確立時や値の変更時にサーバから 自動的に通知されます。<function>pg_parameter_status</function> は これらの設定問い合わせるために使用可能です。指定したパラメータが存在する 場合にその値を、存在しない場合に &false; を返します。 </para> <para> PostgreSQL 8.0 で指定できるパラメータには以下が含まれます。 <literal>server_version</literal>、 <literal>server_encoding</literal>、<literal>client_encoding</literal>、 <literal>is_superuser</literal>、<literal>session_authorization</literal>、 <literal>DateStyle</literal>、<literal>TimeZone</literal> および <literal>integer_datetimes</literal> (<literal>server_encoding</literal>、<literal>TimeZone</literal> および <literal>integer_datetimes</literal> は 8.0 より前のバージョンでは指定できません)。 <literal>server_version</literal>、<literal>server_encoding</literal> および <literal>integer_datetimes</literal> は、PostgreSQL の稼動中には変更できないことに注意しましょう。 </para> <para> PostgreSQL 7.3 以前のサーバはパラメータ設定を通知する機能を持っていません。 しかし、<function>pg_parameter_status</function> には <literal>server_version</literal> および <literal>client_encoding</literal> を取得する機能を組み込んでいます。これらの値を取得するためにアプリケーションで アドホックなコードを書くのではなく、<function>pg_parameter_status</function> を使用することを推奨します。 </para> <caution> <para> 7.4 より前の PostgreSQL サーバでは、接続の確立後に <literal>SET</literal> を用いて <literal>client_encoding</literal> を変更しても <function>pg_parameter_status</function> には反映されません。 </para> </caution> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>param_name</parameter></term> <listitem> <para> 指定可能な <parameter>param_name</parameter> には以下が含まれます。 <literal>server_version</literal>、 <literal>server_encoding</literal>、<literal>client_encoding</literal>、 <literal>is_superuser</literal>、<literal>session_authorization</literal>、 <literal>DateStyle</literal>、<literal>TimeZone</literal> および <literal>integer_datetimes</literal>。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> パラメータの値を文字列で返します。失敗した場合や <parameter>param_name</parameter> が間違っている場合には &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_parameter_status</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); echo "Server encoding: ", pg_parameter_status($dbconn, "server_encoding"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Server encoding: SQL_ASCII ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-field-type-oid.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-field-type-oid.xml +++ phpdoc-ja/reference/pgsql/functions/pg-field-type-oid.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: takagi Status: ready --> <refentry id="function.pg-field-type-oid"> <refnamediv> <refname>pg_field_type_oid</refname> <refpurpose> フィールド番号に対応する型 ID(OID)を返す </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>pg_field_type_oid</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam><type>int</type><parameter>field_number</parameter></methodparam> </methodsynopsis> <para> <function>pg_field_type_oid</function> は、指定した PostgreSQL <parameter>result</parameter> リソースにおける指定した <parameter>field_number</parameter> の型の OID を返します。 </para> <para> フィールド型についての詳細な情報を得るには、PostgreSQL のシステムテーブル <literal>pg_type</literal> に対して、この関数で取得した OID を用いて 問い合わせます。PostgreSQL の <function>format_type</function> 関数は、 型の OID を SQL の型名に変換します。 </para> <note> <para> フィールドが(基本型ではなく)PostgreSQL ドメインを使用している場合は、 ドメインそのものの OID ではなくドメインの元となっている型の OID を返します。 </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>result</parameter></term> <listitem> <para> <function>pg_query</function>, <function>pg_query_params</function> あるいは <function>pg_execute</function> から返される PostgreSQL の クエリ結果リソース。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>field_number</parameter></term> <listitem> <para> フィールド番号。0 から始まります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> フィールドの型に対応する OID を返します。エラー時には &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>フィールドの情報を得る</title> <programlisting role="php"> <![CDATA[ <?php $dbconn = pg_connect("dbname=publisher") or die("Could not connect"); // 'title' は varchar 型であると仮定する $res = pg_query($dbconn, "select title from authors where author = 'Orwell'"); echo "Title field type OID: ", pg_field_type_oid($res, 0); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Title field type OID: 1043 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_field_type</function></member> <member><function>pg_field_prtlen</function></member> <member><function>pg_field_name</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-fetch-all-columns.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-fetch-all-columns.xml +++ phpdoc-ja/reference/pgsql/functions/pg-fetch-all-columns.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.pg-fetch-all-columns"> <refnamediv> <refname>pg_fetch_all_columns</refname> <refpurpose>指定したカラムの全ての行を配列として取得する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>pg_fetch_all_columns</methodname> <methodparam><type>resource</type><parameter>result</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>column</parameter></methodparam> </methodsynopsis> <para> <function>pg_fetch_all_columns</function> は、結果リソースの 指定したカラムについて全ての行(レコード)を含む配列を返します。 </para> &database.fetch-null; </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>result</parameter></term> <listitem> <para> <function>pg_query</function>, <function>pg_query_params</function> あるいは <function>pg_execute</function> から返される PostgreSQL の クエリ結果リソース。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>column</parameter></term> <listitem> <para> 結果リソースから取得するカラムの番号。0 から始まります。 指定しない場合のデフォルトは最初のカラムです。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 結果カラムの全ての値を配列で返します。 </para> <para> <parameter>column</parameter> が結果のカラム数より大きい場合や その他のエラーが発生した場合に &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_fetch_all_columns</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $conn = pg_pconnect("dbname=publisher"); if (!$conn) { echo "An error occured.\n"; exit; } $result = pg_query($conn, "SELECT title, name, address FROM authors"); if (!$result) { echo "An error occured.\n"; exit; } // 全ての著者名を配列で得る $arr = pg_fetch_all_columns($result, 1); var_dump($arr); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_fetch_all</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/pgsql/functions/pg-execute.xml?r=1.1&p=1 Index: phpdoc-ja/reference/pgsql/functions/pg-execute.xml +++ phpdoc-ja/reference/pgsql/functions/pg-execute.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.pg-execute"> <refnamediv> <refname>pg_execute</refname> <refpurpose> 指定したパラメータを用いてプリペアドステートメントを実行するリクエストを 送信し、その結果を待つ </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>pg_execute</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>stmtname</parameter></methodparam> <methodparam><type>array</type><parameter>params</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>resource</type><methodname>pg_execute</methodname> <methodparam><type>string</type><parameter>stmtname</parameter></methodparam> <methodparam><type>array</type><parameter>params</parameter></methodparam> </methodsynopsis> <para> 指定したパラメータを用いてプリペアドステートメントを実行するリクエストを 送信し、その結果を待ちます。 </para> <para> <function>pg_execute</function> は <function>pg_query_params</function> と似ています。しかし、実行するコマンドはクエリを指定することで 決まるのではなく、事前に準備されたステートメントに値を指定する ことによって決まります。この機能のおかげで、繰り返し使用される コマンドに構文解析や実行計画作成が最初の一度だけで済みます。 実行するステートメントは、カレントのセッションで事前に準備しておく 必要があります。<function>pg_execute</function> は、PostgreSQL 7.4 以降のバージョンの接続にのみ対応しています。それ以前のバージョンでは 失敗します。 </para> <para> パラメータは <function>pg_query_params</function> と同じですが、 クエリ文字列のかわりにプリペアドステートメントの名前を指定する という点だけが違います。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> PostgreSQL データベース接続リソース。<parameter>connection</parameter> が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の <function>pg_connect</function> あるいは <function>pg_pconnect</function> によって作成されたものです。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>stmtname</parameter></term> <listitem> <para> 実行するプリペアドステートメントの名前。"" が指定された場合は 無名ステートメントが実行されます。名前は、事前に <function>pg_prepare</function>・<function>pg_send_prepare</function> あるいは <literal>PREPARE</literal> SQL コマンドで準備されたものである 必要があります。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>params</parameter></term> <listitem> <para> プリペアドステートメント中の $1、$2 などのプレースホルダを 置き換えるパラメータの配列。配列の要素数はプレースホルダの 数と一致する必要があります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 成功した場合にクエリ結果リソース、失敗した場合に &false; を返します。</para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>pg_execute</function> の使用法</title> <programlisting role="php"> <![CDATA[ <?php // "mary"という名前のデータベースに接続 $dbconn = pg_connect("dbname=mary"); // 実行するクエリを準備 $result = pg_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1'); // プリペアドクエリの実行。文字列 "Joe's Widgets" のエスケープ処理は // 一切必要ないことに注意 $result = pg_execute($dbconn, "my_query", array("Joe's Widgets")); // 同じプリペアドクエリを違うパラメータで実行 $result = pg_execute($dbconn, "my_query", array("Clothes Clothes Clothes")); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>pg_prepare</function></member> <member><function>pg_send_prepare</function></member> <member><function>pg_query_params</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.ja (#1133) next »