phaser Wed May 15 15:32:18 2002 EDT
Added files:
/phpdoc-pt_BR/reference/pgsql/functions pg-metadata.xml
pg-num-fields.xml
pg-num-rows.xml
pg-options.xml
pg-pconnect.xml pg-port.xml
pg-put-line.xml
pg-query.xml
pg-result-error.xml
pg-result-status.xml
pg-select.xml
pg-send-query.xml
pg-set-client-encoding.xml
pg-trace.xml pg-tty.xml
pg-untrace.xml
pg-update.xml
Log:
1st pt_BR version
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-metadata.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-metadata.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-metadata'>
<refnamediv>
<refname>pg_metadata</refname>
<refpurpose>
Pega os metadados da tabela.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>array</type><methodname>pg_metadata</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_da_tabela</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_metadata</function> retorna a defini��o da tabela para o
<literal>nome_da_tabela</literal> como um array. Se houiver algum erro
ele retorna &false;.
</para>
<note>
<para>
Esta 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-num-fields.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-num-fields.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-num-fields">
<refnamediv>
<refname>pg_num_fields</refname>
<refpurpose>Retorna o n�mero de campos</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_num_fields</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_num_fields</function> retorna o n�mero de campos (colunas)
em um <parameter>resultado</parameter> PostgreSQL. O argumento � um
recurso de resultado que � retornado de <function>pg_query</function>.
Esta fun��o ir� retornar -1 em caso de erro.
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_numfields()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_num_rows</function> e
<function>pg_affected_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-num-rows.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-num-rows.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-num-rows">
<refnamediv>
<refname>pg_num_rows</refname>
<refpurpose>Retorna o numero de linhas</refpurpose>
</refnamediv>
<refsect1>
<title>Decri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_num_rows</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_num_rows</function> ir� retornar o n�mero de linhas em um
recurso de <parameter>resultado</parameter> de PostgreSQL.
<parameter>resultado</parameter> � um recurso de resultado de pedido
feito por <function>pg_query</function>. Esta fun��o retornar� -1 em caso
de erro.
</para>
<note>
<para>
Use <function>pg_affected_rows</function> para obter o n�mero de linhas
afetadas por pedidos INSERT, UMPDATE e DELETE.
</para>
</note>
<note>
<para>
Esta fun��o era chamada <literal>pg_numrows()</literal>.
</para>
</note>
<para>
Veja tamb�m <function>pg_num_fields</function> e
<function>pg_affected_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-options.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-options.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-options">
<refnamediv>
<refname>pg_options</refname>
<refpurpose>Pega as op��es associadas com a conex�o</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_options</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_options</function> retornar� uma string contendo as op��es
especificadas no recurso de <parameter>conex�o</parameter> PostgreSQL
dado.
</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-pconnect.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-pconnect.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
<refentry id="function.pg-pconnect">
<refnamediv>
<refname>pg_pconnect</refname>
<refpurpose>Abre uma conex�o PostgreSQL persistente</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_pconnect</methodname>
<methodparam><type>string</type><parameter>string_de_conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_pconnect</function> abre uma conex�o a um banco de dados
PostgreSQL. Ela retorna um recurso de conex�o que � necess�ria para
outras fun��es PostgreSQL.
</para>
<para>
Para uma descri��o do par�metro <parameter>string_de_conex�o</parameter>
veja <function>pg_connect</function>.
</para>
<para>
Para habilitar uma conex�o persistente a diretiva <link
linkend="ini.pgsql.allow-persistent">pgsql.allow_persistent</link>
&php.ini; deve ser definida para "On" (que � o padr�o).
O n�mero m�ximo de conex�es persistentes pode ser definida com a diretiva <link
linkend="ini.pgsql.max-persistent">pgsql.max_persistent</link>
&php.ini; (o padr�o � -1 para sem limite). O n�mero total de conex�es
pode ser definido com a diretiva <link linkend="ini.pgsql.max-links">
pgsql.max_links</link> &php.ini;.
</para>
<para>
<function>pg_close</function> n�o fechar� links persistentes gerados por
<function>pg_pconnect</function>.
</para>
<para>
Veja tamb�m <function>pg_connect</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-port.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-port.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.20 -->
<refentry id="function.pg-port">
<refnamediv>
<refname>pg_port</refname>
<refpurpose>
Retorna o n�mero da porta associada com a conex�o.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_port</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_port</function> retorna o n�mero da porta a qual o recurso
de <parameter>conex�o</parameter> PostgreSQL dado est� conectado.
</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-put-line.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-put-line.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.20 -->
<refentry id="function.pg-put-line">
<refnamediv>
<refname>pg_put_line</refname>
<refpurpose>Envia uma string terminada em NULL para o backend
PostgreSQL</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_put_line</methodname>
<methodparam
choice="opt"><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>dados</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_put_line</function> envia uma string terminada em NULL para
o servidor backend PostgreSQL. Isso � �til, por exemplo, para a inser��o
de dados em uma tabela em alta velocidade, iniciada atrav�s de uma
opera��o de c�pia PostgreSQL. O caractere NULL final � adicionado
automaticamente. &return.success;
</para>
<note>
<para>
A aplica��o deve enviar os dois caracteres "\." explicitamente na �ltima
linha para indicar ao backend que ela terminou de enviar seus dados.
</para>
</note>
<para>
Veja tamb�m <function>pg_end_copy</function>.
<example>
<title>Inser��o de dados na tabela em alta velocidade</title>
<programlisting role="php">
<![CDATA[
<?php
$conn = pg_pconnect ("nomebd=flavia");
pg_query($conn, "create table bar (a int4, b char(16), d float8)");
pg_query($conn, "copy bar from stdin");
pg_put_line($conn, "3\tola mundo\t4.5\n");
pg_put_line($conn, "4\ttchau mundo\t7.11\n");
pg_put_line($conn, "\\.\n");
pg_end_copy($conn);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc-pt_BR/reference/pgsql/functions/pg-query.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-query.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.3 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry id="function.pg-query">
<refnamediv>
<refname>pg_query</refname>
<refpurpose>Executa um pedido(query)</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>recurso</type><methodname>pg_query</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>pedido</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_query</function> retorna um recurso de resultado do pedido
se o pedido puder ser executado. Ela retorna &false; em caso de falha ou
se a conex�o n�o � uma conex�o v�lida. detalhes sobre o erro podem ser
recuperados usando a fun��o <function>pg_last_error</function> se a
conex�o � v�lida. <function>pg_last_error</function> envia uma declara��o
SQL para o banco de dados PostgreSQL especificado pelo recurso de
<parameter>conex�o</parameter>. A <parameter>conex�o</parameter> deve ser
uma conex�o v�lida que foi retornada por <function>pg_connect</function>.
O valor de retorno dessa fun��o � um
recurso de resultado do pedido para ser usado para acessar os resultados
de outras fun��es PostgreSQL como <function>pg_fetch_array</function>.
<note>
<simpara>
<parameter>conex�o</parameter> � um par�metro opcional para
<function>pg_query</function>. Se a <parameter>conex�o</parameter> n�o
for definida, a conex�o padr�o ser� usada. A conex�o padr�o � a �ltima
conex�o feita por <function>pg_connect</function> ou
<function>pg_pconnect</function>.
</simpara>
<simpara>
Apesar de <parameter>conex�o</parameter> poder ser omitida, isso n�o �
recomendado j� que pode ser uma causa de um erro dif�cil de encontrar
no seu script.
</simpara>
</note>
</para>
<note>
<para>
Esta fun��o era chamada <literal>pg_exec()</literal>.
<literal>pg_exec()</literal> ainda est� dispon�vel por raz�es de
compatibilidade mas os usu�rios s�o encorajados a usar o novo nome.
</para>
</note>
<para>
Veja tamb�m <function>pg_connect</function>,
<function>pg_pconnect</function>,
<function>pg_fetch_array</function>,
<function>pg_fetch_object</function>,
<function>pg_num_rows</function>,
e <function>pg_affected_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-result-error.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-result-error.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-result-error'>
<refnamediv>
<refname>pg_result_error</refname>
<refpurpose>
Pega a mensagem de erro associada com o resultado
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_result_error</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_result_error</function> retorna a mensagem de erro associaca
ao recurso <parameter>resultado</parameter>. Desse modo o usu�rio tem
melhores chances de ter uma mensagem de erro melhor que a retornada por
<function>pg_last_error</function>.
</para>
<para>
Veja tamb�m <function>pg_query</function>,
<function>pg_send_query</function>,
<function>pg_get_result</function>,
<function>pg_last_error</function> e
<function>pg_last_notice</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-result-status.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-result-status.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-result-status'>
<refnamediv>
<refname>pg_result_status</refname>
<refpurpose>
Pega o status do resultado do pedido(query)
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_result_status</methodname>
<methodparam><type>recurso</type><parameter>resultado</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_result_status</function> retorna o resultado do recurso de
resultadpo. Os valores de retorno poss�veis s�o: PGSQL_EMPTY_QUERY,
PGSQL_COMMAND_OK, PGSQL_TUPLES_OK, PGSQL_COPY_TO,
PGSQL_COPY_FROM, PGSQL_BAD_RESPONSE, PGSQL_NONFATAL_ERROR e
PGSQL_FATAL_ERROR.
</para>
<para>
Veja tamb�m <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-select.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-select.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.80 -->
<refentry id='function.pg-select'>
<refnamediv>
<refname>pg_select</refname>
<refpurpose>
Seleciona registros.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>array</type><methodname>pg_select</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_select</function> seleciona registros especificados por
<literal>array_associativa</literal> que cont�m
<literal>campo=>valor</literal>. Para um pedido v�lido, ele retorna um
array que cont�m todos os registros e campos que combinam com a condi��o
especificada por <literal>array_associativa</literal>. Se as
<literal>op��es</literal> forem especificadas,
<function>pg_convert</function> � aplicada �
<literal>array_associativa</literal> com as op��es especificadas.
</para>
<example>
<title>pg_select</title>
<programlisting role="php">
<![CDATA[
<?php
$db = pg_connect ('nomebd=flavia');
// Isto � seguro j� que $_POST � convertida automaticamente
$rec = pg_select($bd, 'post_log', $_POST);
if ($rec) {
echo "Registros selecionados\n";
var_dump($rec);
}
else {
echo "O usu�rio deve ter inserido dados errados\n";
}
?>
]]>
</programlisting>
</example>
<note>
<para>
Esta 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-send-query.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-send-query.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-send-query'>
<refnamediv>
<refname>pg_send_query</refname>
<refpurpose>
Envia um pedido assincrono
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_send_query</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>pedido</parameter></methodparam>
</methodsynopsis>
<methodsynopsis>
<type>bool</type><methodname>pg_send_query</methodname>
<methodparam><type>string</type><parameter>pedido</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_send_query</function> envia um pedido ass�ncrono para a
<parameter>conex�o</parameter>. Diferente de
<function>pg_query</function>, ela pode enviar pedidos m�ltiplos para o
PostgreSQL e pegar os resultados, um por um, usando
<function>pg_get_result</function>. A execu��o do script n�o � bloqueada
enquando os pedidos est�o sendo executados. Use
<function>pg_connection_busy</function> para checar se a conex�o est�
ocupada. (por exemplo, se um pedido est� sendo executado). O pedido pode
ser cancelado chamando-se <function>pg_cancel_query</function>.
</para>
<para>
Apesar de voc� poder enviar multiplos pedidos de uma vez, voc� n�o pode
enviar multiplos pedidos por uma conex�o osupada. Se o pedido � enviado
enquando a conex�o est� ocupada ele espera at� que o �ltimo pedido seja
finalizado e descarta todos os resultados.
</para>
<para>
Veja tamb�m <function>pg_query</function>,
<function>pg_cancel_query</function>,
<function>pg_get_result</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-set-client-encoding.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-set-client-encoding.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.16 -->
<refentry id="function.pg-set-client-encoding">
<refnamediv>
<refname>pg_set_client_encoding</refname>
<refpurpose>
Define a codifica��o do cliente
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>int</type><methodname>pg_set_client_encoding</methodname>
<methodparam
choice="opt"><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>codifica��o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_set_client_encoding</function> define a codifica��o do
cliente e retorna 0 caso hjaja sucesso e -1 se houver erro.
</para>
<para>
<parameter>codifica��o</parameter> � a codifica��o do cliente e pode ter
os valores: SQL_ASCII, EUC_JP, EUC_CN, EUC_KR, EUC_TW, UNICODE,
MULE_INTERNAL, LATINX (X=1...9), KOI8, WIN, ALT, SJIS, BIG5,
WIN1250. As codifica��es dispon�veis dependem da vers�o do seu
PostgreSQL e libpq. Vide o manual PostgreSQL para saber das codifica��es
dispon�veis para o seu PostgreSQL.
</para>
<note>
<para>
Esta fun��o exige o PHP 4.0.3 ou maior e PostgreSQL 7.0 ou maior. As
codifica��es suportadas dependem da vers�o do PostgreSQL. Vide o manual
PostgreSQL para detalhes.
</para>
<para>
Esta fun��o era chamada <function>pg_setclientencoding</function>.
</para>
</note>
<para>
Veja tamb�m <function>pg_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-trace.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-trace.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: phaser Status: ready -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.7 -->
<refentry id="function.pg-trace">
<refnamediv>
<refname>pg_trace</refname>
<refpurpose>Habilita restreamento em uma conex�o PostgreSQL</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_trace</methodname>
<methodparam><type>string</type><parameter>caminho</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>modo</parameter></methodparam>
<methodparam
choice="opt"><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_trace</function> habilita o rastreamento da comunica��o
frontend/backend do PostgreSQL para um arquivo de depura��o especificado
como <parameter>caminho</parameter>. Para entender completamente eestes
resultados, voc� deve estar familiarizado com o protocolo de comunica��o
interno do PostgreSQL. Para aqueles que n�o est�o, isso ainda pode ser
�til para rastrear erros em pedidos enviados ao servidor, voc� poderia
fazer por exemplo <command>grep '^Para backend' rastro.log</command>.
Para maiores informa��es vide o manual PostgreSQL.
</para>
<para>
<parameter>Nome_de_arquivo</parameter> e <parameter>modo</parameter>
s�o os mesmos que na fun��o <function>fopen</function>
(o <parameter>modo</parameter> padr�o � 'w'),
<parameter>conex�o</parameter> especifica a conex�o a ser rastreada e seu
padr�o � a �ltima conex�o aberta.
</para>
<para>
Ela retorna &true; se o <parameter>caminho</parameter> pode ser aberto
para ser escrito, &false; caso contr�rio.
</para>
<para>
Veja tamb�m <function>fopen</function> e
<function>pg_untrace</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-tty.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-tty.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-tty">
<refnamediv>
<refname>pg_tty</refname>
<refpurpose>
Retorna o nome da tty associada com a conex�o
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>string</type><methodname>pg_tty</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_tty</function> retorna o nome da tty que a sa�da do lado do
servidor � enviada no recurso <parameter>conex�o</parameter> PostgreSQL
dado.
</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-untrace.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-untrace.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-untrace">
<refnamediv>
<refname>pg_untrace</refname>
<refpurpose>Desabilita o rastreamento de uma conex�o PostgreSQL</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>bool</type><methodname>pg_untrace</methodname>
<methodparam
choice="opt"><type>recurso</type><parameter>conex�o</parameter></methodparam>
</methodsynopsis>
<para>
Para o rastreamento iniciado por <function>pg_trace</function>.
<parameter>conex�o</parameter> especifica a conex�o que est� sendo
rastreada e seu padr�o � a �ltima conex�o aberta.
</para>
<para>
Sempre retorna &true;.
</para>
<para>
Veja tamb�m <function>pg_trace</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-update.xml
+++ phpdoc-pt_BR/reference/pgsql/functions/pg-update.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.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-update'>
<refnamediv>
<refname>pg_update</refname>
<refpurpose>
Atualiza a tabela.
</refpurpose>
</refnamediv>
<refsect1>
<title>Descri��o</title>
<methodsynopsis>
<type>long</type><methodname>pg_update</methodname>
<methodparam><type>recurso</type><parameter>conex�o</parameter></methodparam>
<methodparam><type>string</type><parameter>nome_de_tabela</parameter></methodparam>
<methodparam><type>array</type><parameter>condi��o</parameter></methodparam>
<methodparam><type>array</type><parameter>dados</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>op��es</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_update</function> atualiza registros que combinam com a
<literal>condi��o</literal> com os <literal>dados</literal>. Se as
<literal>op��es</literal> s�o especificadas,
<function>pg_convert</function> � aplicada a
<literal>array_associativa</literal> com as op��es especificadas.
</para>
<example>
<title>pg_update</title>
<programlisting role="php">
<![CDATA[
<?php
$bd = pg_connect ('dbname=mariana');
$dados = array('campo1'=>'AA', 'campo2'=>'BB');
// Isto � seguro j� que $_POST � convertido automaticamente
$res = pg_update($bd, 'post_log', $_POST, $dados);
if ($res) {
echo "Dados atualizados: $res\n";
}
else {
echo "Usu�rio deve ter enviado entradas inv�lidas\n";
}
?>
]]>
</programlisting>
</example>
<note>
<para>
Esta 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
-->
