archived-doc-ja/reference/pgsql/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3c6c95fcfd7d9eaa603df40327693ea8dff89d53 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<appendix xml:id="pgsql.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 
 <variablelist>
  <varlistentry xml:id="constant.pgsql-libpq-version">
   <term>
    <constant>PGSQL_LIBPQ_VERSION</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     短い形式の libpq バージョン情報。数字とドットだけの形式です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-libpq-version-str">
   <term>
    <constant>PGSQL_LIBPQ_VERSION_STR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     PHP 8.0.0 より前のバージョンでは、
     コンパイラの情報も含む 長い形式の libpq バージョン情報を表していました。
     PHP 8.0.0 以降は、
     この値は <constant>PGSQL_LIBPQ_VERSION</constant> の値と等しくなりました。
     よって、<constant>PGSQL_LIBPQ_VERSION_STR</constant>
     を使うことは推奨されなくなっています。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-assoc">
   <term>
    <constant>PGSQL_ASSOC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_fetch_array</function> に渡します。
      フィールド名と値の連想配列を返します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-num">
   <term>
    <constant>PGSQL_NUM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_fetch_array</function> に渡します。
      フィールド番号と値の数値添字配列を返します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-both">
   <term>
    <constant>PGSQL_BOTH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_fetch_array</function> に渡します。
      フィールド値の配列を、数値添字（フィールド番号で）と
      連想配列（フィールド名で）の両方で返します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-force-new">
   <term>
    <constant>PGSQL_CONNECT_FORCE_NEW</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_connect</function> に渡し、既存の同一接続を無視して
      新しい接続を確立させるようにします。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-async">
   <term>
    <constant>PGSQL_CONNECT_ASYNC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_connect</function> に渡し、非同期接続を確立させます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-auth-ok">
   <term>
    <constant>PGSQL_CONNECTION_AUTH_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-awaiting-response">
   <term>
    <constant>PGSQL_CONNECTION_AWAITING_RESPONSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-bad">
   <term>
    <constant>PGSQL_CONNECTION_BAD</constant> 
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_connection_status</function> から返され、データベースとの
      接続が不正な状態になっていることを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-made">
   <term>
    <constant>PGSQL_CONNECTION_MADE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-ok">
   <term>
    <constant>PGSQL_CONNECTION_OK</constant> 
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
      <function>pg_connection_status</function> から返され、データベースとの
      接続が正常であることを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-setenv">
   <term>
    <constant>PGSQL_CONNECTION_SETENV</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-ssl-startup">
   <term>
    <constant>PGSQL_CONNECTION_SSL_STARTUP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-started">
   <term>
    <constant>PGSQL_CONNECTION_STARTED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

     </simpara>
    </listitem>
   </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-set">
   <term>
    <constant>PGSQL_SEEK_SET</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_lo_seek</function> に渡します。シーク操作は
     オブジェクトの先頭から始められます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-cur">
   <term>
    <constant>PGSQL_SEEK_CUR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_lo_seek</function> に渡します。シーク操作は
     カレントの位置から始められます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-end">
   <term>
    <constant>PGSQL_SEEK_END</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_lo_seek</function> に渡します。シーク操作は
     オブジェクトの最後から始められます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-empty-query">
   <term>
    <constant>PGSQL_EMPTY_QUERY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     サーバーに送信された文字列が空でした。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-command-ok">
   <term>
    <constant>PGSQL_COMMAND_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     コマンドは正常に終了し、何もデータを返しませんでした。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-tuples-ok">
   <term>
    <constant>PGSQL_TUPLES_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     コマンドは正常に終了し、データを返しました
     （<literal>SELECT</literal> や <literal>SHOW</literal> など）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-tuples-chunk">
   <term>
    <constant>PGSQL_TUPLES_CHUNK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     チャンクモードでコマンドは正常に終了し、データを返しました。
     <function>pg_set_chunked_rows_size</function> がせっていされた場合の
     <literal>SELECT</literal> コマンドがこの値を返します。
     結果セットは複数のチャンクに分割され、それぞれがあらかじめ決まった行数を持ちます。
     PHP 8.4.0 以降、かつ libpq 17 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-out">
   <term>
    <constant>PGSQL_COPY_OUT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     （サーバーからの）データのコピーが始まりました。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-in">
   <term>
    <constant>PGSQL_COPY_IN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     （サーバーへの）データのコピーが始まりました。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-bad-response">
   <term>
    <constant>PGSQL_BAD_RESPONSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     サーバーからの応答を判別できませんでした。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-nonfatal-error">
   <term>
    <constant>PGSQL_NONFATAL_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     致命的ではないエラー（通知や警告など）が発生しました。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-fatal-error">
   <term>
    <constant>PGSQL_FATAL_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> から返されます。
     致命的なエラーが発生しました。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-idle">
   <term>
    <constant>PGSQL_TRANSACTION_IDLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_transaction_status</function> から返されます。
     接続は現在アイドル状態で、トランザクション内ではありません。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-active">
   <term>
    <constant>PGSQL_TRANSACTION_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_transaction_status</function> から返されます。
     接続内でコマンドを実行中です。クエリが接続を通じて送信され、
     まだ完了していません。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-intrans">
   <term>
    <constant>PGSQL_TRANSACTION_INTRANS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_transaction_status</function> から返されます。
     接続は現在アイドル状態で、トランザクションブロック内にあります。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-inerror">
   <term>
    <constant>PGSQL_TRANSACTION_INERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_transaction_status</function> から返されます。
     接続は現在アイドル状態で、トランザクション処理に失敗しています。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-unknown">
   <term>
    <constant>PGSQL_TRANSACTION_UNKNOWN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_transaction_status</function> から返されます。
     接続が正常ではありません。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-severity">
   <term>
    <constant>PGSQL_DIAG_SEVERITY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     深刻度です。その内容は <literal>ERROR</literal>、
     <literal>FATAL</literal>、あるいは <literal>PANIC</literal>
     （エラーメッセージ内）、あるいは <literal>WARNING</literal>、
     <literal>NOTICE</literal>、<literal>DEBUG</literal>、
     <literal>INFO</literal>、あるいは <literal>LOG</literal>
     （通知メッセージ内）、あるいはこれらの各国語版のうちのどれかです。
     常に存在します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-sqlstate">
   <term>
    <constant>PGSQL_DIAG_SQLSTATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     エラーの SQLSTATE コードです。SQLSTATE コードは発生したエラーの種別を
     特定します。これは、データベースエラーに対してフロントエンドの
     アプリケーションが適切な操作（エラー処理など）をできるようにするために
     使用されます。このフィールドはローカライズされていません。また、
     常に存在します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-primary">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     人間が判読できる最初のエラーメッセージ（たいてい 1 行）です。常に存在します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-detail">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     オプションの 2 番目のエラーメッセージで、問題に対する詳細な情報を
     含みます。複数行にまたがることもあります。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-hint">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_HINT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     オプションのメッセージで、問題に対してどのように対応すべきかを指摘
     します。エラーの詳細情報と違う点は、発生した事実ではなくアドバイス
     （時に不適切な場合もある）をするところです。複数行にまたがることも
     あります。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-statement-position">
   <term>
    <constant>PGSQL_DIAG_STATEMENT_POSITION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     エラーカーソルの位置を、もとのステートメント中の位置として表す
     整数値を保持する文字列です。
     最初の文字の位置は 1 で、それ以降（バイト数ではなく）文字数で
     位置を数えます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-position">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_POSITION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     <constant>PG_DIAG_STATEMENT_POSITION</constant> と同じ定義ですが、
     こちらはカーソル位置が内部で生成されたコマンドを参照している場合に
     使用されます。このフィールドが存在する場合は、常に
     <constant>PG_DIAG_INTERNAL_QUERY</constant> フィールドも存在します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-query">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_QUERY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     失敗した内部生成コマンドのテキストです。例としては、PL/pgSQL 関数で
     発行された SQL クエリなどがあてはまります。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-context">
   <term>
    <constant>PGSQL_DIAG_CONTEXT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     エラーが発生した状況を指定します。現在ここに含まれているのは、
     アクティブなプロシージャの関数や内部生成クエリのコール履歴です。
     これはエントリごとに 1 行のデータとなっており、直近のデータが
     先頭にきます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-file">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FILE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     エラーが報告された箇所の、PostgreSQL ソースコードでのファイル名です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-line">
   <term>
    <constant>PGSQL_DIAG_SOURCE_LINE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     エラーが報告された箇所の、PostgreSQL ソースコードでの行番号です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-function">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FUNCTION</constant> 
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_error_field</function> に渡します。
     エラーが報告された箇所の、PostgreSQL ソースコードでの関数名です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-schema-name">
   <term>
    <constant>PGSQL_DIAG_SCHEMA_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 7.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-table-name">
   <term>
    <constant>PGSQL_DIAG_TABLE_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 7.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-column-name">
   <term>
    <constant>PGSQL_DIAG_COLUMN_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 7.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-datatype-name">
   <term>
    <constant>PGSQL_DIAG_DATATYPE_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 7.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-constraint-name">
   <term>
    <constant>PGSQL_DIAG_CONSTRAINT_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 7.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-errors-terse">
   <term>
    <constant>PGSQL_ERRORS_TERSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_verbosity</function> に渡します。
     返されるメッセージを指定します。ここには深刻度・短い説明および
     発生位置のみを含めます。通常は 1 行に収まるでしょう。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-default">
   <term>
    <constant>PGSQL_ERRORS_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_verbosity</function> に渡します。
     デフォルトで返されるメッセージで、上の内容に加えて詳細・
     ヒントあるいは詳細情報を含めます（複数行にまたがるかもしれません）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-verbose">
   <term>
    <constant>PGSQL_ERRORS_VERBOSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_verbosity</function> に渡します。
     詳細モードでのメッセージで、有効なフィールドをすべて含めます。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-sqlstate">
   <term>
    <constant>PGSQL_ERRORS_SQLSTATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_verbosity</function> に渡します。
     エラーの深刻度と <literal>SQLSTATE</literal> エラーコードのみを含めます。
     エラーコードが利用できない場合、出力は
     <constant>PGSQL_ERRORS_TERSE</constant> モードと似たものになります。
     PostgreSQL 11.1 より前のバージョンでは、
     <constant>PGSQL_ERRORS_TERSE</constant> モードと出力が常に同じでした。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-notice-last">
   <term>
    <constant>PGSQL_NOTICE_LAST</constant> 
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_last_notice</function> で使用されます。
     PHP 7.1.0 以降で使用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-notice-all">
   <term>
    <constant>PGSQL_NOTICE_ALL</constant> 
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_last_notice</function> で使用されます。
     PHP 7.1.0 以降で使用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-notice-clear">
   <term>
    <constant>PGSQL_NOTICE_CLEAR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_last_notice</function> で使用されます。
     PHP 7.1.0 以降で使用可能です。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-status-long">
   <term>
    <constant>PGSQL_STATUS_LONG</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> に渡します。
     結果として数値が要求されていることを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-status-string">
   <term>
    <constant>PGSQL_STATUS_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_result_status</function> に渡します。
     結果としてテキストのコマンドタグが要求されていることを示します。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-conv-ignore-default">
   <term>
    <constant>PGSQL_CONV_IGNORE_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_convert</function> に渡します。
     変換時に、テーブルのデフォルト値を無視します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-force-null">
   <term>
    <constant>PGSQL_CONV_FORCE_NULL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_convert</function> に渡します。
     空文字列に対して、SQL の <literal>NULL</literal> を使用します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-ignore-not-null">
   <term>
    <constant>PGSQL_CONV_IGNORE_NOT_NULL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_convert</function> に渡します。
     &null; を SQL の <literal>NOT NULL</literal> に変換しないように
     します。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-dml-no-conv">
   <term>
    <constant>PGSQL_DML_NO_CONV</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_insert</function> や <function>pg_select</function>、
     <function>pg_update</function>、<function>pg_delete</function> に渡します。
     すべてのパラメータを、そのままの形式で渡します。ユーザーから受け取ったデータを渡す際には、手動でのエスケープが必要になります。
     <function>pg_escape_string</function> を使いましょう。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-exec">
   <term>
    <constant>PGSQL_DML_EXEC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_insert</function> や <function>pg_select</function>、
     <function>pg_update</function>、<function>pg_delete</function> に渡します。
     これらの関数を使って、クエリを実行します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-async">
   <term>
    <constant>PGSQL_DML_ASYNC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_insert</function> や <function>pg_select</function>、
     <function>pg_update</function>、<function>pg_delete</function> に渡します。
     これらの関数を使って、非同期クエリを実行します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-string">
   <term>
    <constant>PGSQL_DML_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_insert</function> や <function>pg_select</function>、
     <function>pg_update</function>、<function>pg_delete</function> に渡します。
     実行したクエリ文字列を返します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-escape">
   <term>
    <constant>PGSQL_DML_ESCAPE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_insert</function> や <function>pg_select</function>、
     <function>pg_update</function>、<function>pg_delete</function> に渡します。
     内部的に <function>pg_convert</function> を呼ぶ代わりに、すべてのパラメータをエスケープします。
     このオプションは、メタデータのルックアップを除外します。
     <function>pg_query</function> や <function>pg_send_query</function>
     と同程度の速度になります。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-failed">
   <term>
    <constant>PGSQL_POLLING_FAILED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_connect_poll</function> が返す値です。
     接続の試行に失敗したことを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-reading">
   <term>
    <constant>PGSQL_POLLING_READING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_connect_poll</function> が返す値です。
     接続が、PostgreSQL のソケットが読み込み可能になるのを待っていることを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-writing">
   <term>
    <constant>PGSQL_POLLING_WRITING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_connect_poll</function> が返す値です。
     接続が、PostgreSQL のソケットが書き込み可能になるのを待っていることを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-ok">
   <term>
    <constant>PGSQL_POLLING_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_connect_poll</function> が返す値です。
     接続が、利用可能になったことを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-active">
   <term>
    <constant>PGSQL_POLLING_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_connect_poll</function> が返す値です。
     接続が、現在アクティブであることを示します。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-severity-nonlocalized">
   <term>
    <constant>PGSQL_DIAG_SEVERITY_NONLOCALIZED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     深刻度。 このフィールドの内容は(エラーメッセージの場合)ERROR、FATAL、もしくは、PANIC、
     (注意喚起メッセージの場合)WARNING、NOTICE、DEBUG、INFO、もしくは、LOGです。 
     これは、内容が多言語化されないことを除き、PG_DIAG_SEVERITY と同一です。
     これはPostgreSQLのバージョン9.6以降で生成された報告にのみ存在します / PHP 7.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>  
  <varlistentry xml:id="constant.pgsql-show-context-never">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_NEVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_context_visibility</function> に指定するために使います。コンテクストは決して表示されません。
     PHP 8.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-show-context-errors">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_ERRORS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_context_visibility</function> に指定するために使います。コンテクストのフィールドはエラーメッセージのみです。
     これがデフォルトの動作です。
     PHP 8.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-show-context-always">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_ALWAYS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_set_error_context_visibility</function> に指定するために使います。コンテクストのフィールドには error, notice, warning メッセージが含まれます。
     PHP 8.3.0 以降で利用可能です。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-trace-suppress-timestamps">
   <term>
    <constant>PGSQL_TRACE_SUPPRESS_TIMESTAMPS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_trace</function> に指定するために使います。
     トレースのメッセージにタイムスタンプを含めません。
     PHP 8.3.0 以降で利用可能です。
    </simpara>
   </listitem>
   </varlistentry>
  <varlistentry xml:id="constant.pgsql-trace-regress-mode">
   <term>
    <constant>PGSQL_TRACE_REGRESS_MODE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     <function>pg_trace</function> に指定するために使います。
     OID のようなフィールドを、トレースのメッセージに含めます。
     PHP 8.3.0 以降で利用可能です。
    </simpara>
   </listitem>
   </varlistentry>
 </variablelist>
</appendix>
<!-- 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:"~/.phpdoc/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
-->