archived-doc-pt-br/reference/pgsql/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f5419b6eddbbb69317b0b3e6d752532ee2ed0b2a Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->
<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>
     Versão curta da libpq, contendo apenas números e pontos.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-libpq-version-str">
   <term>
    <constant>PGSQL_LIBPQ_VERSION_STR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Antes do PHP 8.0.0, a versão longa da libpq que incluía informação de compilação.
     A partir do PHP 8.0.0, o valor é idêntico a <constant>PGSQL_LIBPQ_VERSION</constant>,
     e usar <constant>PGSQL_LIBPQ_VERSION_STR</constant> foi descontinuado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-assoc">
   <term>
    <constant>PGSQL_ASSOC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Usada em <function>pg_fetch_array</function>. Retorna um array associativo contendo
     nomes dos campos e valores.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-num">
   <term>
    <constant>PGSQL_NUM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Usada em <function>pg_fetch_array</function>. Retorna um array com índice numérico contendo
     números dos campos e valores.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-both">
   <term>
    <constant>PGSQL_BOTH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Usada em <function>pg_fetch_array</function>. Retorna um array dos valores do campos
     com índice numérico (por número do campo) e associativo (por nome do campo).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-force-new">
   <term>
    <constant>PGSQL_CONNECT_FORCE_NEW</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Usado em <function>pg_connect</function> para forçar a criação de nova conexão,
     ao invés de reutilizar uma conexão idêntica existente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-async">
   <term>
    <constant>PGSQL_CONNECT_ASYNC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_connect</function> para criar uma conexão
     assíncrona.
    </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>
     Retornado pela <function>pg_connection_status</function> indicando que a conexão
     com o banco de dados está em um estado inválido.
    </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>
     Retornado pela <function>pg_connection_status</function> indicando que a conexão
     com o banco de dados está em um estado válido.
    </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>
     Passada para <function>pg_lo_seek</function>. Operação de pesquisa deve iniciar
     a partir do início do objeto.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-cur">
   <term>
    <constant>PGSQL_SEEK_CUR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_lo_seek</function>. Operação de pesquisa deve iniciar
     a partir da posição atual.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-end">
   <term>
    <constant>PGSQL_SEEK_END</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_lo_seek</function>. Operação de pesquisa deve iniciar
     a partir do final do objeto.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-empty-query">
   <term>
    <constant>PGSQL_EMPTY_QUERY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. A string enviada para o servidor
     estava vazia.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-command-ok">
   <term>
    <constant>PGSQL_COMMAND_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. Conclusão bem sucedida de um
     comando que não retornou dados.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-tuples-ok">
   <term>
    <constant>PGSQL_TUPLES_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>.Conclusão bem sucedida de um
     retornando dados (como um <literal>SELECT</literal> ou <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>
     Retornada por <function>pg_result_status</function>.
     Indica o término bem sucedido de um comando que retorna dados em modo fragmentado.
     Retornada para instruções <literal>SELECT</literal> quando
     <function>pg_set_chunked_rows_size</function> está definida.
     O conjunto de resultados é dividido em múltiplos fragmentos, cada um contendo um número predefinido de linhas.
     Disponível a partir do PHP 8.4.0 e libpq 17.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-out">
   <term>
    <constant>PGSQL_COPY_OUT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. Transferência de dados "Copy Out"
     (do servidor) iniciada.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-in">
   <term>
    <constant>PGSQL_COPY_IN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. Transferência de dados "Copy In"
     (para o servidor) iniciada.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-bad-response">
   <term>
    <constant>PGSQL_BAD_RESPONSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. A resposta do servidor
     não foi entendida.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-nonfatal-error">
   <term>
    <constant>PGSQL_NONFATAL_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. Um erro não fatal
     (uma nota ou alerta) ocorreu.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-fatal-error">
   <term>
    <constant>PGSQL_FATAL_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_result_status</function>. Um erro fatal
     ocorreu.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-idle">
   <term>
    <constant>PGSQL_TRANSACTION_IDLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_transaction_status</function>. Conexão está
     atualmente ociosa, não em uma transação.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-active">
   <term>
    <constant>PGSQL_TRANSACTION_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_transaction_status</function>. Um comando
     está em progresso na conexão. Uma consulta foi enviada pela conexão
     e ainda não foi concluída.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-intrans">
   <term>
    <constant>PGSQL_TRANSACTION_INTRANS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_transaction_status</function>. A conexão
     está ociosa, em um bloco de transação.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-inerror">
   <term>
    <constant>PGSQL_TRANSACTION_INERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_transaction_status</function>. A conexão
     está ociosa, em um bloco de transação com falha.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-unknown">
   <term>
    <constant>PGSQL_TRANSACTION_UNKNOWN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornado pela <function>pg_transaction_status</function>. A conexão
     está ruim.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-severity">
   <term>
    <constant>PGSQL_DIAG_SEVERITY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     A severidade; os conteúdos dos campos são <literal>ERROR</literal>,
     <literal>FATAL</literal> ou <literal>PANIC</literal> (em uma mensagem de erro); ou
     <literal>WARNING</literal>, <literal>NOTICE</literal>, <literal>DEBUG</literal>,
     <literal>INFO</literal> ou <literal>LOG</literal> (em uma nota), ou uma
     tradução de um desses. Sempre presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-sqlstate">
   <term>
    <constant>PGSQL_DIAG_SQLSTATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     O código SQLSTATE do erro. O código SQLSTATE identifica o tipo do erro
     ocorrido; ele pode ser usado por aplicações front-end para executar operações
     específicas (como manipulação de erro) em resposta a um erro particular do banco de dados.
     Esta campo não muda com a localidade, e está sempre presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-primary">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     A mensagem de erro legível primária (tipicamente uma linha). Sempre presente.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-detail">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     Detalhe: uma mensagem de erro secundária trazendo mais detalhes sobre o problema. Pode conter múltiplas linhas.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-hint">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_HINT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     Dica: um sugestão opcional sobre o que fazer em relação ao problema. Tem a intenção de ser diferente da mensagem detalhada
     de forma a oferecer conselhos (potencialmente inapropriados) ao invés de fatos concretos. Pode conter múltiplas linhas.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-statement-position">
   <term>
    <constant>PGSQL_DIAG_STATEMENT_POSITION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     Uma string contendo um inteiro decimal indicando uma posição de cursor de erro como um índice da string
     da declaração original. O primeiro caractere tem índice 1, e as posições são medidas em caracteres, não em bytes.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-position">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_POSITION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     Esta é definida da mesma forma que o campo <constant>PG_DIAG_STATEMENT_POSITION</constant>, mas
     ela é usado quando a posição do cursor refere-se a um comando gerado internamente
     ao invés do enviado pelo cliente. O campo
     <constant>PG_DIAG_INTERNAL_QUERY</constant> irá sempre aparecer quando este
     campo aparecer.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-query">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_QUERY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     O texto do comando gerado internamente que falhou. Poderá ser, por exemplo, uma
     consulta SQL emitida por uma função PL/pgSQL.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-context">
   <term>
    <constant>PGSQL_DIAG_CONTEXT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     Um indicador de contexto no qual o erro ocorreu. Atualmente
     isto inclui um restreamento de pilha de chamadas de funções de linguagem
     procedural ativas e consultas geradas internamente. O rastreamento é uma entrada
     por linha, a mais recente primeiro.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-file">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FILE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     O nome do arquivo da localização do código-fonte PostgreSQL onde o
     erro foi reportado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-line">
   <term>
    <constant>PGSQL_DIAG_SOURCE_LINE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     O número da linha da localização do código-fonte PostgreSQL onde o
     erro foi reportado.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-function">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FUNCTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_error_field</function>.
     O nome da função do código-fonte PostgreSQL que reportou o erro.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-schema-name">
   <term>
    <constant>PGSQL_DIAG_SCHEMA_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Disponível desde o 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>
     Disponível desde o 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>
     Disponível desde o 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>
     Disponível desde o 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>
     Disponível desde o 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>
     Passada para <function>pg_set_error_verbosity</function>.
     Especifica que a mensagem retornada inclui severidade, texto primário
     e posição somente; normalmente em uma única linha.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-default">
   <term>
    <constant>PGSQL_ERRORS_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_set_error_verbosity</function>.
     O modo padrão produz mensagens que incluem as informações do campo acima mais
     algum detalhe, dica, ou campos de contexto (estes podem ter
     múltiplas linhas).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-verbose">
   <term>
    <constant>PGSQL_ERRORS_VERBOSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_set_error_verbosity</function>.
     Este modo prolixo inclui todos os campos disponíveis.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-sqlstate">
   <term>
    <constant>PGSQL_ERRORS_SQLSTATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_set_error_verbosity</function>.
     Inclui apenas a severidade de erro e o código de erro <literal>SQLSTATE</literal>.
     Se não houver código de erro disponível, a saída é similar ao
     modo <constant>PGSQL_ERRORS_TERSE</constant>.
     Antes do PostgreSQL 11.1, a saída era sempre a mesma
     do modo <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>
     Usado por <function>pg_last_notice</function>.
     Disponível desde o 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>
     Usado por <function>pg_last_notice</function>.
     Disponível desde o 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>
     Usado por <function>pg_last_notice</function>.
     Disponível desde o 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>
     Passada para <function>pg_result_status</function>. Indica que
     é desejando um código de resultado numérico.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-status-string">
   <term>
    <constant>PGSQL_STATUS_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_result_status</function>. Indica que
     é desejado um resultado textual.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-conv-ignore-default">
   <term>
    <constant>PGSQL_CONV_IGNORE_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_convert</function>.
     Ignora valores padrão na tabela durante a conversão.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-force-null">
   <term>
    <constant>PGSQL_CONV_FORCE_NULL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_convert</function>.
     Usa <literal>NULL</literal> da SQL no lugar de uma <type>string</type> vazia.
    </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>
     Passada para <function>pg_convert</function>.
     Ignora conversão de &null; em colunas 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>
     Passada para <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> e <function>pg_delete</function>.
     Todos os parâmetros passados como são. Escape manual é requeriso se
     os parâmentros contiverem dados fornecidos pelo usuário. Use <function>pg_escape_string</function>
     para isto.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-exec">
   <term>
    <constant>PGSQL_DML_EXEC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> e <function>pg_delete</function>.
     Executa consulta através dessas funções.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-async">
   <term>
    <constant>PGSQL_DML_ASYNC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> e <function>pg_delete</function>.
     Executa consulta assíncrona através dessas funções.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-string">
   <term>
    <constant>PGSQL_DML_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> e <function>pg_delete</function>.
     Retorna a string da consulta executada.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-escape">
   <term>
    <constant>PGSQL_DML_ESCAPE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Passada para <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> e <function>pg_delete</function>.
     Escapa todos os parâmetros ao invés de chamar <function>pg_convert</function>
     internamente. Esta opção omite pesquisa por metadados. A consulta pode ser tão rápida quanto
     <function>pg_query</function> e <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>
     Retornada por <function>pg_connect_poll</function> para indicar que a
     tentativa de conexão falhou.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-reading">
   <term>
    <constant>PGSQL_POLLING_READING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornada por <function>pg_connect_poll</function> para indicar que a
     conexão está esperando que o socket PostgreSQL possa ser lido.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-writing">
   <term>
    <constant>PGSQL_POLLING_WRITING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornada por <function>pg_connect_poll</function> para indicar que a
     conexão está esperando que o socket PostgreSQL possa ser escrito.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-ok">
   <term>
    <constant>PGSQL_POLLING_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornada por <function>pg_connect_poll</function> para indicar que a
     conexão está pronta para uso.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-active">
   <term>
    <constant>PGSQL_POLLING_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Retornada por <function>pg_connect_poll</function> para indicar que a
     conexão está atualmente ativa.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-severity-nonlocalized">
   <term>
    <constant>PGSQL_DIAG_SEVERITY_NONLOCALIZED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     A severidade; os conteúdos dos campos são ERROR, FATAL ou PANIC (em uma mensagem de erro); ou WARNING, NOTICE, DEBUG, INFO, ou LOG (em uma nota). Isto é idêntico ao campo PG_DIAG_SEVERITY exceto que o conteúdo nunca é traduzido. Está presente somente em versões 9.6 e posteriores / PHP 7.3.0 e posteriores.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-show-context-never">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_NEVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Para ser usada com <function>pg_set_error_context_visibility</function>,
     o contexto nunca é mostrado.
     Disponível a partir do 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>
     Para ser usada com <function>pg_set_error_context_visibility</function>,
     os campos do contexto são incluídos apenas nas mensagens de erro.
     Este é o comportamento padrão.
     Disponível a partir do 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>
     Para ser usada com <function>pg_set_error_context_visibility</function>,
     os campos do contexto são incluídos nas mensagens de erro, notas e alertas.
     Disponível a partir do 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>
     Para ser usada com <function>pg_trace</function>,
     o timestamp não é incluído nas mensagens de rastreamento.
     Disponível a partir do PHP 8.4.20.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-trace-regress-mode">
   <term>
    <constant>PGSQL_TRACE_REGRESS_MODE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Para ser usada com <function>pg_trace</function>,
     campos como OIDs são incluídos nas mensagens de rastreamento.
     Disponível a partir do 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
-->