phaser Wed May 15 09:46:51 2002 EDT
Added files:
/phpdoc-pt_BR/reference/pgsql/functions pg-affected-rows.xml
pg-cancel-query.xml
pg-client-encoding.xml
pg-close.xml pg-connect.xml
pg-connection-busy.xml
pg-connection-reset.xml
pg-connection-status.xml
pg-convert.xml
pg-copy-from.xml
pg-copy-to.xml
pg-dbname.xml pg-delete.xml
pg-end-copy.xml
pg-escape-bytea.xml
pg-escape-string.xml
pg-fetch-array.xml
pg-fetch-object.xml
pg-fetch-result.xml
pg-fetch-row.xml
pg-field-is-null.xml
pg-field-name.xml
pg-field-num.xml
pg-field-prtlen.xml
pg-field-size.xml
pg-field-type.xml
pg-free-result.xml
pg-get-result.xml
pg-host.xml pg-insert.xml
pg-last-error.xml
pg-last-notice.xml
pg-last-oid.xml
pg-lo-close.xml
pg-lo-create.xml
pg-lo-export.xml
Log:
1st pt_BR version
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-affected-rows.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-affected-rows.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-affected-rows">
<refnamediv>
<refname>pg_affected_rows</refname>
<refpurpose>Retorna o n�mero de registros afetados (linhas)</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_affected_rows</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_affected_rows</function> retorna o n�mero de linhas
(inst�ncias/registros/linhas) afetados por pedidos INSERT, UPDATE
e DELETE executados por <function>pg_query</function>. Se nenhuma
linha for afetada por esta fun��o, ela retornar� 0.
<example>
<title><function>pg_affected_rows</function></title>
<programlisting role="php">
<![CDATA[
<?php
$result = pg_query ($conn, "INSERT INTO publisher VALUES ('Author')");
$cmdtuples = pg_affected_rows ($result);
echo $cmdtuples . " linhas foram afetadas.";
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
Esta fun��o costumava ser chamada <literal>pg_cmdtuples()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_query</function> e
<function>pg_num_rows</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-cancel-query.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-cancel-query.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
<refentry id='function.pg-cancel-query'>
<refnamediv>
<refname>pg_cancel_query</refname>
<refpurpose>
Cancela um pedido ass�ncrono
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_cancel_query</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_cancel_query</function> cancela um pedido ass�ncrono enviado por
<function>pg_send_query</function>. Voc� n�o pode cancelar um pediso executado por
<function>pg_query</function>.
</para>
<para>
Veja tamb�m <function>pg_send_query</function>
e <function>pg_connection_busy</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-client-encoding.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-client-encoding.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.16 -->
<refentry id="function.pg-client-encoding">
<refnamediv>
<refname>pg_client_encoding</refname>
<refpurpose>
Pega a codifica��o do cliente
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_client_encoding</methodname>
<methodparam
choice="opt"><type>resource</type><parameter>connection</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_client_encoding</function> retorna a codifica��o
do cliente como uma string. A string de retorno pode ser
SQL_ASCII, EUC_JP, EUC_CN, EUC_KR, EUC_TW, UNICODE,
MULE_INTERNAL, LATINX (X=1...9), KOI8, WIN, ALT, SJIS, BIG5,
WIN1250.
</para>
<note>
<para>
Esta fun��o requer PHP-4.0.3 ou maior e PostgreSQL-7.0 ou maior
Se libpq est� compilada sem suporte a codifica��o multibyte
<function>pg_set_client_encoding</function> sempre retornar�
"SQL_ASCII". Codifica��es suportadas depende da vers�o
PostgreSQL. Vide o manual PostgreSQL para detalhes em como habilitar
o suporte a multibyte e condifica��o.
</para>
<para>
Esta fun��o costumava ser chamada
<function>pg_clientencoding</function>.
</para>
</note>
<para>
VEja tamb�m <function>pg_set_client_encoding</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-close.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-close.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id="function.pg-close">
<refnamediv>
<refname>pg_close</refname>
<refpurpose>Fecha uma conex�o PostgreSQL</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_close</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_close</function> fecha a conex�o n�o persistente
a um banco de dados PostgreSQL associado ao recurso
<parameter>conex�o</parameter> dado. &return.success;
</para>
<note>
<para>
O uso de <function>pg_close</function> normalmente n�o � necess�rio
j� que conex�es n�o persistentes abertas s�o automaticamente fechadas
ao final do processamento do script.
</para>
</note>
<para>
Se existem recursos de objeto grandes aberto na conex�o, n�o feche
a conex�o antes de fechar todos os recursos de objeto grandes.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-connect.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-connect.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-connect">
<refnamediv>
<refname>pg_connect</refname>
<refpurpose>Abre uma conex�o PostgreSQL</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>recurso</type><methodname>pg_connect</methodname>
<methodparam><type>string</type><parameter>string_de_conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_connect</function> retorna um recurso de conex�o
que � exigido por outras fun��es PostgreSQL.
</para>
<para>
<function>pg_connect</function> abre uma conex�o para um
banco de dados PostgreSQL especificado pela
<parameter>string_de_conex�o</parameter>. Ele retorna um recurso de
conex�o caso haja sucesso. Retorna &false; se a conex�o n�o puder ser
estabelecida. <parameter>string_de_conex�o</parameter> deve ser uma
string entre aspas duplas.
<example>
<title>Usando pg_connect</title>
<programlisting role="php">
<![CDATA[
<?php
$bdcon = pg_connect ("dbname=flavia");
//conecta a um banco de dados chamado "flavia"
$bdcon2 = pg_connect ("host=localhost port=5432 dbname=flavia");
// conecta a um banco de dados chamado "flavia" em "localhost" na porta "5432"
$bdcon3 = pg_connect ("host=ovelha port=5432 dbname=flavia user=ze password=buu");
//conecta a um banco de dados chamado "flavia" na m�quina "ovelha" com um usu�rio e
senha
$con_string = "host=ovelha port=5432 dbname=flavia user=ze password=buu";
$bdcon4 = pg_connect ($con_string);
//coneta a um banco de dados chamado "flavia" na m�quina "ovelha" com um usu�rio e
senha
?>
]]>
</programlisting>
</example>
Os argumentos dispon�veis para
<parameter>string_de_conex�o</parameter> incluem
<parameter>host</parameter>, <parameter>porta</parameter>,
<parameter>tty</parameter>, <parameter>op��es</parameter>,
<parameter>nomebd</parameter>, <parameter>usu�rio</parameter>, e
<parameter>senha</parameter>.
</para>
<para>
Se uma segunda chamada � feita para <function>pg_connect</function> com a
mesma <parameter>string_de_conex�o</parameter>, nenhuma nova conex�o ser�
estabelecida, ao inv�s disso o recurso de conex�o da conex�o que j� est�
aberta ser� retornado. Voc� pode ter multiplas conex�es para o mesmo
banco de dados se voc� usar diferentes strings de conex�o.
</para>
<para>
A sintaxe antiga com par�metros m�ltiplos
<command>$con = pg_connect ("host", "porta", "opt��es", "tty", "nomebd")
</command> est� obsoleta.
</para>
<para>
Veja tamb�m <function>pg_pconnect</function>,
<function>pg_close</function>, <function>pg_host</function>,
<function>pg_port</function>, <function>pg_tty</function>,
<function>pg_options</function> e <function>pg_dbname</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-connection-busy.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-connection-busy.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id='function.pg-connection-busy'>
<refnamediv>
<refname>pg_connection_busy</refname>
<refpurpose>
Verifica se a conex�o est� ocupada ou n�o
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_connection_busy</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_connection_busy</function> retorna &true; se a conex�o est�
ocupada. Se estiver ocupada � porque um pedido anterior ainda ets� sendo
executada. Se <function>pg_get_result</function> for chamado, ela ser�
bloqeuada.
</para>
<para>
Veja tamb�m <function>pg_connection_status</function> e
<function>pg_get_result</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-connection-reset.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-connection-reset.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id='function.pg-connection-reset'>
<refnamediv>
<refname>pg_connection_reset</refname>
<refpurpose>
Reinicia a conex�o (reconecta)
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_connection_reset</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_connection_reset</function> reinicia a conex�o.
Isso � �til para recupera��o de erros. &return.success;
</para>
<para>
Veja tamb�m <function>pg_connect</function>,
<function>pg_pconnect</function> e
<function>pg_connection_status</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-connection-status.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-connection-status.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id='function.pg-connection-status'>
<refnamediv>
<refname>pg_connection_status</refname>
<refpurpose>
Pega o status da conex�o
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_connection_status</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_connection_status</function> retorna o status da conex�o
Status poss�veis s�o <literal>PGSQL_CONNECTION_OK</literal> e
<literal>PGSQL_CONNECTION_BAD</literal>.
</para>
<para>
Veja tamb�m <function>pg_connection_busy</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-convert.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-convert.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 -->
<refentry id='function.pg-convert'>
<refnamediv>
<refname>pg_convert</refname>
<refpurpose>
Converte os valores de uma array associativa em uma declara��o SQL
apropriada.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>array</type><methodname>pg_convert</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_da_tabela</parameter></methodparam>
<methodparam><type>array</type><parameter>array_associativa</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>op��es</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_convert</function> checa e converte a
<literal>array_associativa</literal> para uma declara��o SQL apropriada.
</para>
<note>
<para>
Esta fun��o � experimental.
</para>
</note>
<para>
Veja tamb�m <function>pg_metadata</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-copy-from.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-copy-from.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id='function.pg-copy-from'>
<refnamediv>
<refname>pg_copy_from</refname>
<refpurpose>
Insere registros dentro de uma tabela a partir de uma array
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_copy_from</methodname>
<methodparam><type>int</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_da_tabela</parameter></methodparam>
<methodparam><type>array</type><parameter>linhas</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>delimitador</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>null_as</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_copy_from</function> insere registros em uma tabela a partir
de <parameter>linhas</parameter>. Ele usa o comando interno
<literal>COPY</literal> para inserir registros.
&return.success;
</para>
<para>
Veja tamb�m <function>pg_copy_to</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-copy-to.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-copy-to.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id='function.pg-copy-to'>
<refnamediv>
<refname>pg_copy_to</refname>
<refpurpose>
Copia uma tabela em uma array
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_copy_to</methodname>
<methodparam><type>int</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_da_tabela</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>delimitador</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>null_as</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_copy_to</function> copia uma tabela em uma array. O array
resultante � retornado. Caso haja falhas &false; � retornado.
</para>
<para>
Veja tamb�m <function>pg_copy_from</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-dbname.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-dbname.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-dbname">
<refnamediv>
<refname>pg_dbname</refname>
<refpurpose>Pega o nome do banco de dados</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_dbname</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_dbname</function> retorna o nome do banco de dados dado o
recurso <parameter>conex�o</parameter> do PostgreSQL. Ele retorna
&false;, se a <parameter>conex�o</parameter> n�o � um recurso de conex�o
PostgreSQL v�lido.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-delete.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-delete.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 -->
<refentry id='function.pg-delete'>
<refnamediv>
<refname>pg_delete</refname>
<refpurpose>
Deleta registros.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>long</type><methodname>pg_delete</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_da_tabela</parameter></methodparam>
<methodparam><type>array</type><parameter>array_associativa</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>op��es</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_delete</function> deleta a conedi��o de registro
especificada por <literal>array_associativa</literal> que tem
<literal>campo=>valor</literal>. Se <literal>op��o</literal> �
especificado, <function>pg_convert</function> � aplicada a
<literal>array_associativa</literal> com a op��o especificada.
</para>
<example>
<title>pg_delete</title>
<programlisting role="php">
<![CDATA[
<?php
$db = pg_connect ('dbname=flavia');
// Isto � seguro, j� que $_POST � convertida automaticamente
$res = pg_delete($db, 'post_log', $_POST);
if ($res) {
echo "Dados de POST foram deletados: $res\n";
}
else {
echo "O usu�rio deve ter enviado inputs errados\n";
}
?>
]]>
</programlisting>
</example>
<note>
<para>
Esta fun��o � exsperimental.
</para>
</note>
<para>
Veja tamb�m <function>pg_convert</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-end-copy.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-end-copy.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id="function.pg-end-copy">
<refnamediv>
<refname>pg_end_copy</refname>
<refpurpose>Sincroniza com o backend PostgreSQL</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_end_copy</methodname>
<methodparam
choice="opt"><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_end_copy</function> sincroniza o frontend PostgreSQL
(geralmente um processo de web server) com o servidor PostgreSQL depois
de fazer uma opera��o de c�pia executada por
<function>pg_put_line</function>. <function>pg_end_copy</function>
deve ser chamada, caso contr�rio o servidor PostgreSQL pode perder a
sincronia com o frontend fazendo com que o servidor gere um erro. &return.success;
</para>
<para>
Para maiores detalhes e um exemplo, veja tamb�m
<function>pg_put_line</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-escape-bytea.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-escape-bytea.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
<refentry id='function.pg-escape-bytea'>
<refnamediv>
<refname>pg_escape_bytea</refname>
<refpurpose>
Gera binarios para o tipo bytea
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_escape_bytea</methodname>
<methodparam><type>string</type><parameter>dados</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_escape_bytea</function> gera uma string para um tipo de
dados bytea. Ele retorna string com escapes.
</para>
<note>
<para>
Quando voc� usa SELECT bytea type, PostgreSQL retorna valores de byte
octais prefixados por \. (ex.: \032) Os usu�rios devem converter de
volta para bin�rios por si mesmos.
</para>
<para>
Esta fun��o exige PostgreSQL 7.2 ou superior. Com PostgreSQL 7.2.0 e
7.2.1, o tipo de dados bytea deve ser criando quando voc� habilita o
suporte a multi-byte. Por exemplo <literal>INSERT INTO tabela_teste
(imagem) VALUES ('$imagem_escaped'::bytea);</literal> PostgreSQL 7.2.2
ou superior n�o precisa de coer��o. A exce��o � quando a codifica��o de
caracteres do cliente e do backend n�o combinam, ent�o pode haver erro
de fluxo de multi-byte. O usu�rio deve fazer a coer��o para bytea para
evitar este erro.
</para>
<para>
PostgreSQL mais novos suportar�o a fun��o unescape. Suporte para a
fun��o interna unescape ser� adicionada assim que estiver dispon�vel.
</para>
</note>
<para>
Veja tamb�m <function>pg_escape_string</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-escape-string.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-escape-string.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
<refentry id='function.pg-escape-string'>
<refnamediv>
<refname>pg_escape_string</refname>
<refpurpose>
Gera string para o tipo text/char
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_escape_string</methodname>
<methodparam><type>string</type><parameter>dados</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_escape_string</function> gera strings para o tipo de dados
text/chat. Ele retorna uma string com escapes para PostgreSQL. O uso
desta fun��o � recomendado no lugar de <function>addslashes</function>.
</para>
<note>
<para>
Esta fun��o exige PostgreSQL 7.2 ou superior.
</para>
</note>
<para>
VEja tamb�m <function>pg_escape_bytea</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-array.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-array.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-fetch-array">
<refnamediv>
<refname>pg_fetch_array</refname>
<refpurpose>Pega uma linha como um array</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>array</type><methodname>pg_fetch_array</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>linha</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>tipo_de_resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_fetch_array</function> retorna uma array que corresponde 'a
linha pega (registro). Ela retorna &false; se n�o existem mais linhas.
</para>
<para>
<function>pg_fetch_array</function> � uma vers�o extendida de
<function>pg_fetch_row</function>. Al�m de armazenar os dados em �ndices
num�ricos (index de campo) na array de resultado, ela tamb�m armazena os
dados em �ndices associativos (nome do campo) por padr�o.
</para>
<para>
<parameter>linha</parameter> � o n�mero da linha (registro) a ser
recuperado. A primeira linha � 0.
</para>
<para>
<parameter>tipo_de_resultado</parameter> � um par�metro opicional que
controla como o valor de retorno � iniciado
<parameter>tipo_de_resultado</parameter> � uma constante e pode ter os
seguintes valores: PGSQL_ASSOC, PGSQL_NUM, e PGSQL_BOTH.
<function>pg_fetch_array</function> retorna uma array associativa que tem
o nome de campo como chave para PGSQL_ASSOC. Index de campo como chave
com PGSQL_NUM e ambos nome/index como chave com PGSQL_BOTH. O valor
padr�o � PGSQL_BOTH.
<note>
<para>
<parameter>tipo_de_resultado</parameter> foi adicionado no PHP 4.0.
</para>
</note>
</para>
<para>
<function>pg_fetch_array</function> N�O � significativamente mais lento
do que usar <function>pg_fetch_row</function>, enquanto ele fornece uma
significativa facilidade de uso.
</para>
<para>
Veja tamb�m <function>pg_fetch_row</function> e
<function>pg_fetch_object</function> e
<function>pg_fetch_result</function>.
</para>
<para>
<example>
<title>PostgreSQL fetch array</title>
<programlisting role="php">
<![CDATA[
<?php
$conn = pg_pconnect ("dbname=publicar");
if (!$conn) {
echo "Um erro ocorreu.\n";
exit;
}
$result = pg_query ($conn, "SELECT * FROM autores");
if (!$result) {
echo "Um erro ororreu.\n";
exit;
}
$arr = pg_fetch_array ($result, 0, PGSQL_NUM);
echo $arr[0] . " <- array\n";
$arr = pg_fetch_array ($result, 1, PGSQL_ASSOC);
echo $arr["autor"] . " <- array\n";
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
A partir do PHP 4.1.0, <parameter>linha</parameter> tornou-se opcional.
A chamada <function>pg_fetch_array</function> ir� incrementar o contador
de linha interno em 1.
</para>
</note>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-object.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-object.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.6 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-fetch-object">
<refnamediv>
<refname>pg_fetch_object</refname>
<refpurpose>Pega uma linha como um objeto</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>objeto</type><methodname>pg_fetch_object</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>linha</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>tipo_de_resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_fetch_object</function> retorna um objeto com propriedades
que correspondem � linha pega. Ele retorna &false; se n�o existem mas
linhas ou no caso de um erro.
</para>
<para>
<function>pg_fetch_object</function> � similar a
<function>pg_fetch_array</function>, com uma diferen�a - um objeto �
retornado, ao inv�s de uma array. Indiretamente, isto significa que voc�
pode acessar os dados somente atrav�s dos nomes de campos, e n�o por seus
deslocamentos (n�meros s�o nomes inv�lidos de propriedades).
</para>
<para>
<parameter>linha</parameter> � o n�mero da linha (registro) a ser
recuperada. A primeira linha � 0.
</para>
<para>
No tocante a velocidade, a fun��o � identica a
<function>pg_fetch_array</function>, e quase t�o r�pida quando
<function>pg_fetch_row</function> (a diferen�a � insignificante).
</para>
<note>
<para>
A partir do PHP 4.3.0, <parameter>tipo_de_resultado</parameter> � padr�o
para PGSQL_ASSOC enquanto em outras vers�es mais antigas o padr�o era
PGSQL_BOTH. N�o h� utilidade para a propriedade num�rica, j� que
nomes de propriedades num�ricas s�o inv�lidas em PHP.
</para>
<para>
<parameter>tipo_de_resultado</parameter> pode ser deletado em vers�es
futuras.
</para>
</note>
<para>
Veja tamb�m <function>pg_query</function>, <function>pg_fetch_array</function>,
<function>pg_fetch_row</function> e <function>pg_fetch_result</function>.
</para>
<para>
<example>
<title>Postgres fetch object</title>
<programlisting role="php">
<![CDATA[
<?php
$database = "verlag";
$db_conn = pg_connect ("host=localhost port=5432 dbname=$database");
if (!$db_conn): ?>
<H1>Falha ao conectar com o banco de dados PostgreSQL <?php echo $database ?></H1>
<?php
exit;
endif;
$qu = pg_query ($db_conn, "SELECT * FROM verlag ORDER BY autor");
$row = 0; // postgres precisa de um contador de linha, outros dbs talvez n�o precisem
while ($data = pg_fetch_object ($qu, $row)) {
echo $data->autor." (";
echo $data->jahr ."): ";
echo $data->titel."<BR>";
$row++;
}
?>
<PRE>
<?php
$fields[] = Array ("autor", "Autor");
$fields[] = Array ("jahr", " Ano");
$fields[] = Array ("titel", " T�tulo");
$row= 0;
while ($data = pg_fetch_object ($qu, $row)) {
echo "----------\n";
reset ($fields);
while (list (,$item) = each ($fields)):
echo $item[1].": ".$data->$item[0]."\n";
endwhile;
$row++;
}
echo "----------\n";
?>
</PRE>
<?php
pg_free_result ($qu);
pg_close ($db_conn);
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
A partir do PHP 4.1.0, <parameter>linha</parameter> tornou-se opcional.
Ao chamar <function>pg_fetch_object</function> o contador de linhas
interno ser� acrescentado de 1.
</para>
</note>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-result.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-result.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id="function.pg-fetch-result">
<refnamediv>
<refname>pg_fetch_result</refname>
<refpurpose>Retorna valores a partir de um recurso de resultado</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>misto</type><methodname>pg_fetch_result</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>linha</parameter></methodparam>
<methodparam><type>misto</type><parameter>campo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_fetch_result</function> retorna valores a partir de um
recurso de <parameter>resultado</parameter> retornado por
<function>pg_query</function>. <parameter>linha</parameter> � inteiro.
<parameter>campo</parameter> � um nome de campo (string) ou um index de
campo (inteiro). A <parameter>linha</parameter> e
<parameter>campo</parameter> especificam que c�lula da tabela deve ser
retornada. A numera��o de linhas come�a em 0. Ao inv�s de nomear o campo,
voc� pode usar o index de campo sem aspas. �ndices de campo iniciam-se em
0.
</para>
<para>
PHP tem muitos tipos internos e apenas os tipos b�sicos s�o suportados
aqui. Todas as formas de tipo <type>inteiro</type>, <type>booleano</type> e
<type>vazio</type> s�o retornadas como valores <type>inteiro</type>.
Todas as formas de float e tipos reais s�o retornados como valores
<type>float</type>. Todos os outros tipos, incluindo arrays, s�o
retornados como strings formatadas na mesma maneira padr�o que o
PostgreSQL retornaria com o programa <command>psql</command>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-row.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-fetch-row.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-fetch-row">
<refnamediv>
<refname>pg_fetch_row</refname>
<refpurpose>Pega uma linha como um array enumerado</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>array</type><methodname>pg_fetch_row</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>linha</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_fetch_row</function> pega uma linha de dados a partir do
resultado associado com o recurso <parameter>resultado</oarameter>
especificado. A linha (registro) � retornada como um array. Cada coluna
do resultado � armazenado em um deslocamento de array, iniciando-se no
deslocamento 0.
</para>
<para>
Ela retorna um array que corresponde � linha pega, ou &false; se n�o
existem mais linhas.
</para>
<para>
Veja tamb�m: <function>pg_query</function>,
<function>pg_fetch_array</function>,
<function>pg_fetch_object</function> e
<function>pg_fetch_result</function>.
</para>
<para>
<example>
<title>Pega linha Postgres</title>
<programlisting role="php">
<![CDATA[
<?php
$conn = pg_pconnect ("dbname=publicar");
if (!$conn) {
echo "Um erro ocorreu.\n";
exit;
}
$result = pg_query ($conn, "SELECT * FROM autores");
if (!$result) {
echo "Um erro ocorreu.\n";
exit;
}
$num = pg_num_rows($result);
for ($i=0; $i < $num; $i++) {
$r = pg_fetch_row($result, $i);
for ($j=0; $j < count($r); $j++) {
echo "$r[$j] ";
}
echo "<BR>";
}
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
A partir do PHP 4.1.0, <parameter>linha</parameter> tornou-se opcional.
Ao chamar <function>pg_fetch_row</function> o contador de linha
interno ser� acrescentado em 1.
</para>
</note>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-field-is-null.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-field-is-null.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-field-is-null">
<refnamediv>
<refname>pg_field_is_null</refname>
<refpurpose>Testa se o campo � &null;</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_field_is_null</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>linha</parameter></methodparam>
<methodparam><type>misto</type><parameter>campo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_is_null</function> testa se um campo � &null; ou n�o.
Ela retorna 1 se o campo na linha dada � &null;. Ela retorna 0 se o campo
na linha dada � N�O &mull;. O campo pode ser especificado como um �ndice
de coluna (n�mero) ou como o nome de um campo (string). A numera��o de
linhas inicia-se em 0.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_fieldisnull()</literal>.
</para>
</note>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-field-name.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-field-name.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-field-name">
<refnamediv>
<refname>pg_field_name</refname>
<refpurpose>Retorna o nome do campo</refpurpose>
</refnamediv>
<refsect1>
<title>Decri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_field_name</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>numero_de_campo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_name</function> retorna o nome do campo ocupando o
<parameter>numero_de_campo</parameter> dado no recurso de
<parameter>resultado</parameter> PostgreSQL dado. A numera��o de campo
inicia-se em 0.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_fieldname()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_field_num</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-field-num.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-field-num.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-field-num">
<refnamediv>
<refname>pg_field_num</refname>
<refpurpose>Retorna o numero do campo referido</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_field_num</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_de_campo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_num</function> ir� retornar o n�mero da vaga (slot) da
coluna (campo) que corresponde ao <parameter>nome_de_campo</parameter>
no recurso de <parameter>resultado</parameter> PostgreSQL dado. A
numera��o de campo inicia-se em 0. Esta fun��o retornar� -1 em caso de
erro.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_fieldnum()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_field_name</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-field-prtlen.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-field-prtlen.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-field-prtlen">
<refnamediv>
<refname>pg_field_prtlen</refname>
<refpurpose>Retorna o comprimento impresso</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_field_prtlen</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>numero_de_linha</parameter></methodparam>
<methodparam><type>string</type><parameter>numero_de_campo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_prtlen</function> o comprimento atual impresso (n�mero
de caracteres) de um valor especificado em um
<parameter>resultado</parameter> PostgreSQL. A numera��o de linha
inicia-se em 0. Esta fun��o retornar� -1 em caso de erro.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_field_prtlen()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_field_size</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-field-size.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-field-size.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-field-size">
<refnamediv>
<refname>pg_field_size</refname>
<refpurpose>
Retorna o tamanho de amrazenamento interno do campo denominado.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_field_size</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>numero_de_capo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_size</function> retorna o tamanho de armazenamento
interno (em bytes) do n�mero de campo no <parameter>resultado</parameter>
PostgrerSQL dado. A numera��o de campo inicia-se em 0. Um campo de
tamanho -1 indica um campo de tamanho vari�vel. Esta fun��o retornar�
&false; em caso de erro.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_fieldsize()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_field_len</function> e
<function>pg_field_type</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-field-type.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-field-type.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.52 -->
<refentry id="function.pg-field-type">
<refnamediv>
<refname>pg_field_type</refname>
<refpurpose>
Retorna o nome do tipo para o campo de nome correspondente
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_field_type</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
<methodparam><type>int</type><parameter>numero_de_campo</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_type</function> retorna uma string contendo o nome do
tipo do <parameter>numero_de_campo</parameter> dado no recurso de
<parameter>resultado</parameter> PostgreSQL dado. A numera��o de campo
inicia-se em 0.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_field_type()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_field_len</function> e
<function>pg_field_name</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-free-result.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-free-result.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-free-result">
<refnamediv>
<refname>pg_free_result</refname>
<refpurpose>Libera a mem�ria usada pelo resultado</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_free_result</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_free_result</function> necessita ser usada apenas se voc�
est� preocupoado em usar muita mem�ria enquanto seu script est� rodando.
Todos os resultados ser�o liberados da mem�ria nautomaticamente assim que
o script terminar de executar. Mas, se voc� tem certeza que n�o precisar�
mais dos dados do resultado em um script, voc� pode chamar
<function>pg_free_result</function> com o recurso
<parameter>resultado</parameter> como um argumento e a mem�ria ocupada
pelo resultado associado ser� liberada. Ele retorna &true; se houver
sucesso e &false; se um erro ocorrer.
<!-- NOTE:
No ingles os aliases &true; e &false; n�o s�o usados, mas
como tem sido pr�tica o uso desses aliases, eu os substitu� aqui.
Caso haja algum erro por favor retorne.
-->
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_field_len()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_query</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-get-result.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-get-result.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 -->
<refentry id='function.pg-get-result'>
<refnamediv>
<refname>pg_get_result</refname>
<refpurpose>
Pega o resultado de um pedigo ass�ncrono
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>recurso</type><methodname>pg_get_result</methodname>
<methodparam
choice="opt"><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_get_result</function> pega o recurso de resultado de um
pedido (query) executado por <function>ps_send_query</function>.
<function>pg_send_query</function> pode enviar m�ltiplos pedidos ao
servidor PostgreSQL e <function>pg_get_result</function> � usado para
pegar os resultados dos pedidos de um por um. Ele retorna o recurso de
resultado. Se n�o houverem mais resultados ele retorna &false;.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-host.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-host.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-host">
<refnamediv>
<refname>pg_host</refname>
<refpurpose>
Retorna o nome da m�quina associada com a conex�o
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_host</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_host</function> retorna o nome da m�quina a qual o recurso de
<parameter>conex�o</parameter> PostgreSQL est� conectado.
</para>
<para>
Veja tamb�m <function>pg_connect</function> e
<function>pg_pconnect</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-insert.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-insert.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.4 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 -->
<refentry id='function.pg-insert'>
<refnamediv>
<refname>pg_insert</refname>
<refpurpose>
Insere um array na tabela.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_insert</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_da_tabela</parameter></methodparam>
<methodparam><type>array</type><parameter>array_associativa</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>op��es</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_insert</function> insere a
<literal>array_associativa</literal> que tem
<literal>campo=>valor</literal> dentro da tabela especificada por
<literal>nome_da_tabela. Se <literal>op��es</literal> � especificada,
<function>pg_convert</function> � aplicada �
<literal>array_associativa</literal> com a op��o especificada.
</para>
<example>
<title>pg_insert</title>
<programlisting role="php">
<![CDATA[
<?php
$db = pg_connect ('dbname=fernanda');
// This is safe, since $_POST is converted autotmatically
$res = pg_insert($db, 'post_log', $_POST);
if ($res) {
echo "Dados POST arquivados com sucesso\n";
}
else {
echo "O usu�rio deve ter inserido entradas inv�lidas\n";
}
?>
]]>
</programlisting>
</example>
<note>
<para>
Essa fun��o � experimental.
</para>
</note>
<para>
Veja tamb�m <function>pg_convert</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-last-error.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-last-error.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-last-error">
<refnamediv>
<refname>pg_last_error</refname>
<refpurpose>Pega a string da �ltima mensagem de erro de uma conex�o</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_last_error</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_last_error</function> retorna a �ltima mensagem de erro para
a <parameter>conex�o</parameter> dada.
</para>
<para>
As mensagens de erro podem ser sobescritas por chamadas internas ao
PostgreSQL(libpq). Se m�ltiplos erros ocorrem dentro de um m�dulo de
fun��o PostgreSQL, ele pode n�o retornar o erro correto.
</para>
<para>
Use <function>pg_result_error</function>,
<function>pg_result_status</function> e
<function>pg_connection_status</function> para um melhor tratamento de
erros.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_errormessage()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_result_error</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-last-notice.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-last-notice.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id="function.pg-last-notice">
<refnamediv>
<refname>pg_last_notice</refname>
<refpurpose>
Retorna a �ltima mensagem de nota do servidor PostgreSQL
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_last_notice</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_last_notice</function> retorna a �ltima mensagem de nota do
servidor PostgreSQL especificada por <parameter>conex�o</parameter>. O
servidor PostgreSQL envia notas em diversas situa��es, por exemplo, se as
transa��es n�o puderem continuar. Com <function>pg_last_notice</function>
voc� pode evitar a chamada de pedidos (queries) in�teis, checando quando
a nota est� relacionada ou n�o com a transa��o.
</para>
<warning>
<para>
Esta fun��o � EXPERIMENTAL e ainda n�o est� completamente implementada.
<function>pg_last_notice</function> foi adicionada no PHP 4.0.6.
Entretanto o PHP 4.0.6 tem problemas com a manipula��o de mensagens. O
uso do m�dulo PostgreSQL com o PHP 4.0.6 n�o � recomendada, mesmo se
voc� n�o estiver usando <function>pg_last_notice</function>.
</para>
<para>
Esta fun��o � totalmente implementada no PHP 4.3.0Esta fun��o �
totalmente implementada no PHP 4.3.0. PHPs mais recentes que o 4.3.0
ignoram o par�metro de conex�o com o banco de dados.
</para>
</warning>
<para>
O rastreamento de mensagens de nota pode ser definido como opcional
definindo 1 para <literal>pgsql.ignore_notice</literal> ini do PHP 4.3.0.
</para>
<para>
O arquivamento (log) de mensagems pode ser pode ser definido como
opcional mudando para 0 a diretina ini
<literal>pgsql.log_notice</literal> no PHP 4.3.0. A n�o ser que
<literal>pgsql.ignore_notice</literal> estiver definida para 0, mensagens
de notas n�o podem ser arquivadas.
</para>
<para>
Veja tamb�m <function>pg_query</function> e
<function>pg_last_error</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-last-oid.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-last-oid.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id="function.pg-last-oid">
<refnamediv>
<refname>pg_last_oid</refname>
<refpurpose>Retorna o ultimo oid do objeto</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_last_oid</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_last_oid</function> � usado para recuperar o
<varname>oid</varname> designado a uma linha (registro) se o recurso de
resultado � usado a partir do �ltimo comando enviado atrav�s de
<function>pq_query</function> se este comando era um INSERT SQL. Retorna um
inteiro
positivo se havia um <varname>oid</varname> v�lido. Ela retorna &false;
se um erro ocorrer ou o �ltimo comando enviado atrav�s de
<function>pg_query</function> n�o era INSERT ou se o INSERT falhou.
</para>
<para>
Campo OID tornou-se opcional a partir do PostgreSQL 7.2. Quando um campo
OID n�o � definido em uma tabela, o programador deve usar
<function>pg_result_status</function> para checar se o registro foi
inserido com sucesso ou n�o.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_getlastoid()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_query</function> e
<function>pg_result_status</function>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-lo-close.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-lo-close.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-lo-close">
<refnamediv>
<refname>pg_lo_close</refname>
<refpurpose>Fecha um objeto grande</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_lo_close</methodname>
<methodparam><type>recurso</type><parameter>objeto_grande</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_lo_close</function> fecha um Objeto Grande (Large Object,
da� vem o "lo" que integra o nome da fun��o).
<parameter>large_object</parameter> � um recurso para o objeto grande a
partir de <function>pg_lo_open</function>.
</para>
<para>
Para usar a interface de objetos grandes, � necess�rio encapsul�-lo
dentro de um bloco de transa��o.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_loclose()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_lo_open</function>,
<function>pg_lo_create</function> e
<function>pg_lo_import</function>.
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-lo-create.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-lo-create.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-lo-create">
<refnamediv>
<refname>pg_lo_create</refname>
<refpurpose>Cria um objeto grande</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_lo_create</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_lo_create</function> cria um Objeto Grande e retorna o
<varname>oid</varname> do objeto grande. <parameter>conex�o</parameter>
especifica uma conex�o a um banco de dados v�lida aberta por
<function>pg_connect</function> ou <function>pg_pconnect</function>. Os
modos de acesso INV_READ, INV_WRITE e INV_ARCHIVE n�o s�o suportados, o
objeto � criando sempre tando como o acesso a leitura como o acesso para
escrita. INV_ARCHIVE foi removido do pr�prio PostgreSQL (6.3 adiante).
Ele retorna o oid do objeto. Retorna &false; se um erro ocorrer.
</para>
<para>
Para usar a interface de objetos grandes, � necess�rio encapsula-lo
dentro de um bloco de transa��o.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_locreate()</literal>.
</para>
</note>
</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
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-lo-export.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-lo-export.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.6 -->
<refentry id="function.pg-lo-export">
<refnamediv>
<refname>pg_lo_export</refname>
<refpurpose>Exporta um objeto grande para um arquivo</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_lo_export</methodname>
<methodparam><type>int</type><parameter>oid</parameter></methodparam>
<methodparam><type>string</type><parameter>caminho</parameter></methodparam>
<methodparam
choice="opt"><type>recurso</type><parameter>conx�o</parameter></methodparam>
</methodsynopsis>
<para>
O argumento <parameter>oid</parameter> especifica o oid do objeto grande
a exportar e o argumento <parameter>caminho</parameter> especifica o
caminho at� o arquivo. Ela retorna &false; se um erro ocorrer, caso
contr�rio retorna &true;.
</para>
<para>
Para usar a interface de objetos grandes, � necess�rio encapsula-lo
dentro de um bloco de transa��o.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_loexport()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_lo_import</function>.
</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
-->
