<strings>
<string id="pg_version" value="<div id='function.pg-version' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-version.php'>pg_version</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>pg_version</span> &amp;mdash; <span class='dc-title'> Returns an array with client, protocol and server version (when available) </span></p> </div> <a name='function.pg-version.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_version</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_version()</b> returns an array with the client, protocol and server version. Protocol and server versions are only available if PHP was compiled with PostgreSQL 7.4 or later. </p> <p class='para'> For more detailed server information, use <a href='http://www.php.net/manual/pt_BR/function.pg-parameter-status.php' class='function'>pg_parameter_status()</a>. </p> </div> <a name='function.pg-version.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-version.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an array with <i>client</i>, <i>protocol</i> and <i>server_version</i> keys and values (if available). Returns <b><tt class='constant'>FALSE</tt></b> on error or invalid connection. </p> </div> <a name='function.pg-version.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_version()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'host=localhost&amp;nbsp;port=5432&amp;nbsp;dbname=mary'</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$v&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_version</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$v</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'client'</span><span style='color: #007700'>];<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 7.4 </pre></div> </div> </div><p> </p> </div> <a name='function.pg-version.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-parameter-status.php' class='function' rel='rdfs-seeAlso'>pg_parameter_status()</a> - Looks up a current parameter setting of the server.</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_update" value="<div id='function.pg-update' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-update.php'>pg_update</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_update</span> &amp;mdash; <span class='dc-title'> Atualiza uma tabela. </span></p> </div> <a name='function.pg-update.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>pg_update</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$data</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$condition</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_update()</b> atualiza registros que combinam com a condi&amp;ccedil;&amp;atilde;o especificada pelo argumento <i>condition</i> com os dados do par&amp;acirc;metro <i>data</i>. Se <i>options</i> for especificado, <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a> ser&amp;aacute; aplicada a <i>data</i> com as op&amp;ccedil;&amp;otilde;es especificadas. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 pg_update</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$bd&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=meubanco'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$dados&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'campo1'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'AA'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'campo2'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'BB'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Isto&amp;nbsp;&amp;eacute;&amp;nbsp;seguro&amp;nbsp;j&amp;aacute;&amp;nbsp;que&amp;nbsp;$_POST&amp;nbsp;&amp;eacute;&amp;nbsp;convertido&amp;nbsp;automaticamente<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_update</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$bd</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'post_log'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$_POST</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$dados</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Dados&amp;nbsp;atualizados:&amp;nbsp;</span><span style='color: #0000BB'>$res</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Usu&amp;aacute;rio&amp;nbsp;deve&amp;nbsp;ter&amp;nbsp;enviado&amp;nbsp;entradas&amp;nbsp;inv&amp;aacute;lidas\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <div class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; <em class='emphasis'>EXPERIMENTAL</em>. O comportamento desta fun&amp;ccedil;&amp;atilde;o, seu nome, incluindo toda documenta&amp;ccedil;&amp;atilde;o pode ser modificado sem aviso em futuras vers&amp;otilde;es do PHP. Esta fun&amp;ccedil;&amp;atilde;o deve ser usada por sua pr&amp;oacute;pria conta e risco.</p></div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_untrace" value="<div id='function.pg-untrace' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-untrace.php'>pg_untrace</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_untrace</span> &amp;mdash; <span class='dc-title'>Desabilita o rastreamento de uma conex&amp;atilde;o PostgreSQL</span></p> </div> <a name='function.pg-untrace.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_untrace</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> P&amp;aacute;ra o rastreamento iniciado por <a href='http://www.php.net/manual/pt_BR/function.pg-trace.php' class='function'>pg_trace()</a>. <i><tt class='parameter'>connection</tt></i> especifica a conex&amp;atilde;o que est&amp;aacute; sendo rastreada e seu padr&amp;atilde;o &amp;eacute; a &amp;uacute;ltima conex&amp;atilde;o aberta. </p> <p class='para'> Sempre retorna <b><tt class='constant'>TRUE</tt></b>. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-trace.php' class='function'>pg_trace()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_unescape_bytea" value="<div id='function.pg-unescape-bytea' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-unescape-bytea.php'>pg_unescape_bytea</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_unescape_bytea</span> &amp;mdash; <span class='dc-title'> Faz escape bin&amp;aacute;rio para o tipo bytea </span></p> </div> <a name='function.pg-unescape-bytea.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_unescape_bytea</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_unescape_bytea()</b> faz uma vers&amp;atilde;o bin&amp;aacute;ria da string do tipo bytea. Retorna a string em bin&amp;aacute;rio(binary). </p> <blockquote><p><b class='note'>Nota</b>: Quando voc&amp;ecirc; faz SELECT bytea type, PostgreSQL returna um valor em octal prefixado por \ (por exemplo: \032). Usu&amp;aacute;rios devem fazer a transforma&amp;ccedil;&amp;atilde;o em bin&amp;aacute;rio por si pr&amp;oacute;prios. <br /> Esta fun&amp;ccedil;&amp;atilde;o exige PostgreSQL 7.2 ou superior. Com PostgreSQL 7.2.0 e 7.2.1, o tipo de dados bytea deve ser criado quando voc&amp;ecirc; habilita o suporte a multi-byte. Por exemplo, <i>INSERT INTO tabela_teste (imagem) VALUES (&amp;#039;$imagem_escaped&amp;#039;::bytea);</i> PostgreSQL 7.2.2 ou superior n&amp;atilde;o precisa de coer&amp;ccedil;&amp;atilde;o (cast). A exce&amp;ccedil;&amp;atilde;o &amp;eacute; quando a codifica&amp;ccedil;&amp;atilde;o de caracteres do cliente e do backend n&amp;atilde;o combinam, ent&amp;atilde;o pode haver erro de fluxo de multi-byte. O usu&amp;aacute;rio deve fazer a coer&amp;ccedil;&amp;atilde;o (cast) para bytea para evitar este erro. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-escape-bytea.php' class='function'>pg_escape_bytea()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-escape-string.php' class='function'>pg_escape_string()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_tty" value="<div id='function.pg-tty' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-tty.php'>pg_tty</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_tty</span> &amp;mdash; <span class='dc-title'> Retorna o nome da tty associada com a conex&amp;atilde;o </span></p> </div> <a name='function.pg-tty.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_tty</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_tty()</b> retorna o nome da tty que a sa&amp;iacute;da do lado do servidor &amp;eacute; enviada no recurso (resource) de conex&amp;atilde;o <i><tt class='parameter'>connection</tt></i> . </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_transaction_status" value="<div id='function.pg-transaction-status' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-transaction-status.php'>pg_transaction_status</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_transaction_status</span> &amp;mdash; <span class='dc-title'>Returns the current in-transaction status of the server.</span></p> </div> <a name='function.pg-transaction-status.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_transaction_status</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> Returns the current in-transaction status of the server. </p> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> <b>pg_transaction_status()</b> will give incorrect results when using a PostgreSQL 7.3 server that has the parameter <i>autocommit</i> set to off. The server-side autocommit feature has been deprecated and does not exist in later server versions. </p> </div> </div> <a name='function.pg-transaction-status.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-transaction-status.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>The status can be <b><tt class='constant'>PGSQL_TRANSACTION_IDLE</tt></b> (currently idle), <b><tt class='constant'>PGSQL_TRANSACTION_ACTIVE</tt></b> (a command is in progress), <b><tt class='constant'>PGSQL_TRANSACTION_INTRANS</tt></b> (idle, in a valid transaction block), or <b><tt class='constant'>PGSQL_TRANSACTION_INERROR</tt></b> (idle, in a failed transaction block). <b><tt class='constant'>PGSQL_TRANSACTION_UNKNOWN</tt></b> is reported if the connection is bad. <b><tt class='constant'>PGSQL_TRANSACTION_ACTIVE</tt></b> is reported only when a query has been sent to the server and not yet completed. </p> </div> <a name='function.pg-transaction-status.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_transaction_status()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stat&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_transaction_status</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$stat&amp;nbsp;</span><span style='color: #007700'>===&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_TRANSACTION_UNKNOWN</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;is&amp;nbsp;bad'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$stat&amp;nbsp;</span><span style='color: #007700'>===&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_TRANSACTION_IDLE</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;is&amp;nbsp;currently&amp;nbsp;idle'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;is&amp;nbsp;in&amp;nbsp;a&amp;nbsp;transaction&amp;nbsp;state'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_trace" value="<div id='function.pg-trace' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-trace.php'>pg_trace</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_trace</span> &amp;mdash; <span class='dc-title'>Habilita rastreamento em uma conex&amp;atilde;o PostgreSQL</span></p> </div> <a name='function.pg-trace.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_trace</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pathname</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$mode</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>pg_trace()</b> habilita o rastreamento da comunica&amp;ccedil;&amp;atilde;o frontend/backend do PostgreSQL para um arquivo de depura&amp;ccedil;&amp;atilde;o especificado pelo par&amp;acirc;metro <i><tt class='parameter'>pathname</tt></i> . Para entender completamente estes resultados, voc&amp;ecirc; deve estar familiarizado com o protocolo de comunica&amp;ccedil;&amp;atilde;o interno do PostgreSQL. Para aqueles que n&amp;atilde;o est&amp;atilde;o, isso ainda pode ser &amp;uacute;til para rastrear erros em consultas (queries) enviadas ao servidor, voc&amp;ecirc; poderia fazer por exemplo <strong class='command'>grep &amp;#039;^Para backend&amp;#039; rastro.log</strong>. Para maiores informa&amp;ccedil;&amp;otilde;es vide o manual PostgreSQL. </p> <p class='para'> <i><tt class='parameter'>pathname</tt></i> e <i><tt class='parameter'>mode</tt></i> s&amp;atilde;o os mesmos que na fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> (o <i><tt class='parameter'>mode</tt></i> padr&amp;atilde;o &amp;eacute; &amp;#039;w&amp;#039;), <i><tt class='parameter'>connection</tt></i> especifica a conex&amp;atilde;o a ser rastreada e seu padr&amp;atilde;o &amp;eacute; a &amp;uacute;ltima conex&amp;atilde;o aberta. </p> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o <i><tt class='parameter'>pathname</tt></i> pode ser aberto para escrita, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-untrace.php' class='function'>pg_untrace()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_set_error_verbosity" value="<div id='function.pg-set-error-verbosity' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-set-error-verbosity.php'>pg_set_error_verbosity</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_set_error_verbosity</span> &amp;mdash; <span class='dc-title'> Determines the verbosity of messages returned by <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a> and <a href='http://www.php.net/manual/pt_BR/function.pg-result-error.php' class='function'>pg_result_error()</a>. </span></p> </div> <a name='function.pg-set-error-verbosity.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_set_error_verbosity</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$verbosity</tt></span> )</div> <p class='para rdfs-comment'> Determines the verbosity of messages returned by <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a> and <a href='http://www.php.net/manual/pt_BR/function.pg-result-error.php' class='function'>pg_result_error()</a>. </p> <p class='para'> <b>pg_set_error_verbosity()</b> sets the verbosity mode, returning the connection&amp;#039;s previous setting. In <b><tt class='constant'>PGSQL_ERRORS_TERSE</tt></b> mode, returned messages include severity, primary text, and position only; this will normally fit on a single line. The default mode (<b><tt class='constant'>PGSQL_ERRORS_DEFAULT</tt></b>) produces messages that include the above plus any detail, hint, or context fields (these may span multiple lines). The <b><tt class='constant'>PGSQL_ERRORS_VERBOSE</tt></b> mode includes all available fields. Changing the verbosity does not affect the messages available from already-existing result objects, only subsequently-created ones. </p> </div> <a name='function.pg-set-error-verbosity.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>verbosity</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The required verbosity: <b><tt class='constant'>PGSQL_ERRORS_TERSE</tt></b>, <b><tt class='constant'>PGSQL_ERRORS_DEFAULT</tt></b> or <b><tt class='constant'>PGSQL_ERRORS_VERBOSE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-set-error-verbosity.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The previous verbosity level: <b><tt class='constant'>PGSQL_ERRORS_TERSE</tt></b>, <b><tt class='constant'>PGSQL_ERRORS_DEFAULT</tt></b> or <b><tt class='constant'>PGSQL_ERRORS_VERBOSE</tt></b>. </p> </div> <a name='function.pg-set-error-verbosity.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_set_error_verbosity()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;doesnotexist;'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_set_error_verbosity</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_ERRORS_VERBOSE</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>pg_result_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-set-error-verbosity.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function' rel='rdfs-seeAlso'>pg_last_error()</a> - Retorna a string da &amp;uacute;ltima mensagem de erro de uma conex&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-result-error.php' class='function' rel='rdfs-seeAlso'>pg_result_error()</a> - Retorna a mensagem de erro associada a um resultado</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_set_client_encoding" value="<div id='function.pg-set-client-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-set-client-encoding.php'>pg_set_client_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_set_client_encoding</span> &amp;mdash; <span class='dc-title'> Define a codifica&amp;ccedil;&amp;atilde;o do cliente </span></p> </div> <a name='function.pg-set-client-encoding.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_set_client_encoding</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_set_client_encoding()</b> define a codifica&amp;ccedil;&amp;atilde;o do cliente e retorna 0 caso haja sucesso e -1 se houver erro. </p> <p class='para'> <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;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&amp;ccedil;&amp;otilde;es dispon&amp;iacute;veis dependem da vers&amp;atilde;o do PostgreSQL e libpq. Vide o manual PostgreSQL para saber das codifica&amp;ccedil;&amp;otilde;es dispon&amp;iacute;veis para o seu PostgreSQL. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o exige o PHP 4.0.3 ou maior e PostgreSQL 7.0 ou maior. As codifica&amp;ccedil;&amp;otilde;es suportadas dependem da vers&amp;atilde;o do PostgreSQL. Vide o manual PostgreSQL para detalhes. <br /> Esta fun&amp;ccedil;&amp;atilde;o era chamada <b>pg_setclientencoding()()</b>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-client-encoding.php' class='function'>pg_client_encoding()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_send_query_params" value="<div id='function.pg-send-query-params' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-send-query-params.php'>pg_send_query_params</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_send_query_params</span> &amp;mdash; <span class='dc-title'>Submits a command and separate parameters to the server without waiting for the result(s).</span></p> </div> <a name='function.pg-send-query-params.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_send_query_params</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$params</tt></span> )</div> <p class='para rdfs-comment'> Submits a command and separate parameters to the server without waiting for the result(s). </p> <p class='para'> This is equivalent to <a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function'>pg_send_query()</a> except that query parameters can be specified separately from the <i><tt class='parameter'>query</tt></i> string. The function&amp;#039;s parameters are handled identically to <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a>. Like <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a>, it will not work on pre-7.4 PostgreSQL connections, and it allows only one command in the query string. </p> </div> <a name='function.pg-send-query-params.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The parameterized SQL statement. Must contain only a single statement. (multiple statements separated by semi-colons are not allowed.) If any parameters are used, they are referred to as $1, $2, etc. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>params</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of parameter values to substitute for the $1, $2, etc. placeholders in the original prepared query string. The number of elements in the array must match the number of placeholders. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-send-query-params.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas.</p> <p class='para'> Use <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> to determine the query result. </p> </div> <a name='function.pg-send-query-params.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using <b>pg_send_query_params()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Using&amp;nbsp;parameters.&amp;nbsp;&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;it&amp;nbsp;is&amp;nbsp;not&amp;nbsp;necessary&amp;nbsp;to&amp;nbsp;quote&amp;nbsp;or&amp;nbsp;escape<br />&amp;nbsp;&amp;nbsp;//&amp;nbsp;the&amp;nbsp;parameter.<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_query_params</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;count(*)&amp;nbsp;from&amp;nbsp;authors&amp;nbsp;where&amp;nbsp;city&amp;nbsp;=&amp;nbsp;$1'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Perth'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Compare&amp;nbsp;against&amp;nbsp;basic&amp;nbsp;pg_send_query&amp;nbsp;usage<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_escape_string</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Perth'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;count(*)&amp;nbsp;from&amp;nbsp;authors&amp;nbsp;where&amp;nbsp;city&amp;nbsp;=&amp;nbsp;'</span><span style='color: #007700'>${</span><span style='color: #0000BB'>str</span><span style='color: #007700'>}</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-send-query-params.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function' rel='rdfs-seeAlso'>pg_send_query()</a> - Envia uma consulta (query) assincrona</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_send_query" value="<div id='function.pg-send-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-send-query.php'>pg_send_query</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_send_query</span> &amp;mdash; <span class='dc-title'> Envia uma consulta (query) assincrona </span></p> </div> <a name='function.pg-send-query.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_send_query</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_send_query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_send_query()</b> envia uma consulta (query) ass&amp;iacute;ncrona para <i><tt class='parameter'>connection</tt></i> . Diferente de <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, ela pode enviar consultas m&amp;uacute;ltiplas para o PostgreSQL e carregar os resultados, um por um, usando <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a>. A execu&amp;ccedil;&amp;atilde;o do script n&amp;atilde;o &amp;eacute; bloqueada enquanto as consultas est&amp;atilde;o sendo executadas. Use <a href='http://www.php.net/manual/pt_BR/function.pg-connection-busy.php' class='function'>pg_connection_busy()</a> para checar se a conex&amp;atilde;o est&amp;aacute; ocupada. (por exemplo, se uma consulta est&amp;aacute; sendo executada). A consulta pode ser cancelada chamando <a href='http://www.php.net/manual/pt_BR/function.pg-cancel-query.php' class='function'>pg_cancel_query()</a>. </p> <p class='para'> Apesar de ser poss&amp;iacute;vel enviar multiplas consultas de uma vez, voc&amp;ecirc; n&amp;atilde;o pode enviar m&amp;uacute;ltiplas consultas para uma conex&amp;atilde;o ocupada. Se a consulta &amp;eacute; enviada enquando a conex&amp;atilde;o est&amp;aacute; ocupada ela espera at&amp;eacute; que a &amp;uacute;ltima cosulta seja finalizada e descarta todos os resultados. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Asynchronous Queries</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;authors;&amp;nbsp;select&amp;nbsp;count(*)&amp;nbsp;from&amp;nbsp;authors;'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'First&amp;nbsp;call&amp;nbsp;to&amp;nbsp;pg_get_result():&amp;nbsp;</span><span style='color: #0000BB'>$res1</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$rows1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res1</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$res1</span><span style='color: #DD0000'>&amp;nbsp;has&amp;nbsp;</span><span style='color: #0000BB'>$rows1</span><span style='color: #DD0000'>&amp;nbsp;records\n\n'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'second&amp;nbsp;call&amp;nbsp;to&amp;nbsp;pg_get_result():&amp;nbsp;</span><span style='color: #0000BB'>$res2</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$rows2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res2</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$res2</span><span style='color: #DD0000'>&amp;nbsp;has&amp;nbsp;</span><span style='color: #0000BB'>$rows2</span><span style='color: #DD0000'>&amp;nbsp;records\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> O exemplo acima deve mostrar a seguinte sa&amp;iacute;da: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> first call to pg_get_result(): Resource id #3 Resource id #3 has 3 records second call to pg_get_result(): Resource id #4 Resource id #4 has 1 records </pre></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-cancel-query.php' class='function'>pg_cancel_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-connection-busy.php' class='function'>pg_connection_busy()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_send_prepare" value="<div id='function.pg-send-prepare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-send-prepare.php'>pg_send_prepare</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_send_prepare</span> &amp;mdash; <span class='dc-title'>Sends a request to create a prepared statement with the given parameters, without waiting for completion.</span></p> </div> <a name='function.pg-send-prepare.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_send_prepare</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$stmtname</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> Sends a request to create a prepared statement with the given parameters, without waiting for completion. </p> <p class='para'> This is an asynchronous version of <a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function'>pg_prepare()</a>: it returns <b><tt class='constant'>TRUE</tt></b> if it was able to dispatch the request, and <b><tt class='constant'>FALSE</tt></b> if not. After a successful call, call <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> to determine whether the server successfully created the prepared statement. The function&amp;#039;s parameters are handled identically to <a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function'>pg_prepare()</a>. Like <a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function'>pg_prepare()</a>, it will not work on pre-7.4 versions of PostgreSQL. </p> </div> <a name='function.pg-send-prepare.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmtname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name to give the prepared statement. Must be unique per-connection. If &amp;quot;&amp;quot; is specified, then an unnamed statement is created, overwriting any previously defined unnamed statement. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The parameterized SQL statement. Must contain only a single statement. (multiple statements separated by semi-colons are not allowed.) If any parameters are used, they are referred to as $1, $2, etc. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-send-prepare.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>Returns <b><tt class='constant'>TRUE</tt></b> on success, <b><tt class='constant'>FALSE</tt></b> on failure. Use <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> to determine the query result.</p> </div> <a name='function.pg-send-prepare.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using <b>pg_send_prepare()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Prepare&amp;nbsp;a&amp;nbsp;query&amp;nbsp;for&amp;nbsp;execution<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;shops&amp;nbsp;WHERE&amp;nbsp;name&amp;nbsp;=&amp;nbsp;$1'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;prepared&amp;nbsp;query.&amp;nbsp;&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;it&amp;nbsp;is&amp;nbsp;not&amp;nbsp;necessary&amp;nbsp;to&amp;nbsp;escape<br />&amp;nbsp;&amp;nbsp;//&amp;nbsp;the&amp;nbsp;string&amp;nbsp;'Joe's&amp;nbsp;Widgets'&amp;nbsp;in&amp;nbsp;any&amp;nbsp;way<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Joe's&amp;nbsp;Widgets'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;same&amp;nbsp;prepared&amp;nbsp;query,&amp;nbsp;this&amp;nbsp;time&amp;nbsp;with&amp;nbsp;a&amp;nbsp;different&amp;nbsp;parameter<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Clothes&amp;nbsp;Clothes&amp;nbsp;Clothes'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-send-prepare.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function' rel='rdfs-seeAlso'>pg_connect()</a> - Abre uma conex&amp;atilde;o PostgreSQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function' rel='rdfs-seeAlso'>pg_pconnect()</a> - Abre uma conex&amp;atilde;o PostgreSQL persistente</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function' rel='rdfs-seeAlso'>pg_execute()</a> - Sends a request to execute a prepared statement with given parameters, and waits for the result.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-send-execute.php' class='function' rel='rdfs-seeAlso'>pg_send_execute()</a> - Sends a request to execute a prepared statement with given parameters, without waiting for the result(s).</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-send-query-params.php' class='function' rel='rdfs-seeAlso'>pg_send_query_params()</a> - Submits a command and separate parameters to the server without waiting for the result(s).</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_send_execute" value="<div id='function.pg-send-execute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-send-execute.php'>pg_send_execute</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_send_execute</span> &amp;mdash; <span class='dc-title'>Sends a request to execute a prepared statement with given parameters, without waiting for the result(s).</span></p> </div> <a name='function.pg-send-execute.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_send_execute</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$stmtname</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$params</tt></span> )</div> <p class='para rdfs-comment'> Sends a request to execute a prepared statement with given parameters, without waiting for the result(s). </p> <p class='para'> This is similar to <a href='http://www.php.net/manual/pt_BR/function.pg-send-query-params.php' class='function'>pg_send_query_params()</a>, but the command to be executed is specified by naming a previously-prepared statement, instead of giving a query string. The function&amp;#039;s parameters are handled identically to <a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function'>pg_execute()</a>. Like <a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function'>pg_execute()</a>, it will not work on pre-7.4 versions of PostgreSQL. </p> </div> <a name='function.pg-send-execute.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmtname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the prepared statement to execute. if &amp;quot;&amp;quot; is specified, then the unnamed statement is executed. The name must have been previously prepared using <a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function'>pg_prepare()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-send-prepare.php' class='function'>pg_send_prepare()</a> or a <i>PREPARE</i> SQL command. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>params</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of parameter values to substitute for the $1, $2, etc. placeholders in the original prepared query string. The number of elements in the array must match the number of placeholders. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-send-execute.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>Returns <b><tt class='constant'>TRUE</tt></b> on success, <b><tt class='constant'>FALSE</tt></b> on failure. Use <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> to determine the query result.</p> </div> <a name='function.pg-send-execute.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using <b>pg_send_execute()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Prepare&amp;nbsp;a&amp;nbsp;query&amp;nbsp;for&amp;nbsp;execution<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;shops&amp;nbsp;WHERE&amp;nbsp;name&amp;nbsp;=&amp;nbsp;$1'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;prepared&amp;nbsp;query.&amp;nbsp;&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;it&amp;nbsp;is&amp;nbsp;not&amp;nbsp;necessary&amp;nbsp;to&amp;nbsp;escape<br />&amp;nbsp;&amp;nbsp;//&amp;nbsp;the&amp;nbsp;string&amp;nbsp;'Joe's&amp;nbsp;Widgets'&amp;nbsp;in&amp;nbsp;any&amp;nbsp;way<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Joe's&amp;nbsp;Widgets'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;same&amp;nbsp;prepared&amp;nbsp;query,&amp;nbsp;this&amp;nbsp;time&amp;nbsp;with&amp;nbsp;a&amp;nbsp;different&amp;nbsp;parameter<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Clothes&amp;nbsp;Clothes&amp;nbsp;Clothes'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-send-execute.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function' rel='rdfs-seeAlso'>pg_prepare()</a> - Submits a request to create a prepared statement with the given parameters, and waits for completion.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-send-prepare.php' class='function' rel='rdfs-seeAlso'>pg_send_prepare()</a> - Sends a request to create a prepared statement with the given parameters, without waiting for completion.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function' rel='rdfs-seeAlso'>pg_execute()</a> - Sends a request to execute a prepared statement with given parameters, and waits for the result.</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_select" value="<div id='function.pg-select' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-select.php'>pg_select</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_select</span> &amp;mdash; <span class='dc-title'> Seleciona registros. </span></p> </div> <a name='function.pg-select.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_select</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$assoc_array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_select()</b> seleciona registros especificados por <i>assoc_array</i>, que cont&amp;eacute;m pares do tipo <i>campo=&amp;gt;valor</i>. Para uma consulta (query) v&amp;aacute;lida, retorna um array que cont&amp;eacute;m todos os registros e campos que combinam com a condi&amp;ccedil;&amp;atilde;o especificada por <i>assoc_array</i>. Se <i>options</i> for especificado, <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a> ser&amp;aacute; aplicada &amp;agrave; <i>assoc_array</i> com as op&amp;ccedil;&amp;otilde;es especificadas. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 pg_select</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'nomebd=meubanco'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Isto&amp;nbsp;&amp;eacute;&amp;nbsp;seguro&amp;nbsp;j&amp;aacute;&amp;nbsp;que&amp;nbsp;$_POST&amp;nbsp;&amp;eacute;&amp;nbsp;convertida&amp;nbsp;automaticamente<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$rec&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_select</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$bd</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'post_log'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$_POST</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$rec</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Registros&amp;nbsp;selecionados\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$rec</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;usu&amp;aacute;rio&amp;nbsp;deve&amp;nbsp;ter&amp;nbsp;inserido&amp;nbsp;dados&amp;nbsp;errados\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <div class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; <em class='emphasis'>EXPERIMENTAL</em>. O comportamento desta fun&amp;ccedil;&amp;atilde;o, seu nome, incluindo toda documenta&amp;ccedil;&amp;atilde;o pode ser modificado sem aviso em futuras vers&amp;otilde;es do PHP. Esta fun&amp;ccedil;&amp;atilde;o deve ser usada por sua pr&amp;oacute;pria conta e risco.</p></div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_result_status" value="<div id='function.pg-result-status' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-result-status.php'>pg_result_status</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_result_status</span> &amp;mdash; <span class='dc-title'> Retorna o status do resultado da consulta (query) </span></p> </div> <a name='function.pg-result-status.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_result_status</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_result_status()</b> retorna o status do recurso (resource) de resultado. Os valores de retorno poss&amp;iacute;veis s&amp;atilde;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. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connection-status.php' class='function'>pg_connection_status()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_result_seek" value="<div id='function.pg-result-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-result-seek.php'>pg_result_seek</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_result_seek</span> &amp;mdash; <span class='dc-title'>Altera a posi&amp;ccedil;&amp;atilde;o do ponteiro interno de um recurso (resource) de resultado</span></p> </div> <a name='function.pg-result-seek.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_result_seek</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_result_seek()</b> altera a posi&amp;ccedil;&amp;atilde;o do ponteiro interno de um recurso (resource) de resultado. Retorna <b><tt class='constant'>FALSE</tt></b> em caso de erro. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-assoc.php' class='function'>pg_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-object.php' class='function'>pg_fetch_object()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-result.php' class='function'>pg_fetch_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_result_error_field" value="<div id='function.pg-result-error-field' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-result-error-field.php'>pg_result_error_field</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_result_error_field</span> &amp;mdash; <span class='dc-title'>Returns an individual field of an error report.</span></p> </div> <a name='function.pg-result-error-field.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_result_error_field</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fieldcode</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_result_error_field()</b> returns one of the detailed error message fields associated with <i><tt class='parameter'>result</tt></i> resource. It is only available against a PostgreSQL 7.4 or above server. The error field is specified by the <i><tt class='parameter'>fieldcode</tt></i> . </p> <p class='para'> Because <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> and <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a> return <b><tt class='constant'>FALSE</tt></b> if the query fails, you must use <a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function'>pg_send_query()</a> and <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> to get the result handle. </p> <p class='para'> If you need to get additional error information from failed <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> queries, use <a href='http://www.php.net/manual/pt_BR/function.pg-set-error-verbosity.php' class='function'>pg_set_error_verbosity()</a> and <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a> and then parse the result. </p> </div> <a name='function.pg-result-error-field.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A PostgreSQL query result resource from a previously executed statement. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>fieldcode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Possible <i><tt class='parameter'>fieldcode</tt></i> values are: <b><tt class='constant'>PGSQL_DIAG_SEVERITY</tt></b>, <b><tt class='constant'>PGSQL_DIAG_SQLSTATE</tt></b>, <b><tt class='constant'>PGSQL_DIAG_MESSAGE_PRIMARY</tt></b>, <b><tt class='constant'>PGSQL_DIAG_MESSAGE_DETAIL</tt></b>, <b><tt class='constant'>PGSQL_DIAG_MESSAGE_HINT</tt></b>, <b><tt class='constant'>PGSQL_DIAG_STATEMENT_POSITION</tt></b>, <b><tt class='constant'>PGSQL_DIAG_INTERNAL_POSITION</tt></b> (PostgreSQL 8.0+ only), <b><tt class='constant'>PGSQL_DIAG_INTERNAL_QUERY</tt></b> (PostgreSQL 8.0+ only), <b><tt class='constant'>PGSQL_DIAG_CONTEXT</tt></b>, <b><tt class='constant'>PGSQL_DIAG_SOURCE_FILE</tt></b>, <b><tt class='constant'>PGSQL_DIAG_SOURCE_LINE</tt></b> or <b><tt class='constant'>PGSQL_DIAG_SOURCE_FUNCTION</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-result-error-field.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>A <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> containing the contents of the error field, <b><tt class='constant'>NULL</tt></b> if the field does not exist or <b><tt class='constant'>FALSE</tt></b> on failure.</p> </div> <a name='function.pg-result-error-field.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_result_error_field()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_send_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;doesnotexist;'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>pg_result_error_field</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_DIAG_SQLSTATE</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-result-error-field.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-result-error.php' class='function' rel='rdfs-seeAlso'>pg_result_error()</a> - Retorna a mensagem de erro associada a um resultado</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_result_error" value="<div id='function.pg-result-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-result-error.php'>pg_result_error</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_result_error</span> &amp;mdash; <span class='dc-title'> Retorna a mensagem de erro associada a um resultado </span></p> </div> <a name='function.pg-result-error.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_result_error</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_result_error()</b> retorna a mensagem de erro associada ao recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . Deste modo, o usu&amp;aacute;rio tem melhores chances de ter uma mensagem de erro melhor que a retornada por <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a>. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function'>pg_send_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-last-notice.php' class='function'>pg_last_notice()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_query_params" value="<div id='function.pg-query-params' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-query-params.php'>pg_query_params</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_query_params</span> &amp;mdash; <span class='dc-title'>Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text.</span></p> </div> <a name='function.pg-query-params.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_query_params</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$params</tt></span> )</div> <p class='para rdfs-comment'> Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text. </p> <p class='para'> <b>pg_query_params()</b> is like <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, but offers additional functionality: parameter values can be specified separately from the command string proper. <b>pg_query_params()</b> is supported only against PostgreSQL 7.4 or higher connections; it will fail when using earlier versions. </p> <p class='para'> If parameters are used, they are referred to in the <i><tt class='parameter'>query</tt></i> string as $1, $2, etc. <i><tt class='parameter'>params</tt></i> specifies the actual values of the parameters. A <b><tt class='constant'>NULL</tt></b> value in this array means the corresponding parameter is SQL <i>NULL</i>. </p> <p class='para'> The primary advantage of <b>pg_query_params()</b> over <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> is that parameter values may be separated from the <i><tt class='parameter'>query</tt></i> string, thus avoiding the need for tedious and error-prone quoting and escaping. Unlike <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <b>pg_query_params()</b> allows at most one SQL command in the given string. (There can be semicolons in it, but not more than one nonempty command.) </p> </div> <a name='function.pg-query-params.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The parameterized SQL statement. Must contain only a single statement. (multiple statements separated by semi-colons are not allowed.) If any parameters are used, they are referred to as $1, $2, etc. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>params</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of parameter values to substitute for the $1, $2, etc. placeholders in the original prepared query string. The number of elements in the array must match the number of placeholders. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-query-params.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A query result resource on success or <b><tt class='constant'>FALSE</tt></b> on failure.</p> </div> <a name='function.pg-query-params.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using <b>pg_query_params()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;Connect&amp;nbsp;to&amp;nbsp;a&amp;nbsp;database&amp;nbsp;named&amp;nbsp;'mary'<br /></span><span style='color: #0000BB'>$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=mary'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Find&amp;nbsp;all&amp;nbsp;shops&amp;nbsp;named&amp;nbsp;Joe's&amp;nbsp;Widgets.&amp;nbsp;&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;it&amp;nbsp;is&amp;nbsp;not&amp;nbsp;necessary&amp;nbsp;to<br />//&amp;nbsp;escape&amp;nbsp;'Joe's&amp;nbsp;Widgets'<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query_params</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;shops&amp;nbsp;WHERE&amp;nbsp;name&amp;nbsp;=&amp;nbsp;$1'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Joe's&amp;nbsp;Widgets'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Compare&amp;nbsp;against&amp;nbsp;just&amp;nbsp;using&amp;nbsp;pg_query<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_escape_string</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Joe's&amp;nbsp;Widgets'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;shops&amp;nbsp;WHERE&amp;nbsp;name&amp;nbsp;=&amp;nbsp;'</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>}</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-query-params.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function' rel='rdfs-seeAlso'>pg_query()</a> - Executa uma consulta (query)</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_query" value="<div id='function.pg-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-query.php'>pg_query</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_query</span> &amp;mdash; <span class='dc-title'>Executa uma consulta (query)</span></p> </div> <a name='function.pg-query.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_query</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_query()</b> retorna um recurso (resource) de resultado da consulta (query) se a consulta p&amp;ocirc;de ser executada. Retorna <b><tt class='constant'>FALSE</tt></b> em caso de falha ou se a conex&amp;atilde;o n&amp;atilde;o &amp;eacute; uma conex&amp;atilde;o v&amp;aacute;lida. Detalhes sobre os erros podem ser recuperados usando a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a> se a conex&amp;atilde;o &amp;eacute; v&amp;aacute;lida. <b>pg_query()</b> envia uma declara&amp;ccedil;&amp;atilde;o SQL para o banco de dados PostgreSQL especificado pelo recurso de conex&amp;atilde;o <i><tt class='parameter'>connection</tt></i> . <i><tt class='parameter'>connection</tt></i> deve ser uma conex&amp;atilde;o v&amp;aacute;lida que foi criado por <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a>. O valor de retorno dessa fun&amp;ccedil;&amp;atilde;o &amp;eacute; um recurso (resource) de resultado de consulta (query) para ser usado para acessar os resultados de outras fun&amp;ccedil;&amp;otilde;es PostgreSQL como <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>. </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> <i><tt class='parameter'>connection</tt></i> &amp;eacute; um par&amp;acirc;metro opcional para <b>pg_query()</b>. Se <i><tt class='parameter'>connection</tt></i> n&amp;atilde;o for definido, a conex&amp;atilde;o padr&amp;atilde;o ser&amp;aacute; usada. A conex&amp;atilde;o padr&amp;atilde;o &amp;eacute; a &amp;uacute;ltima conex&amp;atilde;o feita por <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> ou <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </span> <span class='simpara'> Apesar de <i><tt class='parameter'>connection</tt></i> poder ser omitido, isso n&amp;atilde;o &amp;eacute; recomendado j&amp;aacute; que pode ser uma causa de erros dif&amp;iacute;ceis de encontrar no seu script. </span> </p></blockquote><p> </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_exec()</i>. <i>pg_exec()</i> ainda est&amp;aacute; dispon&amp;iacute;vel por raz&amp;otilde;es de compatibilidade, mas os usu&amp;aacute;rios s&amp;atilde;o encorajados a usar o novo nome. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-object.php' class='function'>pg_fetch_object()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-num-rows.php' class='function'>pg_num_rows()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-affected-rows.php' class='function'>pg_affected_rows()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_put_line" value="<div id='function.pg-put-line' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-put-line.php'>pg_put_line</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_put_line</span> &amp;mdash; <span class='dc-title'>Envia uma string terminada em NULL para o backend PostgreSQL</span></p> </div> <a name='function.pg-put-line.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_put_line</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_put_line()</b> envia uma string terminada em NULL para o servidor backend PostgreSQL. Isso &amp;eacute; &amp;uacute;til, por exemplo, para a inser&amp;ccedil;&amp;atilde;o de dados em uma tabela em alta velocidade, iniciada atrav&amp;eacute;s de uma opera&amp;ccedil;&amp;atilde;o de c&amp;oacute;pia PostgreSQL. O caractere NULL final &amp;eacute; adicionado automaticamente. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <blockquote><p><b class='note'>Nota</b>: A aplica&amp;ccedil;&amp;atilde;o deve enviar os dois caracteres &amp;quot;\.&amp;quot; explicitamente na &amp;uacute;ltima linha para indicar ao backend que ela terminou de enviar seus dados. <br /> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Inser&amp;ccedil;&amp;atilde;o de dados na tabela em alta velocidade</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'nomebd=meubanco'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'create&amp;nbsp;table&amp;nbsp;bar&amp;nbsp;(a&amp;nbsp;int4,&amp;nbsp;b&amp;nbsp;char(16),&amp;nbsp;d&amp;nbsp;float8)'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'copy&amp;nbsp;bar&amp;nbsp;from&amp;nbsp;stdin'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_put_line</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'3\tola&amp;nbsp;mundo\t4.5\n'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_put_line</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'4\ttchau&amp;nbsp;mundo\t7.11\n'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_put_line</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\\.\n'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_end_copy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-end-copy.php' class='function'>pg_end_copy()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_prepare" value="<div id='function.pg-prepare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-prepare.php'>pg_prepare</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_prepare</span> &amp;mdash; <span class='dc-title'> Submits a request to create a prepared statement with the given parameters, and waits for completion.</span></p> </div> <a name='function.pg-prepare.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_prepare</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$stmtname</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_prepare()</b> creates a prepared statement for later execution with <a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function'>pg_execute()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-send-execute.php' class='function'>pg_send_execute()</a>. This feature allows commands that will be used repeatedly to be parsed and planned just once, rather than each time they are executed. <b>pg_prepare()</b> is supported only against PostgreSQL 7.4 or higher connections; it will fail when using earlier versions. </p> <p class='para'> The function creates a prepared statement named <i><tt class='parameter'>stmtname</tt></i> from the <i><tt class='parameter'>query</tt></i> string, which must contain a single SQL command. <i><tt class='parameter'>stmtname</tt></i> may be &amp;quot;&amp;quot; to create an unnamed statement, in which case any pre-existing unnamed statement is automatically replaced; otherwise it is an error if the statement name is already defined in the current session. If any parameters are used, they are referred to in the <i><tt class='parameter'>query</tt></i> as $1, $2, etc. </p> <p class='para'> Prepared statements for use with <b>pg_prepare()</b> can also be created by executing SQL <i>PREPARE</i> statements. (But <b>pg_prepare()</b> is more flexible since it does not require parameter types to be pre-specified.) Also, although there is no PHP function for deleting a prepared statement, the SQL <i>DEALLOCATE</i> statement can be used for that purpose. </p> </div> <a name='function.pg-prepare.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmtname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name to give the prepared statement. Must be unique per-connection. If &amp;quot;&amp;quot; is specified, then an unnamed statement is created, overwriting any previously defined unnamed statement. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The parameterized SQL statement. Must contain only a single statement. (multiple statements separated by semi-colons are not allowed.) If any parameters are used, they are referred to as $1, $2, etc. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-prepare.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A query result resource on success or <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.pg-prepare.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using <b>pg_prepare()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;Connect&amp;nbsp;to&amp;nbsp;a&amp;nbsp;database&amp;nbsp;named&amp;nbsp;'mary'<br /></span><span style='color: #0000BB'>$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=mary'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Prepare&amp;nbsp;a&amp;nbsp;query&amp;nbsp;for&amp;nbsp;execution<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;shops&amp;nbsp;WHERE&amp;nbsp;name&amp;nbsp;=&amp;nbsp;$1'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;prepared&amp;nbsp;query.&amp;nbsp;&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;it&amp;nbsp;is&amp;nbsp;not&amp;nbsp;necessary&amp;nbsp;to&amp;nbsp;escape<br />//&amp;nbsp;the&amp;nbsp;string&amp;nbsp;'Joe's&amp;nbsp;Widgets'&amp;nbsp;in&amp;nbsp;any&amp;nbsp;way<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Joe's&amp;nbsp;Widgets'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;same&amp;nbsp;prepared&amp;nbsp;query,&amp;nbsp;this&amp;nbsp;time&amp;nbsp;with&amp;nbsp;a&amp;nbsp;different&amp;nbsp;parameter<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Clothes&amp;nbsp;Clothes&amp;nbsp;Clothes'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-prepare.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function' rel='rdfs-seeAlso'>pg_execute()</a> - Sends a request to execute a prepared statement with given parameters, and waits for the result.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-send-execute.php' class='function' rel='rdfs-seeAlso'>pg_send_execute()</a> - Sends a request to execute a prepared statement with given parameters, without waiting for the result(s).</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_port" value="<div id='function.pg-port' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-port.php'>pg_port</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_port</span> &amp;mdash; <span class='dc-title'> Retorna o n&amp;uacute;mero da porta associada com a conex&amp;atilde;o. </span></p> </div> <a name='function.pg-port.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_port</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_port()</b> retorna o n&amp;uacute;mero da porta a qual o recurso de conex&amp;atilde;o PostgreSQL <i><tt class='parameter'>connection</tt></i> est&amp;aacute; conectado. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_ping" value="<div id='function.pg-ping' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-ping.php'>pg_ping</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_ping</span> &amp;mdash; <span class='dc-title'>Faz um ping na conex&amp;atilde;o com o banco de dados</span></p> </div> <a name='function.pg-ping.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_ping</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_ping()</b> faz um ping na conex&amp;atilde;o com o banco de dados, tenta reconectar se a conex&amp;atilde;o foi quebrada. Retorna <b><tt class='constant'>TRUE</tt></b> se a conex&amp;atilde;o est&amp;aacute; ativa, do contr&amp;aacute;rio, retorna <b><tt class='constant'>FALSE</tt></b>. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>pg_ping()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publicacao'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Ocorreu&amp;nbsp;um&amp;nbsp;erro.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>pg_ping</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>))<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;quebrada\n'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connection-status.php' class='function'>pg_connection_status()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-connection-reset.php' class='function'>pg_connection_reset()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_pconnect" value="<div id='function.pg-pconnect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-pconnect.php'>pg_pconnect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_pconnect</span> &amp;mdash; <span class='dc-title'>Abre uma conex&amp;atilde;o PostgreSQL persistente</span></p> </div> <a name='function.pg-pconnect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_pconnect</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$connection_string</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_pconnect()</b> abre uma conex&amp;atilde;o a um banco de dados PostgreSQL. Retorna um recurso (resource) de conex&amp;atilde;o que &amp;eacute; necess&amp;aacute;rio para outras fun&amp;ccedil;&amp;otilde;es PostgreSQL. </p> <p class='para'> Para uma descri&amp;ccedil;&amp;atilde;o do par&amp;acirc;metro <i><tt class='parameter'>connection_string</tt></i> veja <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a>. </p> <p class='para'> Para habilitar uma conex&amp;atilde;o persistente, a diretiva <a href='http://www.php.net/manual/pt_BR/pgsql.configuration.php#ini.pgsql.allow-persistent' class='link'>pgsql.allow_persistent</a> do <var class='filename'>php.ini</var> deve ser definida como &amp;quot;On&amp;quot; (que &amp;eacute; o padr&amp;atilde;o). O n&amp;uacute;mero m&amp;aacute;ximo de conex&amp;otilde;es persistentes pode ser definida com a diretiva <a href='http://www.php.net/manual/pt_BR/pgsql.configuration.php#ini.pgsql.max-persistent' class='link'>pgsql.max_persistent</a> do <var class='filename'>php.ini</var> (o padr&amp;atilde;o &amp;eacute; -1 para sem limite). O n&amp;uacute;mero total de conex&amp;otilde;es pode ser definido com a diretiva <a href='http://www.php.net/manual/pt_BR/pgsql.configuration.php#ini.pgsql.max-links' class='link'> pgsql.max_links</a> do <var class='filename'>php.ini</var>. </p> <p class='para'> <a href='http://www.php.net/manual/pt_BR/function.pg-close.php' class='function'>pg_close()</a> n&amp;atilde;o fechar&amp;aacute; links persistentes gerados por <b>pg_pconnect()</b>. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> e a se&amp;ccedil;&amp;atilde;o sobre <a href='http://www.php.net/manual/pt_BR/features.persistent-connections.php' class='link'>Conex&amp;otilde;es Persistentes</a> para maiores informa&amp;ccedil;&amp;otilde;es. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_parameter_status" value="<div id='function.pg-parameter-status' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-parameter-status.php'>pg_parameter_status</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>pg_parameter_status</span> &amp;mdash; <span class='dc-title'>Looks up a current parameter setting of the server.</span></p> </div> <a name='function.pg-parameter-status.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_parameter_status</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$param_name</tt></span> )</div> <p class='para rdfs-comment'> Looks up a current parameter setting of the server. </p> <p class='para'> Certain parameter values are reported by the server automatically at connection startup or whenever their values change. <b>pg_parameter_status()</b> can be used to interrogate these settings. It returns the current value of a parameter if known, or <b><tt class='constant'>FALSE</tt></b> if the parameter is not known. </p> <p class='para'> Parameters reported as of PostgreSQL 8.0 include <i>server_version</i>, <i>server_encoding</i>, <i>client_encoding</i>, <i>is_superuser</i>, <i>session_authorization</i>, <i>DateStyle</i>, <i>TimeZone</i>, and <i>integer_datetimes</i>. (<i>server_encoding</i>, <i>TimeZone</i>, and <i>integer_datetimes</i> were not reported by releases before 8.0.) Note that <i>server_version</i>, <i>server_encoding</i> and <i>integer_datetimes</i> cannot change after PostgreSQL startup. </p> <p class='para'> PostgreSQL 7.3 or lower servers do not report parameter settings, <b>pg_parameter_status()</b> includes logic to obtain values for <i>server_version</i> and <i>client_encoding</i> anyway. Applications are encouraged to use <b>pg_parameter_status()</b> rather than ad hoc code to determine these values. </p> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> On a pre-7.4 PostgreSQL server, changing <i>client_encoding</i> via <i>SET</i> after connection startup will not be reflected by <b>pg_parameter_status()</b>. </p> </div> </div> <a name='function.pg-parameter-status.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>param_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Possible <i><tt class='parameter'>param_name</tt></i> values include <i>server_version</i>, <i>server_encoding</i>, <i>client_encoding</i>, <i>is_superuser</i>, <i>session_authorization</i>, <i>DateStyle</i>, <i>TimeZone</i>, and <i>integer_datetimes</i>. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-parameter-status.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>A <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> containing the value of the parameter, <b><tt class='constant'>FALSE</tt></b> on failure or invalid <i><tt class='parameter'>param_name</tt></i> .</p> </div> <a name='function.pg-parameter-status.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_parameter_status()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Server&amp;nbsp;encoding:&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>pg_parameter_status</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'server_encoding'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Server encoding: SQL_ASCII </pre></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_options" value="<div id='function.pg-options' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-options.php'>pg_options</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_options</span> &amp;mdash; <span class='dc-title'>Retorna as op&amp;ccedil;&amp;otilde;es associadas com a conex&amp;atilde;o</span></p> </div> <a name='function.pg-options.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_options</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_options()</b> retornar&amp;aacute; uma string contendo as op&amp;ccedil;&amp;otilde;es especificadas no recurso (resource) de conex&amp;atilde;o PostgreSQL <i><tt class='parameter'>connection</tt></i> . </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_num_rows" value="<div id='function.pg-num-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-num-rows.php'>pg_num_rows</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_num_rows</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero de linhas</span></p> </div> <a name='function.pg-num-rows.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_num_rows</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_num_rows()</b> ir&amp;aacute; retornar o n&amp;uacute;mero de linhas do recurso de resultado <i><tt class='parameter'>result</tt></i> . <i><tt class='parameter'>result</tt></i> &amp;eacute; um recurso (resource) de resultado de consulta (query) feito por <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>. Esta fun&amp;ccedil;&amp;atilde;o retornar&amp;aacute; -1 em caso de erro. </p> <blockquote><p><b class='note'>Nota</b>: Use <a href='http://www.php.net/manual/pt_BR/function.pg-affected-rows.php' class='function'>pg_affected_rows()</a> para obter o n&amp;uacute;mero de linhas afetadas por consultas do tipo INSERT, UPDATE e DELETE. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_numrows()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-num-fields.php' class='function'>pg_num_fields()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-affected-rows.php' class='function'>pg_affected_rows()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_num_fields" value="<div id='function.pg-num-fields' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-num-fields.php'>pg_num_fields</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_num_fields</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero de campos</span></p> </div> <a name='function.pg-num-fields.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_num_fields</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_num_fields()</b> retorna o n&amp;uacute;mero de campos (colunas) do recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . O argumento &amp;eacute; um recurso (resource) de resultado criado a partir de <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>. Esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar -1 em caso de erro. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_numfields()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-num-rows.php' class='function'>pg_num_rows()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-affected-rows.php' class='function'>pg_affected_rows()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_meta_data" value="<div id='function.pg-meta-data' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-meta-data.php'>pg_meta_data</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_meta_data</span> &amp;mdash; <span class='dc-title'> Retorna os metadados da tabela. </span></p> </div> <a name='function.pg-meta-data.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_meta_data</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_metadata()</b> retorna a defini&amp;ccedil;&amp;atilde;o da tabela com o nome igual ao valor de <i>table_name</i> como um array. Se houver algum erro, retorna <b><tt class='constant'>FALSE</tt></b>. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Obtendo os dados da tabela</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_meta_data</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'authors'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>is_array&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;pre&amp;gt;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;/pre&amp;gt;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> O exemplo acima ir&amp;aacute; mostar a seguinte sa&amp;iacute;da: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> array(3) { [&amp;quot;author&amp;quot;]=&amp;gt; array(5) { [&amp;quot;num&amp;quot;]=&amp;gt; int(1) [&amp;quot;type&amp;quot;]=&amp;gt; string(7) &amp;quot;varchar&amp;quot; [&amp;quot;len&amp;quot;]=&amp;gt; int(-1) [&amp;quot;not null&amp;quot;]=&amp;gt; bool(false) [&amp;quot;has default&amp;quot;]=&amp;gt; bool(false) } [&amp;quot;year&amp;quot;]=&amp;gt; array(5) { [&amp;quot;num&amp;quot;]=&amp;gt; int(2) [&amp;quot;type&amp;quot;]=&amp;gt; string(4) &amp;quot;int2&amp;quot; [&amp;quot;len&amp;quot;]=&amp;gt; int(2) [&amp;quot;not null&amp;quot;]=&amp;gt; bool(false) [&amp;quot;has default&amp;quot;]=&amp;gt; bool(false) } [&amp;quot;title&amp;quot;]=&amp;gt; array(5) { [&amp;quot;num&amp;quot;]=&amp;gt; int(3) [&amp;quot;type&amp;quot;]=&amp;gt; string(7) &amp;quot;varchar&amp;quot; [&amp;quot;len&amp;quot;]=&amp;gt; int(-1) [&amp;quot;not null&amp;quot;]=&amp;gt; bool(false) [&amp;quot;has default&amp;quot;]=&amp;gt; bool(false) } } </pre></div> </div> </div><p> </p> <div class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; <em class='emphasis'>EXPERIMENTAL</em>. O comportamento desta fun&amp;ccedil;&amp;atilde;o, seu nome, incluindo toda documenta&amp;ccedil;&amp;atilde;o pode ser modificado sem aviso em futuras vers&amp;otilde;es do PHP. Esta fun&amp;ccedil;&amp;atilde;o deve ser usada por sua pr&amp;oacute;pria conta e risco.</p></div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_write" value="<div id='function.pg-lo-write' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-write.php'>pg_lo_write</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_write</span> &amp;mdash; <span class='dc-title'>Escreve em um objeto grande (large object)</span></p> </div> <a name='function.pg-lo-write.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_lo_write</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$large_object</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_write()</b> escreve em um objeto grande (large object) a partir de uma vari&amp;aacute;vel <i><tt class='parameter'>data</tt></i> e retorna o n&amp;uacute;mero de bytes escritos, ou <b><tt class='constant'>FALSE</tt></b> em caso de erro. <i><tt class='parameter'>large_object</tt></i> &amp;eacute; um recurso (resource) de objeto grande criado a partir de <a href='http://www.php.net/manual/pt_BR/function.pg-lo-open.php' class='function'>pg_lo_open()</a>. </p> <p class='para'> Para usar a interface de objetos grandes (lo) &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_lowrite()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-create.php' class='function'>pg_lo_create()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-lo-open.php' class='function'>pg_lo_open()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_unlink" value="<div id='function.pg-lo-unlink' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-unlink.php'>pg_lo_unlink</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_unlink</span> &amp;mdash; <span class='dc-title'>Remove um objeto grande (large object)</span></p> </div> <a name='function.pg-lo-unlink.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_lo_unlink</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$oid</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_unlink()</b> remove um objeto grande (large object) com um determinado <i><tt class='parameter'>oid</tt></i> . Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <p class='para'> Para usar a interface de objetos grandes (lo) &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_lo_unlink()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-create.php' class='function'>pg_lo_create()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-lo-import.php' class='function'>pg_lo_import()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_tell" value="<div id='function.pg-lo-tell' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-tell.php'>pg_lo_tell</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_tell</span> &amp;mdash; <span class='dc-title'> Retorna a posi&amp;ccedil;&amp;atilde;o atual de um objeto grande (large object) </span></p> </div> <a name='function.pg-lo-tell.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_lo_tell</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$large_object</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_tell()</b> retorna a posi&amp;ccedil;&amp;atilde;o atual (deslocamento a partir do in&amp;iacute;cio do objeto grande). </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-seek.php' class='function'>pg_lo_seek()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_seek" value="<div id='function.pg-lo-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-seek.php'>pg_lo_seek</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_seek</span> &amp;mdash; <span class='dc-title'> Procura uma posi&amp;ccedil;&amp;atilde;o em um objeto grande (large object) </span></p> </div> <a name='function.pg-lo-seek.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_lo_seek</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$large_object</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$whence</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_lo_seek()</b> procura uma posi&amp;ccedil;&amp;atilde;o em um recurso (resource) de um objeto grande (large objet). <i><tt class='parameter'>whence</tt></i> pode ser PGSQL_SEEK_SET, PGSQL_SSEK_CUR ou PGSQL_SEEK_END. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-tell.php' class='function'>pg_lo_tell()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_read_all" value="<div id='function.pg-lo-read-all' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-read-all.php'>pg_lo_read_all</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_read_all</span> &amp;mdash; <span class='dc-title'> L&amp;ecirc; um objeto grande (large object) inteiro e o envia diretamente para o navegador </span></p> </div> <a name='function.pg-lo-read-all.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_lo_read_all</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$large_object</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_read_all()</b> l&amp;ecirc; um objeto grande (large object) e passa-o diretamente para o navegador depois de enviar todos os cabe&amp;ccedil;alhos pendentes. A inten&amp;ccedil;&amp;atilde;o principal &amp;eacute; enviar dados bin&amp;aacute;rios como imagens ou som. Retorna o n&amp;uacute;mero de bytes lidos ou <b><tt class='constant'>FALSE</tt></b> se ocorrer algum erro. </p> <p class='para'> Para usar a interface de objetos grandes (lo) &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_loreadall()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-read.php' class='function'>pg_lo_read()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_read" value="<div id='function.pg-lo-read' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-read.php'>pg_lo_read</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_read</span> &amp;mdash; <span class='dc-title'>L&amp;ecirc; um objeto grande (large object)</span></p> </div> <a name='function.pg-lo-read.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_lo_read</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$large_object</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$len</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_read()</b> l&amp;ecirc; o n&amp;uacute;mero de bytes equivalente ao valor de <i><tt class='parameter'>len</tt></i> de um objeto grande (large object) e retorna-o como uma string. <i><tt class='parameter'>large_object</tt></i> especifica um recurso (resource) v&amp;aacute;lido de objeto e <i><tt class='parameter'>len</tt></i> especifica o tamanho m&amp;aacute;ximo permitido do segmento do objeto grande. Retorna <b><tt class='constant'>FALSE</tt></b> se algum erro acontecer. </p> <p class='para'> Para usar a interface de objetos grandes (lo) &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_loread()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-read-all.php' class='function'>pg_lo_read_all()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_open" value="<div id='function.pg-lo-open' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-open.php'>pg_lo_open</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_open</span> &amp;mdash; <span class='dc-title'>Abre um objeto grande (large object)</span></p> </div> <a name='function.pg-lo-open.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_lo_open</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$oid</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$mode</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_open()</b> abre um Objeto Grande (Large Object em ingl&amp;ecirc;s, da&amp;iacute; o &amp;quot;lo&amp;quot;). O recurso (resource) encapsula informa&amp;ccedil;&amp;otilde;es sobre a conex&amp;atilde;o. <i><tt class='parameter'>oid</tt></i> especifica um oid de objeto grande v&amp;aacute;lido e o par&amp;acirc;metro <i><tt class='parameter'>mode</tt></i> pode ser &amp;quot;r&amp;quot;, &amp;quot;w&amp;quot; ou &amp;quot;rw&amp;quot;. A fun&amp;ccedil;&amp;atilde;o retorna <b><tt class='constant'>FALSE</tt></b> se houver algum erro. </p> <div class='warning'><b class='warning'>Aviso</b> <p class='para'> N&amp;atilde;o feche a conex&amp;atilde;o com o banco de dados sem antes fechar a conex&amp;atilde;o com o objeto grande. </p> </div> <p class='para'> Para usar a interface de objetos grandes (lo) &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_loopen()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-close.php' class='function'>pg_lo_close()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-lo-create.php' class='function'>pg_lo_create()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_import" value="<div id='function.pg-lo-import' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-import.php'>pg_lo_import</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_import</span> &amp;mdash; <span class='dc-title'>Importa um objeto grande (large object) a partir de um arquivo</span></p> </div> <a name='function.pg-lo-import.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_lo_import</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pathname</tt></span> )</div> <p class='para rdfs-comment'> Em vers&amp;otilde;es anteriores a 4.2.0, a sintaxe desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; diferente, veja a seguinte defini&amp;ccedil;&amp;atilde;o: </p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_lo_import</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pathname</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> O argumento <i><tt class='parameter'>pathname</tt></i> especifica o caminho do arquivo a ser importado como um objeto grande (large object). Retorna <b><tt class='constant'>FALSE</tt></b> se um erro ocorrer, caso contr&amp;aacute;rio, retorna o oid do objeto rec&amp;eacute;m criado. </p> <p class='para'> Para usar a interface de objetos grandes (lo) &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Quando o <a href='http://www.php.net/manual/pt_BR/features.safe-mode.php' class='link'>safe-mode</a> est&amp;aacute; ativo, o PHP verifica se os arquivo(s) ou diret&amp;oacute;rios que est&amp;atilde;o usados na opera&amp;ccedil;&amp;atilde;o tem o mesmo UID (propriet&amp;aacute;rio) do script que est&amp;aacute; sendo executado.</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_loimport()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-export.php' class='function'>pg_lo_export()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-lo-open.php' class='function'>pg_lo_open()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_export" value="<div id='function.pg-lo-export' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-export.php'>pg_lo_export</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_export</span> &amp;mdash; <span class='dc-title'>Exporta um objeto grande (large object) para um arquivo</span></p> </div> <a name='function.pg-lo-export.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_lo_export</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$oid</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pathname</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> O argumento <i><tt class='parameter'>oid</tt></i> especifica o oid do objeto grande (large object) a exportar e o argumento <i><tt class='parameter'>pathname</tt></i> especifica o caminho at&amp;eacute; o arquivo. Retorna <b><tt class='constant'>FALSE</tt></b> se um erro ocorrer, caso contr&amp;aacute;rio retorna <b><tt class='constant'>TRUE</tt></b>. </p> <p class='para'> Para usar a interface de objetos grandes (lo), &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_loexport()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-import.php' class='function'>pg_lo_import()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_create" value="<div id='function.pg-lo-create' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-create.php'>pg_lo_create</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_create</span> &amp;mdash; <span class='dc-title'>Cria um objeto grande (large object)</span></p> </div> <a name='function.pg-lo-create.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_lo_create</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_create()</b> cria um Objeto Grande (Large Object) e retorna o seu <var class='varname'>oid</var>. <i><tt class='parameter'>connection</tt></i> especifica uma conex&amp;atilde;o a um banco de dados v&amp;aacute;lida aberta por <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> ou <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. Os modos de acesso INV_READ, INV_WRITE e INV_ARCHIVE n&amp;atilde;o s&amp;atilde;o suportados, o objeto &amp;eacute; criado sempre com acesso a leitura e escrita. INV_ARCHIVE foi removido do pr&amp;oacute;prio PostgreSQL (a partir da 6.3). Retorna o oid do objeto. Retorna <b><tt class='constant'>FALSE</tt></b> se um erro ocorrer. </p> <p class='para'> Para usar a interface de objetos grandes (lo), &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_locreate()</i>. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_lo_close" value="<div id='function.pg-lo-close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-lo-close.php'>pg_lo_close</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_lo_close</span> &amp;mdash; <span class='dc-title'>Fecha um objeto grande (large object)</span></p> </div> <a name='function.pg-lo-close.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_lo_close</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$large_object</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_lo_close()</b> fecha um Objeto Grande (Large Object, da&amp;iacute; vem o &amp;quot;lo&amp;quot; que integra o nome da fun&amp;ccedil;&amp;atilde;o). <i><tt class='parameter'>large_object</tt></i> &amp;eacute; um recurso (resource) para o objeto grande gerado a partir de <a href='http://www.php.net/manual/pt_BR/function.pg-lo-open.php' class='function'>pg_lo_open()</a>. </p> <p class='para'> Para usar a interface de objetos grandes (lo), &amp;eacute; necess&amp;aacute;rio encapsul&amp;aacute;-lo em um bloco de transa&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_loclose()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-lo-open.php' class='function'>pg_lo_open()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-lo-create.php' class='function'>pg_lo_create()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-lo-import.php' class='function'>pg_lo_import()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_last_oid" value="<div id='function.pg-last-oid' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-last-oid.php'>pg_last_oid</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_last_oid</span> &amp;mdash; <span class='dc-title'>Retorna o &amp;uacute;ltimo oid do objeto</span></p> </div> <a name='function.pg-last-oid.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_last_oid</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_last_oid()</b> &amp;eacute; usado para recuperar o <var class='varname'>oid</var> designado a uma linha (registro) se o recurso (resource) de resultado &amp;eacute; usado a partir do &amp;uacute;ltimo comando enviado atrav&amp;eacute;s de <b>pq_query()</b> se este comando era um INSERT do SQL. Retorna um inteiro positivo se havia um <var class='varname'>oid</var> v&amp;aacute;lido. Retorna <b><tt class='constant'>FALSE</tt></b> se um erro ocorrer ou o &amp;uacute;ltimo comando enviado atrav&amp;eacute;s de <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> n&amp;atilde;o foi INSERT ou se o INSERT falhou. </p> <p class='para'> O campo OID tornou-se opcional a partir do PostgreSQL 7.2. Quando um campo OID n&amp;atilde;o &amp;eacute; definido em uma tabela, o programador deve usar <a href='http://www.php.net/manual/pt_BR/function.pg-result-status.php' class='function'>pg_result_status()</a> para checar se o registro foi inserido com sucesso ou n&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_getlastoid()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-result-status.php' class='function'>pg_result_status()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_last_notice" value="<div id='function.pg-last-notice' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-last-notice.php'>pg_last_notice</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_last_notice</span> &amp;mdash; <span class='dc-title'> Retorna a &amp;uacute;ltima notifica&amp;ccedil;&amp;atilde;o do servidor PostgreSQL </span></p> </div> <a name='function.pg-last-notice.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_last_notice</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_last_notice()</b> retorna a &amp;uacute;ltima notifica&amp;ccedil;&amp;atilde;o do servidor PostgreSQL especificada por <i><tt class='parameter'>connection</tt></i> . O servidor PostgreSQL envia notifica&amp;ccedil;&amp;otilde;es em diversas situa&amp;ccedil;&amp;otilde;es, por exemplo, se as transa&amp;ccedil;&amp;otilde;es n&amp;atilde;o puderem continuar. Com <b>pg_last_notice()</b> voc&amp;ecirc; pode evitar a chamada de consultas (queries) in&amp;uacute;teis, checando quando a notifica&amp;ccedil;&amp;atilde;o est&amp;aacute; relacionada ou n&amp;atilde;o com a transa&amp;ccedil;&amp;atilde;o. </p> <div class='warning'><b class='warning'>Aviso</b> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; EXPERIMENTAL e ainda n&amp;atilde;o est&amp;aacute; completamente implementada. <b>pg_last_notice()</b> foi adicionada no PHP 4.0.6. Entretanto o PHP 4.0.6 tem problemas com a manipula&amp;ccedil;&amp;atilde;o de mensagens. O uso do m&amp;oacute;dulo PostgreSQL com o PHP 4.0.6 n&amp;atilde;o &amp;eacute; recomendada, mesmo se voc&amp;ecirc; n&amp;atilde;o estiver usando <b>pg_last_notice()</b>. </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o est&amp;aacute; totalmente implementada no PHP 4.3.0. Vers&amp;otilde;es do PHP mais recentes que a 4.3.0 ignoram o par&amp;acirc;metro de conex&amp;atilde;o com o banco de dados. </p> </div> <p class='para'> O rastreamento de notifica&amp;ccedil;&amp;otilde;es pode ser definido como opcional definindo 1 para a diretiva <i>pgsql.ignore_notice</i> no <var class='filename'>php.ini</var> do PHP 4.3.0. </p> <p class='para'> O arquivamento (log) de mensagems pode ser pode ser definido como opcional mudando para 0 a diretiva <i>pgsql.log_notice</i> no <var class='filename'>php.ini</var> do PHP 4.3.0. A n&amp;atilde;o ser que <i>pgsql.ignore_notice</i> estiver definida para 0, notifica&amp;ccedil;&amp;otilde;es n&amp;atilde;o podem ser arquivadas. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-last-error.php' class='function'>pg_last_error()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_last_error" value="<div id='function.pg-last-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-last-error.php'>pg_last_error</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_last_error</span> &amp;mdash; <span class='dc-title'>Retorna a string da &amp;uacute;ltima mensagem de erro de uma conex&amp;atilde;o</span></p> </div> <a name='function.pg-last-error.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_last_error</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_last_error()</b> retorna a &amp;uacute;ltima mensagem de erro para a conex&amp;atilde;o representada por <i><tt class='parameter'>connection</tt></i> . </p> <p class='para'> As mensagens de erro podem ser sobrescritas por chamadas internas ao PostgreSQL(libpq). Se m&amp;uacute;ltiplos erros ocorrerem dentro de um m&amp;oacute;dulo de fun&amp;ccedil;&amp;atilde;o do PostgreSQL, pode n&amp;atilde;o retornar a mensagem de erro correta. </p> <p class='para'> Use <a href='http://www.php.net/manual/pt_BR/function.pg-result-error.php' class='function'>pg_result_error()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-result-status.php' class='function'>pg_result_status()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-connection-status.php' class='function'>pg_connection_status()</a> para um melhor tratamento de erros. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_errormessage()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-result-error.php' class='function'>pg_result_error()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_insert" value="<div id='function.pg-insert' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-insert.php'>pg_insert</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_insert</span> &amp;mdash; <span class='dc-title'> Insere um array na tabela </span></p> </div> <a name='function.pg-insert.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_insert</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$assoc_array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_insert()</b> insere os valores de <i><tt class='parameter'>assoc_array</tt></i> na tabela especificada por <i><tt class='parameter'>table_name</tt></i> . <i><tt class='parameter'>table_name</tt></i> deve ter no m&amp;iacute;nimo tantas colunas quanto forem os elementos em <i><tt class='parameter'>assoc_array</tt></i> . Os nomes dos campos assim como os valores em <i><tt class='parameter'>table_name</tt></i> devem ser iguais aos &amp;iacute;ndices e valores de <i><tt class='parameter'>assoc_array</tt></i> . Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. Se o par&amp;acirc;metro <i><tt class='parameter'>options</tt></i> for especificado, <b>pg_insert()</b> &amp;eacute; aplicado em <i><tt class='parameter'>assoc_array</tt></i> com a op&amp;ccedil;&amp;atilde;o especificada. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 pg_insert</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=meubanco'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Isto&amp;nbsp;&amp;eacute;&amp;nbsp;seguro&amp;nbsp;uma&amp;nbsp;vez&amp;nbsp;que&amp;nbsp;$_POST&amp;nbsp;&amp;eacute;&amp;nbsp;convertido&amp;nbsp;automaticamente<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_insert</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'post_log'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$_POST</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Dados&amp;nbsp;POST&amp;nbsp;arquivados&amp;nbsp;com&amp;nbsp;sucesso\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;usu&amp;aacute;rio&amp;nbsp;deve&amp;nbsp;ter&amp;nbsp;inserido&amp;nbsp;entradas&amp;nbsp;inv&amp;aacute;lidas\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <div class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; <em class='emphasis'>EXPERIMENTAL</em>. O comportamento desta fun&amp;ccedil;&amp;atilde;o, seu nome, incluindo toda documenta&amp;ccedil;&amp;atilde;o pode ser modificado sem aviso em futuras vers&amp;otilde;es do PHP. Esta fun&amp;ccedil;&amp;atilde;o deve ser usada por sua pr&amp;oacute;pria conta e risco.</p></div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_host" value="<div id='function.pg-host' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-host.php'>pg_host</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_host</span> &amp;mdash; <span class='dc-title'> Retorna o nome da m&amp;aacute;quina associada a uma conex&amp;atilde;o </span></p> </div> <a name='function.pg-host.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_host</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_host()</b> retorna o nome da m&amp;aacute;quina com a qual o recurso (resource) de conex&amp;atilde;o <i><tt class='parameter'>connection</tt></i> est&amp;aacute; conectado. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_get_result" value="<div id='function.pg-get-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-get-result.php'>pg_get_result</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_get_result</span> &amp;mdash; <span class='dc-title'> Retorna o resultado de uma consulta (query) ass&amp;iacute;ncrona </span></p> </div> <a name='function.pg-get-result.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_get_result</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_get_result()</b> retorna o recurso (resource) de resultado de uma consulta (query) executada por <b>ps_send_query()</b>. <a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function'>pg_send_query()</a> pode enviar m&amp;uacute;ltiplas consultas (queries) ao servidor PostgreSQL e <b>pg_get_result()</b> &amp;eacute; usada para carregar os resultados das consultas, um por um. Retorna o recurso (resource) de resultado. Se n&amp;atilde;o houverem mais resultados, retorna <b><tt class='constant'>FALSE</tt></b>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_get_pid" value="<div id='function.pg-get-pid' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-get-pid.php'>pg_get_pid</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_get_pid</span> &amp;mdash; <span class='dc-title'>Gets the backend&amp;#039;s process ID</span></p> </div> <a name='function.pg-get-pid.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_get_pid</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_get_pid()</b> gets the backend&amp;#039;s (database server process) PID. The PID is useful to determine whether or not a <i>NOTIFY</i> message received via <a href='http://www.php.net/manual/pt_BR/function.pg-get-notify.php' class='function'>pg_get_notify()</a> is sent from another process or not. </p> </div> <a name='function.pg-get-pid.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-get-pid.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The backend database process ID. </p> </div> <a name='function.pg-get-pid.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 PostgreSQL backend PID</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'An&amp;nbsp;error&amp;nbsp;occured.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Backend&amp;nbsp;process&amp;nbsp;PID.&amp;nbsp;Use&amp;nbsp;PID&amp;nbsp;with&amp;nbsp;pg_get_notify()<br /></span><span style='color: #0000BB'>$pid&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_pid</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-get-pid.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-get-notify.php' class='function' rel='rdfs-seeAlso'>pg_get_notify()</a> - Gets SQL NOTIFY message</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_get_notify" value="<div id='function.pg-get-notify' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-get-notify.php'>pg_get_notify</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_get_notify</span> &amp;mdash; <span class='dc-title'>Gets SQL NOTIFY message</span></p> </div> <a name='function.pg-get-notify.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_get_notify</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$result_type</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_get_notify()</b> gets notifications generated by a <i>NOTIFY</i> SQL command. To receive notifications, the <i>LISTEN</i> SQL command must be issued. </p> </div> <a name='function.pg-get-notify.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An optional parameter that controls how the returned <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> is indexed. <i><tt class='parameter'>result_type</tt></i> is a constant and can take the following values: <b><tt class='constant'>PGSQL_ASSOC</tt></b>, <b><tt class='constant'>PGSQL_NUM</tt></b> and <b><tt class='constant'>PGSQL_BOTH</tt></b>. Using <b><tt class='constant'>PGSQL_NUM</tt></b>, <b>pg_get_notify()</b> will return an array with numerical indices, using <b><tt class='constant'>PGSQL_ASSOC</tt></b> it will return only associative indices while <b><tt class='constant'>PGSQL_BOTH</tt></b>, the default, will return both numerical and associative indices. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-get-notify.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> containing the <i>NOTIFY</i> message name and backend PID. Otherwise if no <i>NOTIFY</i> is waiting, then <b><tt class='constant'>FALSE</tt></b> is returned. </p> </div> <a name='function.pg-get-notify.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 PostgreSQL NOTIFY message</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'An&amp;nbsp;error&amp;nbsp;occured.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Listen&amp;nbsp;'author_updated'&amp;nbsp;message&amp;nbsp;from&amp;nbsp;other&amp;nbsp;processes<br /></span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'LISTEN&amp;nbsp;author_updated;'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$notify&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_get_notify</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$notify</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'No&amp;nbsp;messages\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$notify</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-get-notify.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-get-pid.php' class='function' rel='rdfs-seeAlso'>pg_get_pid()</a> - Gets the backend's process ID</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_free_result" value="<div id='function.pg-free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-free-result.php'>pg_free_result</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_free_result</span> &amp;mdash; <span class='dc-title'>Libera a mem&amp;oacute;ria usada pelo resultado</span></p> </div> <a name='function.pg-free-result.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_free_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_free_result()</b> precisa ser usada apenas se voc&amp;ecirc; est&amp;aacute; preocupado em usar muita mem&amp;oacute;ria enquanto seu script est&amp;aacute; rodando. Todos os resultados ser&amp;atilde;o liberados da mem&amp;oacute;ria automaticamente assim que o script terminar de executar. Mas, se voc&amp;ecirc; tem certeza que n&amp;atilde;o precisar&amp;aacute; mais dos dados do resultado em um script, voc&amp;ecirc; pode chamar <b>pg_free_result()</b> com o recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> como argumento e a mem&amp;oacute;ria ocupada pelo resultado associado ser&amp;aacute; liberada. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_field_len()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_type_oid" value="<div id='function.pg-field-type-oid' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-type-oid.php'>pg_field_type_oid</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_field_type_oid</span> &amp;mdash; <span class='dc-title'> Returns the type ID (OID) for the corresponding field number </span></p> </div> <a name='function.pg-field-type-oid.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_field_type_oid</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_type_oid()</b> returns an integer containing the OID of the base type of the given <i><tt class='parameter'>field_number</tt></i> in the given PostgreSQL <i><tt class='parameter'>result</tt></i> resource. </p> <p class='para'> You can get more information about the field type by querying PostgreSQL&amp;#039;s <i>pg_type</i> system table using the OID obtained with this function. The PostgreSQL <b>format_type()</b> function will convert a type OID into an SQL standard type name. </p> <blockquote><p><b class='note'>Nota</b>: If the field uses a PostgreSQL domain (rather than a basic type), it is the OID of the domain&amp;#039;s underlying type that is returned, rather than the OID of the domain itself. <br /> </p></blockquote> </div> <a name='function.pg-field-type-oid.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL query result resource, returned by <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function'>pg_execute()</a> (among others). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Field number, starting from 0. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-field-type-oid.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The OID of the field&amp;#039;s base type. <b><tt class='constant'>FALSE</tt></b> is returned on error. </p> </div> <a name='function.pg-field-type-oid.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Getting information about fields</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Assume&amp;nbsp;'title'&amp;nbsp;is&amp;nbsp;a&amp;nbsp;varchar&amp;nbsp;type<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;title&amp;nbsp;from&amp;nbsp;authors&amp;nbsp;where&amp;nbsp;author&amp;nbsp;=&amp;nbsp;'Orwell''</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Title&amp;nbsp;field&amp;nbsp;type&amp;nbsp;OID:&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>pg_field_type_oid</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Title field type OID: 1043 </pre></div> </div> </div><p> </p> </div> <a name='function.pg-field-type-oid.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-field-type.php' class='function' rel='rdfs-seeAlso'>pg_field_type()</a> - Retorna o nome do tipo para o campo de nome correspondente</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-field-prtlen.php' class='function' rel='rdfs-seeAlso'>pg_field_prtlen()</a> - Retorna o comprimento impresso</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function' rel='rdfs-seeAlso'>pg_field_name()</a> - Retorna o nome de um campo</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_type" value="<div id='function.pg-field-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-type.php'>pg_field_type</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_field_type</span> &amp;mdash; <span class='dc-title'> Retorna o nome do tipo para o campo de nome correspondente </span></p> </div> <a name='function.pg-field-type.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_field_type</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_type()</b> retorna uma string contendo o nome do tipo do campo de n&amp;uacute;mero <i><tt class='parameter'>field_number</tt></i> dado no recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . A numera&amp;ccedil;&amp;atilde;o de campo inicia-se em 0. </p> <p class='para'> Veja o exemplo dado na pagina <a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function'>pg_field_name()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_fieldtype()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-field-prtlen.php' class='function'>pg_field_prtlen()</a> e <b>pg_field_type()</b>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_table" value="<div id='function.pg-field-table' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-table.php'>pg_field_table</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>pg_field_table</span> &amp;mdash; <span class='dc-title'>Returns the name or oid of the tables field</span></p> </div> <a name='function.pg-field-table.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>pg_field_table</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$oid_only</tt><span class='initializer'> = false</span></span> ] )</div> <p class='para rdfs-comment'> <b>pg_field_table()</b> returns the name of the table that field belongs to, or the table&amp;#039;s oid if <i><tt class='parameter'>oid_only</tt></i> is <b><tt class='constant'>TRUE</tt></b>. </p> </div> <a name='function.pg-field-table.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL query result resource, returned by <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function'>pg_execute()</a> (among others). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Field number, starting from 0. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>oid_only</tt></i> </span> </dt><dd class='listitem'> <p class='para'> By default the tables name that field belongs to is returned but if <i><tt class='parameter'>oid_only</tt></i> is set to <b><tt class='constant'>TRUE</tt></b>, then the oid will instead be returned. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-field-table.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> On success either the fields table name or oid. Or, <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.pg-field-table.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Getting table information about a field</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;bar&amp;nbsp;FROM&amp;nbsp;foo'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>pg_field_table</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>pg_field_table</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;version()'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>pg_field_table</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> foo 14379580 bool(false) </pre></div> </div> </div><p> </p> </div> <a name='function.pg-field-table.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Returning the oid is much faster than returning the table name because fetching the table name requires a query to the database system table. <br /> </p></blockquote> </div> <a name='function.pg-field-table.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function' rel='rdfs-seeAlso'>pg_field_name()</a> - Retorna o nome de um campo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-field-type.php' class='function' rel='rdfs-seeAlso'>pg_field_type()</a> - Retorna o nome do tipo para o campo de nome correspondente</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_size" value="<div id='function.pg-field-size' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-size.php'>pg_field_size</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_field_size</span> &amp;mdash; <span class='dc-title'> Retorna o tamanho de armazenamento interno de um campo </span></p> </div> <a name='function.pg-field-size.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_field_size</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_size()</b> retorna o tamanho de armazenamento interno (em bytes) do n&amp;uacute;mero de campo do recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . A numera&amp;ccedil;&amp;atilde;o de campo inicia-se em 0. Um campo de tamanho -1 indica um campo de tamanho vari&amp;aacute;vel. Esta fun&amp;ccedil;&amp;atilde;o retornar&amp;aacute; <b><tt class='constant'>FALSE</tt></b> em caso de erro. </p> <p class='para'> Veja o exemplo dado na pagina <a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function'>pg_field_name()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_fieldsize()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-field-prtlen.php' class='function'>pg_field_prtlen()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-field-type.php' class='function'>pg_field_type()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_prtlen" value="<div id='function.pg-field-prtlen' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-prtlen.php'>pg_field_prtlen</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_field_prtlen</span> &amp;mdash; <span class='dc-title'>Retorna o comprimento impresso</span></p> </div> <a name='function.pg-field-prtlen.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_field_prtlen</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$field_name</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_prtlen()</b> retorna o comprimento atual impresso (n&amp;uacute;mero de caracteres) de um valor especificado em um recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . A numera&amp;ccedil;&amp;atilde;o de linha inicia-se em 0. Esta fun&amp;ccedil;&amp;atilde;o retornar&amp;aacute; -1 em caso de erro. </p> <p class='para'> Veja o exemplo dado na pagina <a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function'>pg_field_name()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_fieldprtlen()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-field-size.php' class='function'>pg_field_size()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_num" value="<div id='function.pg-field-num' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-num.php'>pg_field_num</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_field_num</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero do campo referido</span></p> </div> <a name='function.pg-field-num.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_field_num</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$field_name</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_num()</b> ir&amp;aacute; retornar o n&amp;uacute;mero da vaga (slot) da coluna (campo) que corresponde a <i><tt class='parameter'>field_name</tt></i> no recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . A numera&amp;ccedil;&amp;atilde;o de campo inicia-se em 0. Esta fun&amp;ccedil;&amp;atilde;o retornar&amp;aacute; -1 em caso de erro. </p> <p class='para'> Veja o exemplo dado na pagina <a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function'>pg_field_name()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_fieldnum()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-field-name.php' class='function'>pg_field_name()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_name" value="<div id='function.pg-field-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-name.php'>pg_field_name</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_field_name</span> &amp;mdash; <span class='dc-title'>Retorna o nome de um campo</span></p> </div> <a name='function.pg-field-name.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_field_name</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_name()</b> retorna o nome do campo ocupando o campo de n&amp;uacute;mero igual a <i><tt class='parameter'>field_number</tt></i> no recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . A numera&amp;ccedil;&amp;atilde;o de campo inicia-se em 0. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Getting informations about fields</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;authors&amp;nbsp;where&amp;nbsp;author&amp;nbsp;=&amp;nbsp;'Orwell''</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_num_fields</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;for&amp;nbsp;(</span><span style='color: #0000BB'>$j&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$j&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>++)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'column&amp;nbsp;</span><span style='color: #0000BB'>$j</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$fieldname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_field_name</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'fieldname:&amp;nbsp;</span><span style='color: #0000BB'>$fieldname</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'printed&amp;nbsp;length:&amp;nbsp;'</span><span style='color: #007700'>.</span><span style='color: #0000BB'>pg_field_prtlen</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$fieldname</span><span style='color: #007700'>).</span><span style='color: #DD0000'>'&amp;nbsp;characters\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'storage&amp;nbsp;length:&amp;nbsp;'</span><span style='color: #007700'>.</span><span style='color: #0000BB'>pg_field_size</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>).</span><span style='color: #DD0000'>'&amp;nbsp;bytes\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'field&amp;nbsp;type:&amp;nbsp;'</span><span style='color: #007700'>.</span><span style='color: #0000BB'>pg_field_type</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>).</span><span style='color: #DD0000'>'&amp;nbsp;\n\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> The above example would produce the following output: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> column 0 fieldname: author printed length: 6 characters storage length: -1 bytes field type: varchar column 1 fieldname: year printed length: 4 characters storage length: 2 bytes field type: int2 column 2 fieldname: title printed length: 24 characters storage length: -1 bytes field type: varchar </pre></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_fieldname()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-field-num.php' class='function'>pg_field_num()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_field_is_null" value="<div id='function.pg-field-is-null' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-field-is-null.php'>pg_field_is_null</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_field_is_null</span> &amp;mdash; <span class='dc-title'>Testa se o campo &amp;eacute; <b><tt class='constant'>NULL</tt></b></span></p> </div> <a name='function.pg-field-is-null.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_field_is_null</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$field</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_field_is_null()</b> testa se um campo &amp;eacute; <b><tt class='constant'>NULL</tt></b> ou n&amp;atilde;o. Retorna 1 se o campo na linha dada &amp;eacute; <b><tt class='constant'>NULL</tt></b>. Retorna 0 se o campo na linha dada N&amp;Atilde;O &amp;eacute; <b><tt class='constant'>NULL</tt></b>. O campo pode ser especificado como um &amp;iacute;ndice de coluna (n&amp;uacute;mero) ou como o nome de um campo (string). A numera&amp;ccedil;&amp;atilde;o de linhas inicia-se em 0. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_field_is_null()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die&amp;nbsp;(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;authors&amp;nbsp;where&amp;nbsp;author&amp;nbsp;=&amp;nbsp;'Orwell''</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>pg_field_is_null</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ano'</span><span style='color: #007700'>)&amp;nbsp;==&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;valor&amp;nbsp;do&amp;nbsp;campo&amp;nbsp;ano&amp;nbsp;&amp;eacute;&amp;nbsp;null.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>pg_field_is_null</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ano'</span><span style='color: #007700'>)&amp;nbsp;==&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;valor&amp;nbsp;do&amp;nbsp;campo&amp;nbsp;ano&amp;nbsp;n&amp;atilde;o&amp;nbsp;&amp;eacute;&amp;nbsp;null.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o era chamada <i>pg_fieldisnull()</i>. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_row" value="<div id='function.pg-fetch-row' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-row.php'>pg_fetch_row</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_fetch_row</span> &amp;mdash; <span class='dc-title'>Retorna uma linha como um array enumerado</span></p> </div> <a name='function.pg-fetch-row.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_fetch_row</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_fetch_row()</b> retorna uma linha de dados a partir do resultado associado com o recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> . A linha (registro) &amp;eacute; recuperada como um array. Cada coluna do resultado &amp;eacute; armazenada em um &amp;iacute;ndice do array, iniciando-se no &amp;iacute;ndice 0. </p> <p class='para'> Retorna um array que corresponde &amp;agrave; linha carregada, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o existem mais linhas. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retornando linhas (registros) no PostgreSQL</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=editora'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Um&amp;nbsp;erro&amp;nbsp;ocorreu.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;autores'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Um&amp;nbsp;erro&amp;nbsp;ocorreu.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>=</span><span style='color: #0000BB'>pg_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;for(</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>=</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$j&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>count</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>++)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>$j</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;amp;nbsp;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br /><br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: A partir do PHP 4.1.0, <i><tt class='parameter'>row</tt></i> tornou-se opcional. Ao chamar <b>pg_fetch_row()</b>, o contador de linha interno ser&amp;aacute; incrementado em 1. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-object.php' class='function'>pg_fetch_object()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-result.php' class='function'>pg_fetch_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_result" value="<div id='function.pg-fetch-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-result.php'>pg_fetch_result</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_fetch_result</span> &amp;mdash; <span class='dc-title'>Retorna valores a partir de um recurso (resource) de resultado</span></p> </div> <a name='function.pg-fetch-result.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><span class='type misto'>misto</span></span> <span class='methodname'><b>pg_fetch_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$field</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_fetch_result()</b> retorna valores a partir de um recurso (resource) de resultado <i><tt class='parameter'>result</tt></i> criado por <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>. <i><tt class='parameter'>row</tt></i> &amp;eacute; um inteiro. <i><tt class='parameter'>field</tt></i> &amp;eacute; um nome de campo (string) ou um &amp;iacute;ndice de campo (inteiro). <i><tt class='parameter'>row</tt></i> e <i><tt class='parameter'>field</tt></i> especificam que c&amp;eacute;lula da tabela deve ser recuperada. A numera&amp;ccedil;&amp;atilde;o de linhas come&amp;ccedil;a de 0. Ao inv&amp;eacute;s de nomear o campo, voc&amp;ecirc; pode usar o &amp;iacute;ndice num&amp;eacute;rico de campo sem aspas. &amp;Iacute;ndices de campo iniciam-se em 0. </p> <p class='para'> PostgreSQL tem muitos tipos internos mas apenas os tipos b&amp;aacute;sicos s&amp;atilde;o suportados. Todas as formas de tipo <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> s&amp;atilde;o retornadas como valores <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>. Todas as formas de tipos reais (ponto flutuante) s&amp;atilde;o retornados como valores <a href='http://www.php.net/manual/pt_BR/language.types.float.php' class='type float'>float</a>. Boolean &amp;eacute; retornado como &amp;quot;t&amp;quot; ou &amp;quot;f&amp;quot;. Todos os outros tipos, incluindo arrays, s&amp;atilde;o retornados como strings formatadas na mesma maneira padr&amp;atilde;o que o PostgreSQL retornaria com o programa <strong class='command'>psql</strong>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_object" value="<div id='function.pg-fetch-object' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-object.php'>pg_fetch_object</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_fetch_object</span> &amp;mdash; <span class='dc-title'>Retorna uma linha (registro) como um objeto</span></p> </div> <a name='function.pg-fetch-object.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><span class='type objeto'>objeto</span></span> <span class='methodname'><b>pg_fetch_object</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$result_type</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_fetch_object()</b> retorna um objeto com propriedades que correspondem &amp;agrave; linha recuperada. Retorna <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o existem mais linhas ou no caso de erro. </p> <p class='para'> <b>pg_fetch_object()</b> &amp;eacute; similar a <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, com uma diferen&amp;ccedil;a - um objeto &amp;eacute; retornado, ao inv&amp;eacute;s de um array. Indiretamente, isto significa que voc&amp;ecirc; pode acessar os dados somente atrav&amp;eacute;s dos nomes de campos, e n&amp;atilde;o por seus &amp;iacute;ndices (n&amp;uacute;meros s&amp;atilde;o nomes inv&amp;aacute;lidos de propriedades). </p> <p class='para'> <i><tt class='parameter'>row</tt></i> &amp;eacute; o n&amp;uacute;mero da linha (registro) a ser recuperada. A primeira linha &amp;eacute; 0. </p> <p class='para'> Em termos de performance, a fun&amp;ccedil;&amp;atilde;o &amp;eacute; id&amp;ecirc;ntica a <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, e quase t&amp;atilde;o r&amp;aacute;pida quanto <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a> (a diferen&amp;ccedil;a &amp;eacute; insignificante). </p> <blockquote><p><b class='note'>Nota</b>: A partir do PHP 4.1.0, <i><tt class='parameter'>row</tt></i> &amp;eacute; opcional. <br /> A partir do PHP 4.3.0, <i><tt class='parameter'>result_type</tt></i> tem PGSQL_ASSOC como valor padr&amp;atilde;o, enquanto em outras vers&amp;otilde;es mais antigas o padr&amp;atilde;o &amp;eacute; PGSQL_BOTH. N&amp;atilde;o h&amp;aacute; utilidade para a propriedade num&amp;eacute;rica, j&amp;aacute; que nomes de propriedades num&amp;eacute;ricas s&amp;atilde;o inv&amp;aacute;lidas em PHP. <br /> O par&amp;acirc;metro <i><tt class='parameter'>result_type</tt></i> dever&amp;aacute; ser removido em vers&amp;otilde;es futuras. <br /> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Postgres fetch object</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br /><br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'store'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$db_conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'host=localhost&amp;nbsp;port=5432&amp;nbsp;dbname=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$db_conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Failed&amp;nbsp;connecting&amp;nbsp;to&amp;nbsp;postgres&amp;nbsp;database&amp;nbsp;</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$qu&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;books&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;author'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;postgres&amp;nbsp;needs&amp;nbsp;a&amp;nbsp;row&amp;nbsp;counter&amp;nbsp;<br /><br /></span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$qu</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>author&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;('</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>year&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'):&amp;nbsp;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>title&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>++;<br />}<br /><br /></span><span style='color: #0000BB'>pg_free_result&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$qu</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>pg_close&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db_conn</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: A partir do PHP 4.1.0, <i><tt class='parameter'>row</tt></i> tornou-se opcional. Ao chamar <b>pg_fetch_object()</b> o contador de linhas interno ser&amp;aacute; acrescentado de 1. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-result.php' class='function'>pg_fetch_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_assoc" value="<div id='function.pg-fetch-assoc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-assoc.php'>pg_fetch_assoc</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_fetch_assoc</span> &amp;mdash; <span class='dc-title'>Retorna uma linha (registro) como uma matriz associativa</span></p> </div> <a name='function.pg-fetch-assoc.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_fetch_assoc</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_fetch_assoc()</b> retorna um array associativo que corresponde &amp;agrave; linha (registro) recuperado. Retorna <b><tt class='constant'>FALSE</tt></b>, se n&amp;atilde;o houver mais registros. </p> <p class='para'> <b>pg_fetch_assoc()</b> &amp;eacute; equivalente a usar <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a> com PGSQL_ASSOC para o terceiro par&amp;acirc;metro. Ela guarda dados em matrizes com chaves associativas (nome do campo). Se voc&amp;ecirc; precisar utilizar os &amp;iacute;ndices num&amp;eacute;ricos use <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>. </p> <p class='para'> <i><tt class='parameter'>row</tt></i> &amp;eacute; o n&amp;uacute;mero da linha (registro) a ser recuperado. A primeira linha &amp;eacute; 0. </p> <p class='para'> <b>pg_fetch_assoc()</b> N&amp;Atilde;O &amp;eacute; significativamente mais lenta que <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>, e ainda fornece uma significativa facilidade de uso. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retornando linhas (registros) no PostgreSQL</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=revista'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Ocorreu&amp;nbsp;um&amp;nbsp;erro.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;authors'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Ocorreu&amp;nbsp;um&amp;nbsp;erro.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'id'</span><span style='color: #007700'>];<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'author'</span><span style='color: #007700'>];<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'email'</span><span style='color: #007700'>];<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-object.php' class='function'>pg_fetch_object()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-result.php' class='function'>pg_fetch_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_array" value="<div id='function.pg-fetch-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-array.php'>pg_fetch_array</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_fetch_array</span> &amp;mdash; <span class='dc-title'>Retorna uma linha (registro) como um array</span></p> </div> <a name='function.pg-fetch-array.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_fetch_array</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$result_type</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>pg_fetch_array()</b> retorna um array que corresponde &amp;agrave; linha (registro). Retorna <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o existem mais linhas. </p> <p class='para'> <b>pg_fetch_array()</b> &amp;eacute; uma vers&amp;atilde;o extendida de <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>. Al&amp;eacute;m de armazenar os dados em &amp;iacute;ndices num&amp;eacute;ricos (&amp;iacute;ndice) no array resultante, tamb&amp;eacute;m armazena os dados em chaves associativas (nome do campo) por padr&amp;atilde;o. </p> <p class='para'> <i><tt class='parameter'>row</tt></i> &amp;eacute; o n&amp;uacute;mero da linha (registro) a ser recuperado. A primeira linha &amp;eacute; 0. </p> <p class='para'> <i><tt class='parameter'>result_type</tt></i> &amp;eacute; um par&amp;acirc;metro opcional que controla como o valor de retorno &amp;eacute; iniciado. <i><tt class='parameter'>result_type</tt></i> &amp;eacute; uma constante e pode ter os seguintes valores: <b><tt class='constant'>PGSQL_ASSOC</tt></b>, <b><tt class='constant'>PGSQL_NUM</tt></b>, e <b><tt class='constant'>PGSQL_BOTH</tt></b>. <b>pg_fetch_array()</b> retorna um array associativo que tem o nome de campo como chave para <b><tt class='constant'>PGSQL_ASSOC</tt></b>. &amp;Iacute;ndice de campo como chave com <b><tt class='constant'>PGSQL_NUM</tt></b> e ambos nome/&amp;iacute;ndice num&amp;eacute;rico como chave com <b><tt class='constant'>PGSQL_BOTH</tt></b>. O valor padr&amp;atilde;o &amp;eacute; <b><tt class='constant'>PGSQL_BOTH</tt></b>. </p><blockquote><p><b class='note'>Nota</b>: O par&amp;acirc;metro <i><tt class='parameter'>result_type</tt></i> foi adicionado no PHP 4.0. <br /> </p></blockquote><p> </p> <p class='para'> <b>pg_fetch_array()</b> N&amp;Atilde;O &amp;eacute; significativamente mais lenta que <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>, e ainda fornece uma significativa facilidade de uso. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retornando linhas (registros) no PostgreSQL</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publicar'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Um&amp;nbsp;erro&amp;nbsp;ocorreu.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;autores'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Um&amp;nbsp;erro&amp;nbsp;ororreu.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$arr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_NUM</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$arr</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;lt;-&amp;nbsp;array\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$arr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_ASSOC</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$arr</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'autor'</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;lt;-&amp;nbsp;array\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: A partir do PHP 4.1.0, <i><tt class='parameter'>row</tt></i> tornou-se opcional. A chamada <b>pg_fetch_array()</b> ir&amp;aacute; incrementar o contador de linha interno em 1. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-object.php' class='function'>pg_fetch_object()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-result.php' class='function'>pg_fetch_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_all_columns" value="<div id='function.pg-fetch-all-columns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-all-columns.php'>pg_fetch_all_columns</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_fetch_all_columns</span> &amp;mdash; <span class='dc-title'>Fetches all rows in a particular result column as an array</span></p> </div> <a name='function.pg-fetch-all-columns.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_fetch_all_columns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$column</tt><span class='initializer'> = 0</span></span> ] )</div> <p class='para rdfs-comment'> <b>pg_fetch_all_columns()</b> returns an array that contains all rows (records) in a particular column of the result resource. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o assimila campos NULL para o o <b><tt class='constant'>NULL</tt></b> do PHP.</span></p></blockquote> </div> <a name='function.pg-fetch-all-columns.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL query result resource, returned by <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-execute.php' class='function'>pg_execute()</a> (among others). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Column number, zero-based, to be retrieved from the result resource. Defaults to the first column if not specified. </p> </dd> </dl> <p> </p> </div> <a name='function.pg-fetch-all-columns.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> with all values in the result column. </p> <p class='para'> <b><tt class='constant'>FALSE</tt></b> is returned if <i><tt class='parameter'>column</tt></i> is larger than the number of columns in the result, or on any other error. </p> </div> <a name='function.pg-fetch-all-columns.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_fetch_all_columns()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'An&amp;nbsp;error&amp;nbsp;occured.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;title,&amp;nbsp;name,&amp;nbsp;address&amp;nbsp;FROM&amp;nbsp;authors'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'An&amp;nbsp;error&amp;nbsp;occured.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Get&amp;nbsp;an&amp;nbsp;array&amp;nbsp;of&amp;nbsp;all&amp;nbsp;author&amp;nbsp;names<br /></span><span style='color: #0000BB'>$arr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_fetch_all_columns</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$arr</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-fetch-all-columns.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-fetch-all.php' class='function' rel='rdfs-seeAlso'>pg_fetch_all()</a> - Retorna todas as linhas (registros) como um array</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_fetch_all" value="<div id='function.pg-fetch-all' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-fetch-all.php'>pg_fetch_all</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_fetch_all</span> &amp;mdash; <span class='dc-title'>Retorna todas as linhas (registros) como um array</span></p> </div> <a name='function.pg-fetch-all.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_fetch_all</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_fetch_all()</b> retorna uma array que cont&amp;eacute;m todas as linhas (registros) do recurso (resourse) de resultado. Retorna <b><tt class='constant'>FALSE</tt></b>, se n&amp;atilde;o existem mais registros. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retornando linhas (registros) no PostgreSQL</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php&amp;nbsp;<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=escritor'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Ocorreu&amp;nbsp;um&amp;nbsp;erro!\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;authors'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Ocorreu&amp;nbsp;um&amp;nbsp;erro!\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$arr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_fetch_all</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>PGSQL_NUM</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$arr</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-row.php' class='function'>pg_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-array.php' class='function'>pg_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-object.php' class='function'>pg_fetch_object()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-fetch-result.php' class='function'>pg_fetch_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_execute" value="<div id='function.pg-execute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-execute.php'>pg_execute</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>pg_execute</span> &amp;mdash; <span class='dc-title'>Sends a request to execute a prepared statement with given parameters, and waits for the result.</span></p> </div> <a name='function.pg-execute.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_execute</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$stmtname</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$params</tt></span> )</div> <p class='para rdfs-comment'> Sends a request to execute a prepared statement with given parameters, and waits for the result. </p> <p class='para'> <b>pg_execute()</b> is like <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a>, but the command to be executed is specified by naming a previously-prepared statement, instead of giving a query string. This feature allows commands that will be used repeatedly to be parsed and planned just once, rather than each time they are executed. The statement must have been prepared previously in the current session. <b>pg_execute()</b> is supported only against PostgreSQL 7.4 or higher connections; it will fail when using earlier versions. </p> <p class='para'> The parameters are identical to <a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function'>pg_query_params()</a>, except that the name of a prepared statement is given instead of a query string. </p> </div> <a name='function.pg-execute.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> PostgreSQL database connection resource. When <i><tt class='parameter'>connection</tt></i> is not present, the default connection is used. The default connection is the last connection made by <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmtname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the prepared statement to execute. if &amp;quot;&amp;quot; is specified, then the unnamed statement is executed. The name must have been previously prepared using <a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function'>pg_prepare()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-send-prepare.php' class='function'>pg_send_prepare()</a> or a <i>PREPARE</i> SQL command. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>params</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of parameter values to substitute for the $1, $2, etc. placeholders in the original prepared query string. The number of elements in the array must match the number of placeholders. </p> <div class='warning'><b class='warning'>Aviso</b> <p class='para'> Elements are converted to strings by calling this function. </p> </div> </dd> </dl> <p> </p> </div> <a name='function.pg-execute.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A query result resource on success or <b><tt class='constant'>FALSE</tt></b> on failure.</p> </div> <a name='function.pg-execute.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using <b>pg_execute()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;Connect&amp;nbsp;to&amp;nbsp;a&amp;nbsp;database&amp;nbsp;named&amp;nbsp;'mary'<br /></span><span style='color: #0000BB'>$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=mary'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Prepare&amp;nbsp;a&amp;nbsp;query&amp;nbsp;for&amp;nbsp;execution<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;shops&amp;nbsp;WHERE&amp;nbsp;name&amp;nbsp;=&amp;nbsp;$1'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;prepared&amp;nbsp;query.&amp;nbsp;&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;it&amp;nbsp;is&amp;nbsp;not&amp;nbsp;necessary&amp;nbsp;to&amp;nbsp;escape<br />//&amp;nbsp;the&amp;nbsp;string&amp;nbsp;'Joe's&amp;nbsp;Widgets'&amp;nbsp;in&amp;nbsp;any&amp;nbsp;way<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Joe's&amp;nbsp;Widgets'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;same&amp;nbsp;prepared&amp;nbsp;query,&amp;nbsp;this&amp;nbsp;time&amp;nbsp;with&amp;nbsp;a&amp;nbsp;different&amp;nbsp;parameter<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_query'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'Clothes&amp;nbsp;Clothes&amp;nbsp;Clothes'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.pg-execute.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-prepare.php' class='function' rel='rdfs-seeAlso'>pg_prepare()</a> - Submits a request to create a prepared statement with the given parameters, and waits for completion.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-send-prepare.php' class='function' rel='rdfs-seeAlso'>pg_send_prepare()</a> - Sends a request to create a prepared statement with the given parameters, without waiting for completion.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pg-query-params.php' class='function' rel='rdfs-seeAlso'>pg_query_params()</a> - Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text.</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_escape_string" value="<div id='function.pg-escape-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-escape-string.php'>pg_escape_string</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_escape_string</span> &amp;mdash; <span class='dc-title'> Gera string para o tipo text/char </span></p> </div> <a name='function.pg-escape-string.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_escape_string</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_escape_string()</b> gera strings do tipo text/chat. Retorna uma string com escapes para PostgreSQL. O uso desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; recomendado no lugar de <a href='http://www.php.net/manual/pt_BR/function.addslashes.php' class='function'>addslashes()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o exige PostgreSQL 7.2 ou superior. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-escape-bytea.php' class='function'>pg_escape_bytea()</a> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_escape_bytea" value="<div id='function.pg-escape-bytea' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-escape-bytea.php'>pg_escape_bytea</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_escape_bytea</span> &amp;mdash; <span class='dc-title'> Gera bin&amp;aacute;rios para o tipo bytea </span></p> </div> <a name='function.pg-escape-bytea.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_escape_bytea</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_escape_bytea()</b> gera uma string do tipo bytea. Retorna uma string com escapes. </p> <blockquote><p><b class='note'>Nota</b>: Quando voc&amp;ecirc; usa SELECT bytea type, o PostgreSQL retorna valores de byte octais prefixados por \ (ex.: \032). Usu&amp;aacute;rios devem converter de volta para bin&amp;aacute;rios por si mesmos. <br /> Esta fun&amp;ccedil;&amp;atilde;o exige PostgreSQL 7.2 ou superior. Com PostgreSQL 7.2.0 e 7.2.1, o tipo de dados bytea deve ser criado quando voc&amp;ecirc; habilita o suporte a multi-byte. Por exemplo, <i>INSERT INTO tabela_teste (imagem) VALUES (&amp;#039;$imagem_escaped&amp;#039;::bytea);</i> PostgreSQL 7.2.2 ou superior n&amp;atilde;o precisa de coer&amp;ccedil;&amp;atilde;o (cast). A exce&amp;ccedil;&amp;atilde;o &amp;eacute; quando a codifica&amp;ccedil;&amp;atilde;o de caracteres do cliente e do backend n&amp;atilde;o combinam, ent&amp;atilde;o pode haver erro de fluxo de multi-byte. O usu&amp;aacute;rio deve fazer a coer&amp;ccedil;&amp;atilde;o (cast) para bytea para evitar este erro. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m: <a href='http://www.php.net/manual/pt_BR/function.pg-unescape-bytea.php' class='function'>pg_unescape_bytea()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-escape-string.php' class='function'>pg_escape_string()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_end_copy" value="<div id='function.pg-end-copy' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-end-copy.php'>pg_end_copy</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_end_copy</span> &amp;mdash; <span class='dc-title'>Sincroniza com o backend PostgreSQL</span></p> </div> <a name='function.pg-end-copy.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_end_copy</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_end_copy()</b> sincroniza o frontend PostgreSQL (geralmente um processo de servidor HTTP) com o servidor PostgreSQL depois de fazer uma opera&amp;ccedil;&amp;atilde;o de c&amp;oacute;pia usando <a href='http://www.php.net/manual/pt_BR/function.pg-put-line.php' class='function'>pg_put_line()</a>. <b>pg_end_copy()</b> deve ser chamada, caso contr&amp;aacute;rio o servidor PostgreSQL pode perder a sincronia com o frontend fazendo com que o servidor gere um erro. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <p class='para'> Para maiores detalhes e um exemplo, veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-put-line.php' class='function'>pg_put_line()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_delete" value="<div id='function.pg-delete' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-delete.php'>pg_delete</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_delete</span> &amp;mdash; <span class='dc-title'> Remove registros. </span></p> </div> <a name='function.pg-delete.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>pg_delete</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$assoc_array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_delete()</b> remove registros que seguem a condi&amp;ccedil;&amp;atilde;o especificada por <i>assoc_array</i> que tem o formato <i>campo =&amp;gt; valor</i>. Se <i>options</i> for especificado, <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a> &amp;eacute; aplicada a <i>assoc_array</i> com a op&amp;ccedil;&amp;atilde;o especificada. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 pg_delete</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=flavia'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Isto&amp;nbsp;&amp;eacute;&amp;nbsp;seguro,&amp;nbsp;j&amp;aacute;&amp;nbsp;que&amp;nbsp;$_POST&amp;nbsp;&amp;eacute;&amp;nbsp;convertido&amp;nbsp;automaticamente<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_delete</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'post_log'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$_POST</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Dados&amp;nbsp;de&amp;nbsp;POST&amp;nbsp;foram&amp;nbsp;removidos:&amp;nbsp;</span><span style='color: #0000BB'>$res</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;usu&amp;aacute;rio&amp;nbsp;deve&amp;nbsp;ter&amp;nbsp;enviado&amp;nbsp;par&amp;acirc;metros&amp;nbsp;inv&amp;aacute;lidos\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <div class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; <em class='emphasis'>EXPERIMENTAL</em>. O comportamento desta fun&amp;ccedil;&amp;atilde;o, seu nome, incluindo toda documenta&amp;ccedil;&amp;atilde;o pode ser modificado sem aviso em futuras vers&amp;otilde;es do PHP. Esta fun&amp;ccedil;&amp;atilde;o deve ser usada por sua pr&amp;oacute;pria conta e risco.</p></div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-convert.php' class='function'>pg_convert()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_dbname" value="<div id='function.pg-dbname' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-dbname.php'>pg_dbname</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_dbname</span> &amp;mdash; <span class='dc-title'>Retorna o nome do banco de dados</span></p> </div> <a name='function.pg-dbname.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_dbname</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_dbname()</b> retorna o nome do banco de dados para um dado recurso (resource) de conex&amp;atilde;o <i><tt class='parameter'>connection</tt></i> . Retorna <b><tt class='constant'>FALSE</tt></b>, se <i><tt class='parameter'>connection</tt></i> n&amp;atilde;o &amp;eacute; um recurso de conex&amp;atilde;o PostgreSQL v&amp;aacute;lido. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_dbname()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;error_reporting</span><span style='color: #007700'>(</span><span style='color: #0000BB'>E_ALL</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'host=localhost&amp;nbsp;port=5432&amp;nbsp;dbname=mary'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>pg_dbname</span><span style='color: #007700'>();&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;mary<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_copy_to" value="<div id='function.pg-copy-to' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-copy-to.php'>pg_copy_to</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_copy_to</span> &amp;mdash; <span class='dc-title'> Copia uma tabela em um array </span></p> </div> <a name='function.pg-copy-to.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_copy_to</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$delimiter</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$null_as</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>pg_copy_to()</b> copia uma tabela em um array. Utiliza internamente o comando SQL <i>COPY TO</i> para inserir os registros. Seu retorno &amp;eacute; o array resultante. Caso haja falhas, <b><tt class='constant'>FALSE</tt></b> &amp;eacute; retornado. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-copy-from.php' class='function'>pg_copy_from()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_copy_from" value="<div id='function.pg-copy-from' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-copy-from.php'>pg_copy_from</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_copy_from</span> &amp;mdash; <span class='dc-title'> Insere registros em uma tabela a partir de um array </span></p> </div> <a name='function.pg-copy-from.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_copy_from</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$rows</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$delimiter</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$null_as</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>pg_copy_from()</b> insere registros em uma tabela a partir de <i><tt class='parameter'>rows</tt></i> . Usa o comando interno <i>COPY FROM</i> para inserir registros. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-copy-to.php' class='function'>pg_copy_to()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_convert" value="<div id='function.pg-convert' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-convert.php'>pg_convert</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_convert</span> &amp;mdash; <span class='dc-title'> Converte os valores de um array associativo em uma declara&amp;ccedil;&amp;atilde;o SQL apropriada. </span></p> </div> <a name='function.pg-convert.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>pg_convert</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$assoc_array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_convert()</b> checa e converte <i>assoc_array</i> em uma declara&amp;ccedil;&amp;atilde;o SQL apropriada. Pr&amp;eacute;-condi&amp;ccedil;&amp;atilde;o para <b>pg_convert()</b> &amp;eacute; a existencia de uma tabela <i>table_name</i> a qual teve ter tantos campos quantos os elementos em <i>assoc_array</i>. Os nomes dos campos em e os valores em <i>table_name</i> devem ser iguais aos &amp;iacute;ndices e valores em <i>assoc_array</i>. Retorna uma matriz com os valores convertidos em caso de sucesso ou se n&amp;atilde;o, <b><tt class='constant'>FALSE</tt></b>. </p> <div class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; <em class='emphasis'>EXPERIMENTAL</em>. O comportamento desta fun&amp;ccedil;&amp;atilde;o, seu nome, incluindo toda documenta&amp;ccedil;&amp;atilde;o pode ser modificado sem aviso em futuras vers&amp;otilde;es do PHP. Esta fun&amp;ccedil;&amp;atilde;o deve ser usada por sua pr&amp;oacute;pria conta e risco.</p></div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-meta-data.php' class='function'>pg_meta_data()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_connection_status" value="<div id='function.pg-connection-status' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-connection-status.php'>pg_connection_status</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_connection_status</span> &amp;mdash; <span class='dc-title'> Retorna o status da conex&amp;atilde;o </span></p> </div> <a name='function.pg-connection-status.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_connection_status</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_connection_status()</b> retorna o status da conex&amp;atilde;o. Os status poss&amp;iacute;veis s&amp;atilde;o <i>PGSQL_CONNECTION_OK</i> e <i>PGSQL_CONNECTION_BAD</i>. O valor de retorno 0 inteiro indica uma conex&amp;atilde;o bem sucedida. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_connection_status()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stat&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connection_status</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$stat&amp;nbsp;</span><span style='color: #007700'>===&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;status&amp;nbsp;ok'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;status&amp;nbsp;bad'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connection-busy.php' class='function'>pg_connection_busy()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_connection_reset" value="<div id='function.pg-connection-reset' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-connection-reset.php'>pg_connection_reset</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_connection_reset</span> &amp;mdash; <span class='dc-title'> Reinicia uma conex&amp;atilde;o (reconecta) </span></p> </div> <a name='function.pg-connection-reset.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_connection_reset</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_connection_reset()</b> reinicia uma conex&amp;atilde;o. &amp;Eacute; &amp;uacute;til para recupera&amp;ccedil;&amp;atilde;o de erros. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_connection_reset()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$dbconn2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connection_reset</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$dbconn2</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'reset&amp;nbsp;successful\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'reset&amp;nbsp;failed\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connect.php' class='function'>pg_connect()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-connection-status.php' class='function'>pg_connection_status()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_connection_busy" value="<div id='function.pg-connection-busy' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-connection-busy.php'>pg_connection_busy</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_connection_busy</span> &amp;mdash; <span class='dc-title'> Verifica se a conex&amp;atilde;o est&amp;aacute; ocupada ou n&amp;atilde;o </span></p> </div> <a name='function.pg-connection-busy.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_connection_busy</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_connection_busy()</b> retorna <b><tt class='constant'>TRUE</tt></b> se a conex&amp;atilde;o est&amp;aacute; ocupada. Se estiver ocupada, significa que uma consulta (query) anterior ainda est&amp;aacute; sendo executada. Se <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a> for chamada, ser&amp;aacute; bloqueada. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_connection_busy()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=publisher'</span><span style='color: #007700'>)&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$bs&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connection_busy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$bs</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'a&amp;nbsp;conex&amp;atilde;o&amp;nbsp;esta&amp;nbsp;ocupada'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'a&amp;nbsp;conex&amp;atilde;o&amp;nbsp;n&amp;atilde;o&amp;nbsp;esta&amp;nbsp;ocupada'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-connection-status.php' class='function'>pg_connection_status()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-get-result.php' class='function'>pg_get_result()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_connect" value="<div id='function.pg-connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-connect.php'>pg_connect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_connect</span> &amp;mdash; <span class='dc-title'>Abre uma conex&amp;atilde;o PostgreSQL</span></p> </div> <a name='function.pg-connect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>pg_connect</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$connection_string</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_connect()</b> retorna um recurso (resource) de conex&amp;atilde;o que &amp;eacute; necess&amp;aacute;rio para outras fun&amp;ccedil;&amp;otilde;es para PostgreSQL. </p> <p class='para'> <b>pg_connect()</b> abre uma conex&amp;atilde;o com um servidor de banco de dados PostgreSQL especificado por <i><tt class='parameter'>connection_string</tt></i> . Retorna um recurso (resource) de conex&amp;atilde;o em caso de sucesso. Retorna <b><tt class='constant'>FALSE</tt></b> se a conex&amp;atilde;o n&amp;atilde;o p&amp;ocirc;de ser estabelecida. <i><tt class='parameter'>connection_string</tt></i> deve ser uma string entre aspas duplas. </p><div class='example'> <p><b>Exemplo #1 Usando <b>pg_connect()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$bdcon&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbname=flavia'</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//conecta&amp;nbsp;a&amp;nbsp;um&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados&amp;nbsp;chamado&amp;nbsp;'flavia'<br /><br /></span><span style='color: #0000BB'>$bdcon2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'host=localhost&amp;nbsp;port=5432&amp;nbsp;dbname=flavia'</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//&amp;nbsp;conecta&amp;nbsp;a&amp;nbsp;um&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados&amp;nbsp;chamado&amp;nbsp;'flavia'&amp;nbsp;em&amp;nbsp;'localhost'&amp;nbsp;na&amp;nbsp;porta&amp;nbsp;'5432'<br /><br /></span><span style='color: #0000BB'>$bdcon3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'host=ovelha&amp;nbsp;port=5432&amp;nbsp;dbname=flavia&amp;nbsp;user=ze&amp;nbsp;password=buu'</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//conecta&amp;nbsp;a&amp;nbsp;um&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados&amp;nbsp;chamado&amp;nbsp;'flavia'&amp;nbsp;na&amp;nbsp;m&amp;aacute;quina&amp;nbsp;'ovelha'&amp;nbsp;com&amp;nbsp;um&amp;nbsp;usu&amp;aacute;rio&amp;nbsp;e&amp;nbsp;senha<br /><br /></span><span style='color: #0000BB'>$con_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'host=ovelha&amp;nbsp;port=5432&amp;nbsp;dbname=flavia&amp;nbsp;user=ze&amp;nbsp;password=buu'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$bdcon4&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$con_string</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//coneta&amp;nbsp;a&amp;nbsp;um&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados&amp;nbsp;chamado&amp;nbsp;'flavia'&amp;nbsp;na&amp;nbsp;m&amp;aacute;quina&amp;nbsp;'ovelha'&amp;nbsp;com&amp;nbsp;um&amp;nbsp;usu&amp;aacute;rio&amp;nbsp;e&amp;nbsp;senha<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> Os argumentos dispon&amp;iacute;veis para <i><tt class='parameter'>connection_string</tt></i> incluem <i><tt class='parameter'>host</tt></i> , <i><tt class='parameter'>port</tt></i> , <i><tt class='parameter'>tty</tt></i> , <i><tt class='parameter'>options</tt></i> , <i><tt class='parameter'>dbname</tt></i> , <i><tt class='parameter'>user</tt></i> e <i><tt class='parameter'>password</tt></i> . </p> <p class='para'> Se uma segunda chamada &amp;eacute; feita para <b>pg_connect()</b> com a mesma <i><tt class='parameter'>connection_string</tt></i> , nenhuma nova conex&amp;atilde;o ser&amp;aacute; estabelecida, ao inv&amp;eacute;s disso, o recurso (resource) de conex&amp;atilde;o da conex&amp;atilde;o que j&amp;aacute; est&amp;aacute; aberta ser&amp;aacute; retornado. Voc&amp;ecirc; pode ter multiplas conex&amp;otilde;es para o mesmo banco de dados se voc&amp;ecirc; usar diferentes strings de conex&amp;atilde;o. </p> <p class='para'> A sintaxe antiga com par&amp;acirc;metros m&amp;uacute;ltiplos <strong class='command'>$con = pg_connect(&amp;quot;host&amp;quot;, &amp;quot;port&amp;quot;, &amp;quot;options&amp;quot;, &amp;quot;tty&amp;quot;, &amp;quot;dbname&amp;quot;) </strong> se tornou obsoleta. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-pconnect.php' class='function'>pg_pconnect()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-close.php' class='function'>pg_close()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-host.php' class='function'>pg_host()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-port.php' class='function'>pg_port()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-tty.php' class='function'>pg_tty()</a>, <a href='http://www.php.net/manual/pt_BR/function.pg-options.php' class='function'>pg_options()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-dbname.php' class='function'>pg_dbname()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_close" value="<div id='function.pg-close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-close.php'>pg_close</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_close</span> &amp;mdash; <span class='dc-title'>Fecha uma conex&amp;atilde;o PostgreSQL</span></p> </div> <a name='function.pg-close.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_close</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_close()</b> fecha a conex&amp;atilde;o n&amp;atilde;o persistente com servidor de banco de dados PostgreSQL associado ao recurso (resource) <i><tt class='parameter'>connection</tt></i> dado. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <blockquote><p><b class='note'>Nota</b>: Normalmente, o uso de <b>pg_close()</b> n&amp;atilde;o &amp;eacute; necess&amp;aacute;rio j&amp;aacute; que conex&amp;otilde;es n&amp;atilde;o persistentes abertas s&amp;atilde;o automaticamente fechadas ao final do processamento do script. <br /> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_close()</b> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$dbconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'host=localhost&amp;nbsp;port=5432&amp;nbsp;dbname=mary'</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print(</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>pg_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbconn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Se existem recursos (resource) de objetos grandes (large objects) abertos na conex&amp;atilde;o, n&amp;atilde;o feche a conex&amp;atilde;o antes de fechar todos os recursos relacionados com estes objetos. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_client_encoding" value="<div id='function.pg-client-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-client-encoding.php'>pg_client_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_client_encoding</span> &amp;mdash; <span class='dc-title'> Retorna a codifica&amp;ccedil;&amp;atilde;o do cliente </span></p> </div> <a name='function.pg-client-encoding.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>pg_client_encoding</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> <b>pg_client_encoding()</b> retorna a codifica&amp;ccedil;&amp;atilde;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. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o requer PHP 4.0.3 ou maior e PostgreSQL 7.0 ou maior Se a libpq foi compilada sem suporte a codifica&amp;ccedil;&amp;atilde;o multibyte, <a href='http://www.php.net/manual/pt_BR/function.pg-set-client-encoding.php' class='function'>pg_set_client_encoding()</a> sempre retornar&amp;aacute; &amp;quot;SQL_ASCII&amp;quot;. As codifica&amp;ccedil;&amp;otilde;es suportadas dependem da vers&amp;atilde;o do PostgreSQL. Vide o manual do PostgreSQL para mais detalhes sobre como habilitar o suporte a multibyte e outras codifica&amp;ccedil;&amp;otilde;es. <br /> Esta fun&amp;ccedil;&amp;atilde;o costumava ser chamada <b>pg_clientencoding()</b>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-set-client-encoding.php' class='function'>pg_set_client_encoding()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_cancel_query" value="<div id='function.pg-cancel-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-cancel-query.php'>pg_cancel_query</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_cancel_query</span> &amp;mdash; <span class='dc-title'> Cancela uma consulta (query) ass&amp;iacute;ncrona </span></p> </div> <a name='function.pg-cancel-query.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>pg_cancel_query</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_cancel_query()</b> cancela uma consulta (query) ass&amp;iacute;ncrona enviada por <a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function'>pg_send_query()</a>. Voc&amp;ecirc; n&amp;atilde;o pode cancelar uma consulta executada por <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-send-query.php' class='function'>pg_send_query()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-connection-busy.php' class='function'>pg_connection_busy()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="pg_affected_rows" value="<div id='function.pg-affected-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.pg-affected-rows.php'>pg_affected_rows</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>pg_affected_rows</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero de registros afetados (linhas)</span></p> </div> <a name='function.pg-affected-rows.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>pg_affected_rows</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> <b>pg_affected_rows()</b> retorna o n&amp;uacute;mero de linhas (inst&amp;acirc;ncias/registros/linhas) afetados por consultas (queries) INSERT, UPDATE e DELETE executados por <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a>. Se nenhuma linha foi afetada, ela retornar&amp;aacute; 0. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>pg_affected_rows()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;authors&amp;nbsp;VALUES&amp;nbsp;('Orwell',&amp;nbsp;2002,&amp;nbsp;'Animal&amp;nbsp;Farm')'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$cmdtuples&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>pg_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$cmdtuples&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;tuples&amp;nbsp;are&amp;nbsp;affected.\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o costumava ser chamada de <i>pg_cmdtuples()</i>. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.pg-query.php' class='function'>pg_query()</a> e <a href='http://www.php.net/manual/pt_BR/function.pg-num-rows.php' class='function'>pg_num_rows()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_tables" value="<div id='function.odbc-tables' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-tables.php'>odbc_tables</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_tables</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma lista dos nomes das tabelas guardadas em uma fonte de dados especificado</span></p> </div> <a name='function.odbc-tables.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_tables</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$name</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$types</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Lista todas as tabelas no intervalo solicitado. Retorna um identificador de resultado contendo a informa&amp;ccedil;&amp;atilde;o ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>TABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>TABLE_NAME</span></li> <li class='listitem'><span class='simpara'>TABLE_TYPE</span></li> <li class='listitem'><span class='simpara'>REMARKS</span></li> </ul><p> </p> <p class='simpara'> O conjunto de resultados &amp;eacute; ordenado por TABLE_TYPE, TABLE_QUALIFIER, TABLE_OWNER e TABLE_NAME. </p> <p class='para'> Os argumentos <i><tt class='parameter'>owner</tt></i> e <i><tt class='parameter'>name</tt></i> aceitam caracteres de busca (&amp;#039;%&amp;#039; para buscar zero ou mais caracteres e &amp;#039;_&amp;#039; para buscar um &amp;uacute;nico caractere). </p> <p class='para'> Para suportar a enumera&amp;ccedil;&amp;atilde;o de qualifiers, owners, e table types, a seguinte semantica especial para <i><tt class='parameter'>qualifier</tt></i> , <i><tt class='parameter'>owner</tt></i> , <i><tt class='parameter'>name</tt></i> , e <i><tt class='parameter'>table_type</tt></i> esta dispon&amp;iacute;vel: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> Se <i><tt class='parameter'>qualifier</tt></i> &amp;eacute; um &amp;uacute;nico caractere de porcentagem (%) e <i><tt class='parameter'>owner</tt></i> e <i><tt class='parameter'>name</tt></i> s&amp;atilde;o strings vazias, ent&amp;atilde;o o conjunto de resultados cont&amp;eacute;m uma lista dos qualifiers v&amp;aacute;lidos para a fonte de dados. (Todas as colunas exceto a coluna TABLE_QUALIFIER cont&amp;eacute;m NULLs.) </span> </li> <li class='listitem'> <span class='simpara'> Se <i><tt class='parameter'>owner</tt></i> &amp;eacute; um &amp;uacute;nico caractere de porcentagem (%) e <i><tt class='parameter'>qualifier</tt></i> e <i><tt class='parameter'>name</tt></i> s&amp;atilde;o strings vazias, ent&amp;atilde;o o conjunto de resultados cont&amp;eacute;m uma lista dos owners v&amp;aacute;lidos para a fonte de dados. (Todas as colunas exceto a coluna TABLE_OWNER cont&amp;eacute;m NULLs.) </span> </li> <li class='listitem'> <span class='simpara'> Se <i><tt class='parameter'>table_type</tt></i> &amp;eacute; um &amp;uacute;nico caractere de porcentagem (%) e <i><tt class='parameter'>qualifier</tt></i> , <i><tt class='parameter'>owner</tt></i> e <i><tt class='parameter'>name</tt></i> s&amp;atilde;o strings vazias, ent&amp;atilde;o o conjunto de resultados cont&amp;eacute;m uma lista de table types v&amp;aacute;lido para a fonte de dados. (Todas as colunas exceto a coluna TABLE_TYPE cont&amp;eacute;m NULLs.) </span> </li> </ul><p> </p> <p class='para'> Se <i><tt class='parameter'>table_type</tt></i> n&amp;atilde;o for uma string vazia, deve conter uma lista de valores separados por v&amp;iacute;rgula para os tipos que interessem, cada valor pode estar entre aspas simples (&amp;#039;) ou sem aspas. Poe exemplo, &amp;quot;&amp;#039;TABLE&amp;#039;,&amp;#039;VIEW&amp;#039;&amp;quot; ou &amp;quot;TABLE, VIEW&amp;quot;. Se a fonte de dados n&amp;atilde;o suportar o tipo de tabela especificado, <b>odbc_tables()</b> n&amp;atilde;o retorna nenhum resultado para este tipo. </p> <p class='simpara'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.odbc-tableprivileges.php' class='function'>odbc_tableprivileges()</a> para obter os privil&amp;eacute;gios associados. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_tableprivileges" value="<div id='function.odbc-tableprivileges' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-tableprivileges.php'>odbc_tableprivileges</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_tableprivileges</span> &amp;mdash; <span class='dc-title'>Lista tabelas e os privil&amp;eacute;gios associados a cada tabela</span></p> </div> <a name='function.odbc-tableprivileges.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_tableprivileges</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$name</tt></span> )</div> <p class='para rdfs-comment'> Lista as tabelas solicitadas e os privil&amp;eacute;gios associados a cada tabela. Retorna um identificador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto dos resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>TABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>TABLE_NAME</span></li> <li class='listitem'><span class='simpara'>GRANTOR</span></li> <li class='listitem'><span class='simpara'>GRANTEE</span></li> <li class='listitem'><span class='simpara'>PRIVILEGE</span></li> <li class='listitem'><span class='simpara'>IS_GRANTABLE</span></li> </ul><p> </p> <p class='simpara'> O conjunto dos resultados e ordenado por TABLE_QUALIFIER, TABLE_OWNER e TABLE_NAME. </p> <p class='para'> Os argumentos <i><tt class='parameter'>owner</tt></i> e <i><tt class='parameter'>name</tt></i> aceitam caracteres de busca (&amp;#039;%&amp;#039; para buscar zero ou mais caracteres e &amp;#039;_&amp;#039; para buscar um &amp;uacute;nico caractere). </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_statistics" value="<div id='function.odbc-statistics' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-statistics.php'>odbc_statistics</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_statistics</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m estatisticas sobre uma tabela</span></p> </div> <a name='function.odbc-statistics.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_statistics</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$unique</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$accuracy</tt></span> )</div> <p class='para rdfs-comment'> Pega estatisticas sobre uma tabela e seus &amp;iacute;ndices. Retorna um identificador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>TABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>TABLE_NAME</span></li> <li class='listitem'><span class='simpara'>NON_UNIQUE</span></li> <li class='listitem'><span class='simpara'>INDEX_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>INDEX_NAME</span></li> <li class='listitem'><span class='simpara'>TYPE</span></li> <li class='listitem'><span class='simpara'>SEQ_IN_INDEX</span></li> <li class='listitem'><span class='simpara'>COLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>COLLATION</span></li> <li class='listitem'><span class='simpara'>CARDINALITY</span></li> <li class='listitem'><span class='simpara'>PAGES</span></li> <li class='listitem'><span class='simpara'>FILTER_CONDITION</span></li> </ul><p> </p> <p class='simpara'> O conjunto de resultados &amp;eacute; ordenado por NON_UNIQUE, TYPE, INDEX_QUALIFIER, INDEX_NAME e SEQ_IN_INDEX. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_specialcolumns" value="<div id='function.odbc-specialcolumns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-specialcolumns.php'>odbc_specialcolumns</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_specialcolumns</span> &amp;mdash; <span class='dc-title'>Retorna um conjunto de colunas que identificam de modo &amp;uacute;nico uma linha na tabela ou as colunas que s&amp;atilde;o automaticamente atualizadas quando qualquer valor na linha &amp;eacute; atualizado por uma transa&amp;ccedil;&amp;atilde;o.</span></p> </div> <a name='function.odbc-specialcolumns.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_specialcolumns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$type</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$scope</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$nullable</tt></span> )</div> <p class='simpara'> Quando o argumento type &amp;eacute; SQL_BEST_ROWID, <b>odbc_specialcolumns()</b> retorna a coluna ou colunas que identificam unicamente cada linha na tabela. </p> <p class='simpara'> Quando o argumento type &amp;eacute; SQL_ROWVER, <b>odbc_specialcolumns()</b> retorna a coluna ou colunas na tabela especificada, se qualquer, que seja automaticamente atualizada pela fonte de dados quando qualquer valor na linha &amp;eacute; atualizado por qualquer transa&amp;ccedil;&amp;atilde;o. </p> <p class='simpara'> Retorna um identificador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>SCOPE</span></li> <li class='listitem'><span class='simpara'>COLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>DATA_TYPE</span></li> <li class='listitem'><span class='simpara'>TYPE_NAME</span></li> <li class='listitem'><span class='simpara'>PRECISION</span></li> <li class='listitem'><span class='simpara'>LENGTH</span></li> <li class='listitem'><span class='simpara'>SCALE</span></li> <li class='listitem'><span class='simpara'>PSEUDO_COLUMN</span></li> </ul><p> </p> <p class='simpara'> O conjunto de resultados &amp;eacute; ordenado por SCOPE. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_setoption" value="<div id='function.odbc-setoption' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-setoption.php'>odbc_setoption</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_setoption</span> &amp;mdash; <span class='dc-title'>Ajusta defini&amp;ccedil;&amp;otilde;es ODBC</span></p> </div> <a name='function.odbc-setoption.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_setoption</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$function</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$option</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$param</tt></span> )</div> <p class='para rdfs-comment'> Esta op&amp;ccedil;&amp;atilde;o permite mudar op&amp;ccedil;&amp;otilde;es ODBC para um conex&amp;atilde;o em particular ou o resultado de uma consulta. Foi escrita para ajudar a encontrar meios para contornar problemas com drivers ODBC caprichosos. Voc&amp;ecirc; provavelmente somente usar esta fun&amp;ccedil;&amp;atilde;o se voc&amp;ecirc; &amp;eacute; um programador ODBC e intender os efeitos que as v&amp;aacute;rias op&amp;ccedil;&amp;otilde;es ter&amp;atilde;o. Voc&amp;ecirc; certamente vai precisar de uma boa referencia ODBC que explique todas as op&amp;ccedil;&amp;otilde;es diferentes e valores que podem ser usados. Vers&amp;otilde;es diferentes dos drivers suportam op&amp;ccedil;&amp;otilde;es diferentes. </p> <p class='para'> Devido aos efeitos variarem dependendo do driver ODBC, o uso desta fun&amp;ccedil;&amp;atilde;o em scripts que ser&amp;atilde;o tornados publicos &amp;eacute; fortemente desencourajado. Tamb&amp;eacute;m, algumas op&amp;ccedil;&amp;otilde;es ODBC n&amp;atilde;o est&amp;atilde;o dispon&amp;iacute;veis para esta fun&amp;ccedil;&amp;atilde;o porque devem ser definidas antes de a conex&amp;atilde;o ser estabelecida ou a consulta ser preparada. Em todo o caso, se em um trabalho particular isso pode fazer o PHP funcionar e seu superior n&amp;atilde;o dizer para voc&amp;ecirc; usar um produto comercial, isto &amp;eacute; tudo o que importa realmente. </p> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> <p class='para'> <i><tt class='parameter'>id</tt></i> &amp;eacute; um id de conex&amp;atilde;o o o id de um resultado de uma consulta no qual ser&amp;aacute; mudada as defini&amp;ccedil;&amp;otilde;es. Para SQLSetConnectOption(), este &amp;eacute; um id de conex&amp;atilde;o. Para SQLSetStmtOption(), este &amp;eacute; um id de um resultado de uma consulta. </p> <p class='para'> <i><tt class='parameter'>Function</tt></i> &amp;eacute; a fun&amp;ccedil;&amp;atilde;o ODBC a ser usada. O valor deve ser 1 para SQLSetConnectOption() e 2 para SQLSetStmtOption(). </p> <p class='para'> O par&amp;acirc;metro <i><tt class='parameter'>option</tt></i> &amp;eacute; a op&amp;ccedil;&amp;atilde;o a ser definida.</p> <p class='para'> O par&amp;acirc;metro <i><tt class='parameter'>param</tt></i> &amp;eacute; o valor para a <i><tt class='parameter'>option</tt></i> indicada. </p><div class='example'> <p><b>Exemplo #1 Exemplos ODBC Setoption</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;1.&amp;nbsp;Option&amp;nbsp;102&amp;nbsp;of&amp;nbsp;SQLSetConnectOption()&amp;nbsp;is&amp;nbsp;SQL_AUTOCOMMIT.<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;Value&amp;nbsp;1&amp;nbsp;of&amp;nbsp;SQL_AUTOCOMMIT&amp;nbsp;is&amp;nbsp;SQL_AUTOCOMMIT_ON.<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;This&amp;nbsp;example&amp;nbsp;has&amp;nbsp;the&amp;nbsp;same&amp;nbsp;effect&amp;nbsp;as<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;odbc_autocommit($conn,&amp;nbsp;true);<br /><br /></span><span style='color: #0000BB'>odbc_setoption&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>102</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;2.&amp;nbsp;Option&amp;nbsp;0&amp;nbsp;of&amp;nbsp;SQLSetStmtOption()&amp;nbsp;is&amp;nbsp;SQL_QUERY_TIMEOUT.<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;This&amp;nbsp;example&amp;nbsp;sets&amp;nbsp;the&amp;nbsp;query&amp;nbsp;to&amp;nbsp;timeout&amp;nbsp;after&amp;nbsp;30&amp;nbsp;seconds.<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_prepare&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>odbc_setoption&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>odbc_execute&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_rollback" value="<div id='function.odbc-rollback' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-rollback.php'>odbc_rollback</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_rollback</span> &amp;mdash; <span class='dc-title'>Desfaz uma transa&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.odbc-rollback.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_rollback</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> )</div> <p class='para rdfs-comment'> Desfaz todos os comandos pendentes em conex&amp;atilde;o. </p> </div> <a name='function.odbc-rollback.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador da conex&amp;atilde;o. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-rollback.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_result_all" value="<div id='function.odbc-result-all' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-result-all.php'>odbc_result_all</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_result_all</span> &amp;mdash; <span class='dc-title'>Mostra o resultado como uma tabela HTML</span></p> </div> <a name='function.odbc-result-all.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_result_all</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$format</tt></span> ] )</div> <p class='para rdfs-comment'> Mostra todas as linhas de um resultado produzido pela <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. O resultado &amp;eacute; mostrado no formato de tabela HTML. </p> </div> <a name='function.odbc-result-all.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>format</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Formata&amp;ccedil;&amp;atilde;o adicional de toda tabela. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-result-all.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o n&amp;uacute;mero de linhas no resultado ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_result" value="<div id='function.odbc-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-result.php'>odbc_result</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_result</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m dados do resultado</span></p> </div> <a name='function.odbc-result.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>odbc_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$field</tt></span> )</div> <p class='para rdfs-comment'> Retorna o cont&amp;eacute;udo de um campo. <b><tt class='constant'>FALSE</tt></b> em caso de erro, <b><tt class='constant'>NULL</tt></b> para dados NULL, ou <b><tt class='constant'>TRUE</tt></b> para dados bin&amp;aacute;rios. </p> <p class='para'> <i><tt class='parameter'>field</tt></i> pode ser um inteio contendo o n&amp;uacute;mero da coluna que voc&amp;ecirc; quer; ou pode ser uma string contendo o nome do campo. Por exemplo: </p><div class='informalexample'> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$item_3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_result&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$Query_ID</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$item_val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_result&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$Query_ID</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'val'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> A primeira chamada a <b>odbc_result()</b> retorna o valor do terceiro campo do registro atual do resultado da consulta. A segunda chamada a <b>odbc_result()</b> retorna o valor do campo cujo nome &amp;eacute; &amp;quot;val&amp;quot; do registro atual do resultado da consulta. Um erro acontece se o n&amp;uacute;mero do campo for menor do que um ou for maior do que o n&amp;uacute;mero de colunas(ou campos). De modo similar, um erro acontece se o nome do campo indicado n&amp;atilde;o existir na tabela que esta sendo consultada. </p> <p class='para'> &amp;Iacute;ndices de campo come&amp;ccedil;am em 1. Para saber sobre o meio que dados bin&amp;aacute;rios ou uma coluna long &amp;eacute; retornada, veja <a href='http://www.php.net/manual/pt_BR/function.odbc-binmode.php' class='function'>odbc_binmode()</a> e <a href='http://www.php.net/manual/pt_BR/function.odbc-longreadlen.php' class='function'>odbc_longreadlen()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_procedures" value="<div id='function.odbc-procedures' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-procedures.php'>odbc_procedures</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_procedures</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a lista de procedures guadadas na fonte de dados especificada.</span></p> </div> <a name='function.odbc-procedures.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_procedures</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$name</tt></span> )</div> <p class='para rdfs-comment'> Lista todas as procedures solicitadas. Terorna um identificador de resultado contendo as informa&amp;ccedil;&amp;otilde;es ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>PROCEDURE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>PROCEDURE_OWNER</span></li> <li class='listitem'><span class='simpara'>PROCEDURE_NAME</span></li> <li class='listitem'><span class='simpara'>NUM_INPUT_PARAMS</span></li> <li class='listitem'><span class='simpara'>NUM_OUTPUT_PARAMS</span></li> <li class='listitem'><span class='simpara'>NUM_RESULT_SETS</span></li> <li class='listitem'><span class='simpara'>REMARKS</span></li> <li class='listitem'><span class='simpara'>PROCEDURE_TYPE</span></li> </ul><p> </p> <p class='para'> Os argumentos <i><tt class='parameter'>owner</tt></i> e <i><tt class='parameter'>name</tt></i> aceitam modelos de busca (&amp;#039;%&amp;#039; para encontrar zero ou mais caracteres e &amp;#039;_&amp;#039; para encontrar um &amp;uacute;nico caractere). </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_procedurecolumns" value="<div id='function.odbc-procedurecolumns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-procedurecolumns.php'>odbc_procedurecolumns</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_procedurecolumns</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre par&amp;acirc;metros para procedures</span></p> </div> <a name='function.odbc-procedurecolumns.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_procedurecolumns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> ], <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$proc</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma lista de par&amp;acirc;metros de entrada e sa&amp;iacute;da, assim como as colunas que fazem parte do conjunto de resultados para os procedures especificados. Retorna um idenficador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>PROCEDURE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>PROCEDURE_OWNER</span></li> <li class='listitem'><span class='simpara'>PROCEDURE_NAME</span></li> <li class='listitem'><span class='simpara'>COLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>COLUMN_TYPE</span></li> <li class='listitem'><span class='simpara'>DATA_TYPE</span></li> <li class='listitem'><span class='simpara'>TYPE_NAME</span></li> <li class='listitem'><span class='simpara'>PRECISION</span></li> <li class='listitem'><span class='simpara'>LENGTH</span></li> <li class='listitem'><span class='simpara'>SCALE</span></li> <li class='listitem'><span class='simpara'>RADIX</span></li> <li class='listitem'><span class='simpara'>NULLABLE</span></li> <li class='listitem'><span class='simpara'>REMARKS</span></li> </ul><p> </p> <p class='simpara'>O conjunto de resultados &amp;eacute; ordenado por PROCEDURE_QUALIFIER, PROCEDURE_OWNER, PROCEDURE_NAME e COLUMN_TYPE. </p> <p class='para'> Os argumentos <i><tt class='parameter'>owner</tt></i> , <i><tt class='parameter'>proc</tt></i> and <i><tt class='parameter'>column</tt></i> aceitam modelos de busca (&amp;#039;%&amp;#039; para buscar zero ou mais caracteres e &amp;#039;_&amp;#039; para buscar um &amp;uacute;nico caractere). </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_primarykeys" value="<div id='function.odbc-primarykeys' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-primarykeys.php'>odbc_primarykeys</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_primarykeys</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a chave prim&amp;aacute;ria de uma tabela</span></p> </div> <a name='function.odbc-primarykeys.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_primarykeys</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table</tt></span> )</div> <p class='para rdfs-comment'> Retorna um identificador de resultado que pode ser usado para obter o nome das colunas chave prim&amp;aacute;ria de uma tabela. </p> </div> <a name='function.odbc-primarykeys.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador da conex&amp;atilde;o. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>owner</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-primarykeys.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>TABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>TABLE_NAME</span></li> <li class='listitem'><span class='simpara'>COLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>KEY_SEQ</span></li> <li class='listitem'><span class='simpara'>PK_NAME</span></li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_prepare" value="<div id='function.odbc-prepare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-prepare.php'>odbc_prepare</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_prepare</span> &amp;mdash; <span class='dc-title'>Prepara um comando para execu&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.odbc-prepare.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_prepare</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query_string</tt></span> )</div> <p class='para rdfs-comment'> Retorna <b><tt class='constant'>FALSE</tt></b> em caso de erro. </p> <p class='para'> Retorna um identificador de resultado ODBC se o comando SQL foi preparado de modo bem sucedido. O identificador de resultado pode ser executado posteriormente para executar o comando com <a href='http://www.php.net/manual/pt_BR/function.odbc-execute.php' class='function'>odbc_execute()</a>. </p> <p class='para'> Alguns bancos de dados (como IBM DB2, MS SQL Server, e Oracle) suportam stored procedures que aceitam par&amp;acirc;metros do tipo IN, INOUT, e OUT como definido pela especifica&amp;ccedil;&amp;atilde;o ODBC. Entretanto, o Unified ODBC driver atualmente suporta apenas par&amp;acirc;metros do tipo IN em stored procedures. </p> <p class='para'> No seguinte c&amp;oacute;digo, <var class='varname'>$res</var> ser&amp;aacute; v&amp;aacute;lido apenas se todos os tr&amp;ecirc;s par&amp;acirc;metros em myproc forem par&amp;acirc;metros IN: </p><div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$a&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$b&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$c&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CALL&amp;nbsp;myproc(?,?,?)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$b</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$c</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <p> Se voc&amp;ecirc; precisar usar um stored procedure usando par&amp;acirc;metros INOUT ou OUT, a alternativa &amp;eacute; usar a extens&amp;atilde;o nativa para o seu banco de dados (por exemplo, <a href='http://www.php.net/manual/pt_BR/ref.mssql.php' class='link'>mssql</a> para MS SQL Server, ou <a href='http://www.php.net/manual/pt_BR/ref.mssql.php' class='link'>oci8</a> para Oracle). </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_pconnect" value="<div id='function.odbc-pconnect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-pconnect.php'>odbc_pconnect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_pconnect</span> &amp;mdash; <span class='dc-title'>Abre uma conex&amp;atilde;o persistente com o servidor de banco de dados</span></p> </div> <a name='function.odbc-pconnect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_pconnect</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dsn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$user</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$password</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cursor_type</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna uma id de conex&amp;atilde;o ODBC ou 0 (<b><tt class='constant'>FALSE</tt></b>) em caso de erro. Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; muito parecida com <a href='http://www.php.net/manual/pt_BR/function.odbc-connect.php' class='function'>odbc_connect()</a>, exceto que a conex&amp;atilde;o n&amp;atilde;o &amp;eacute; realmente fechada quando o script termina. Requisi&amp;ccedil;&amp;otilde;es futuras com o mesma combina&amp;ccedil;&amp;atilde;o de <i><tt class='parameter'>dsn</tt></i> , <i><tt class='parameter'>user</tt></i> , <i><tt class='parameter'>password</tt></i> (via <a href='http://www.php.net/manual/pt_BR/function.odbc-connect.php' class='function'>odbc_connect()</a> e <b>odbc_pconnect()</b>) podem reutilizar a conex&amp;atilde;o persistente. </p> <p class='para'> </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> Conex&amp;otilde;es persistentes n&amp;atilde;o tem efeito se o PHP &amp;eacute; utilizado como um programa CGI. </span> </p></blockquote><p> </p> <p class='para'> Para informa&amp;ccedil;&amp;otilde;es sobre o par&amp;acirc;metro opcional cursor_type veja a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.odbc-connect.php' class='function'>odbc_connect()</a>. Para maiores informa&amp;ccedil;&amp;otilde;es sobre as conex&amp;otilde;es persistentes, leia o FAQ PHP. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_num_rows" value="<div id='function.odbc-num-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-num-rows.php'>odbc_num_rows</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_num_rows</span> &amp;mdash; <span class='dc-title'>N&amp;uacute;mero de linhas em um resultado</span></p> </div> <a name='function.odbc-num-rows.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_num_rows</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o n&amp;uacute;mero de linhas em um resultado ODBC. Para comandos INSERT, UPDATE e DELETE <b>odbc_num_rows()</b> retorna o n&amp;uacute;mero de linhas afetadas. Para SELECT isto <i>pode</i> ser o n&amp;uacute;mero de linhas dispon&amp;iacute;veis. </p> </div> <a name='function.odbc-num-rows.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado retornado pela <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-num-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o n&amp;uacute;mero de linhas em um resultado ODBC. Esta fun&amp;ccedil;&amp;atilde;o retornar&amp;aacute; -1 em erro. </p> </div> <a name='function.odbc-num-rows.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Usando <b>odbc_num_rows()</b> para determinar o n&amp;uacute;mero de linhas dispon&amp;iacute;vel ap&amp;oacute;s um SELECT, ser&amp;aacute; retornado -1 com muitos drivers. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_num_fields" value="<div id='function.odbc-num-fields' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-num-fields.php'>odbc_num_fields</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_num_fields</span> &amp;mdash; <span class='dc-title'>N&amp;uacute;mero de colunas em um resultado</span></p> </div> <a name='function.odbc-num-fields.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_num_fields</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o n&amp;uacute;mero de campos (colunas) em um resultado ODBC. </p> </div> <a name='function.odbc-num-fields.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado retornado pela <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-num-fields.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o n&amp;uacute;mero de campos, ou -1 em erro. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_next_result" value="<div id='function.odbc-next-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-next-result.php'>odbc_next_result</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_next_result</span> &amp;mdash; <span class='dc-title'>Confere se resultados m&amp;uacute;ltiplos est&amp;atilde;o dispon&amp;iacute;veis</span></p> </div> <a name='function.odbc-next-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_next_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> )</div> <p class='para rdfs-comment'> Verifica se h&amp;aacute; mais resultados dispon&amp;iacute;veis, dessa forma, permitindo acesso para pr&amp;oacute;ximo resultado via <a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-array.php' class='function'>odbc_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-row.php' class='function'>odbc_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.odbc-result.php' class='function'>odbc_result()</a>, etc. </p> </div> <a name='function.odbc-next-result.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-next-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se h&amp;aacute; mais resultados, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.odbc-next-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>odbc_next_result()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$r_Connection&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dsn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$username</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$s_SQL&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;&amp;lt;&amp;lt;&amp;lt;END_SQL<br /></span><span style='color: #DD0000'>SELECT&amp;nbsp;'A'<br />SELECT&amp;nbsp;'B'<br />SELECT&amp;nbsp;'C'<br /></span><span style='color: #007700'>END_SQL;<br /><br /></span><span style='color: #0000BB'>$r_Results&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Connection</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$s_SQL</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$a_Row1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$a_Row2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Dump&amp;nbsp;first&amp;nbsp;result&amp;nbsp;set'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$a_Row1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$a_Row2</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Get&amp;nbsp;second&amp;nbsp;results&amp;nbsp;set&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>odbc_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>$a_Row1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$a_Row2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Dump&amp;nbsp;second&amp;nbsp;result&amp;nbsp;set&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$a_Row1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$a_Row2</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Get&amp;nbsp;third&amp;nbsp;results&amp;nbsp;set&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>odbc_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>$a_Row1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$a_Row2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Dump&amp;nbsp;third&amp;nbsp;result&amp;nbsp;set&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$a_Row1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$a_Row2</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Try&amp;nbsp;for&amp;nbsp;a&amp;nbsp;fourth&amp;nbsp;result&amp;nbsp;set&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>odbc_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$r_Results</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Dump first result set array(1) { [&amp;quot;A&amp;quot;]=&amp;gt; string(1) &amp;quot;A&amp;quot; } bool(false) Get second results set bool(true) Dump second result set array(1) { [&amp;quot;B&amp;quot;]=&amp;gt; string(1) &amp;quot;B&amp;quot; } bool(false) Get third results set bool(true) Dump third result set array(1) { [&amp;quot;C&amp;quot;]=&amp;gt; string(1) &amp;quot;C&amp;quot; } bool(false) Try for a fourth result set bool(false) </pre></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_longreadlen" value="<div id='function.odbc-longreadlen' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-longreadlen.php'>odbc_longreadlen</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_longreadlen</span> &amp;mdash; <span class='dc-title'>Manipula&amp;ccedil;&amp;atilde;o de colunas LONG</span></p> </div> <a name='function.odbc-longreadlen.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_longreadlen</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$length</tt></span> )</div> <p class='para rdfs-comment'> Habilita o manusei de colunas LONG e LONGVARBINARY. </p> </div> <a name='function.odbc-longreadlen.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>length</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero de bytes retornado pelo PHP &amp;eacute; controlado pelo par&amp;acirc;metro length. Se ele &amp;eacute; definido para 0, coluna de grandes dados s&amp;atilde;o passadas atrav&amp;eacute;s do cliente. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-longreadlen.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.odbc-longreadlen.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Manipula&amp;ccedil;&amp;atilde;o de colunas LONGVARBINARY &amp;eacute; tamb&amp;eacute;m afetado por <a href='http://www.php.net/manual/pt_BR/function.odbc-binmode.php' class='function'>odbc_binmode()</a>. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_gettypeinfo" value="<div id='function.odbc-gettypeinfo' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-gettypeinfo.php'>odbc_gettypeinfo</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_gettypeinfo</span> &amp;mdash; <span class='dc-title'>Retorna um identificador de resultados contendo informa&amp;ccedil;&amp;otilde;es sobre os tipos de dados suportados pela fonte de dados</span></p> </div> <a name='function.odbc-gettypeinfo.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_gettypeinfo</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$data_type</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre os tipos de dados suportados pela fonte de dados. Retorna um identificador de resultados ODBC ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. O argumento opcional <i><tt class='parameter'>data_type</tt></i> pode ser utilizado para restringir a informa&amp;ccedil;&amp;atilde;o para um &amp;uacute;nico tipo de dados. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TYPE_NAME</span></li> <li class='listitem'><span class='simpara'>DATA_TYPE</span></li> <li class='listitem'><span class='simpara'>PRECISION</span></li> <li class='listitem'><span class='simpara'>LITERAL_PREFIX</span></li> <li class='listitem'><span class='simpara'>LITERAL_SUFFIX</span></li> <li class='listitem'><span class='simpara'>CREATE_PARAMS</span></li> <li class='listitem'><span class='simpara'>NULLABLE</span></li> <li class='listitem'><span class='simpara'>CASE_SENSITIVE</span></li> <li class='listitem'><span class='simpara'>SEARCHABLE</span></li> <li class='listitem'><span class='simpara'>UNSIGNED_ATTRIBUTE</span></li> <li class='listitem'><span class='simpara'>MONEY</span></li> <li class='listitem'><span class='simpara'>AUTO_INCREMENT</span></li> <li class='listitem'><span class='simpara'>LOCAL_TYPE_NAME</span></li> <li class='listitem'><span class='simpara'>MINIMUM_SCALE</span></li> <li class='listitem'><span class='simpara'>MAXIMUM_SCALE</span></li> </ul><p> </p> <p class='simpara'>O conjunto de resultados &amp;eacute; ordenado por DATA_TYPE e TYPE_NAME. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_free_result" value="<div id='function.odbc-free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-free-result.php'>odbc_free_result</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_free_result</span> &amp;mdash; <span class='dc-title'>Libera os recursos associados a um resultado</span></p> </div> <a name='function.odbc-free-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_free_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> )</div> <p class='para rdfs-comment'> Libera o recursos associados com o resultado. </p> <p class='para'> <b>odbc_free_result()</b> somente necessita ser chamado se voc&amp;ecirc; est&amp;aacute; com problema pelo fato de usar muita mem&amp;oacute;ria quando seu script &amp;eacute; executado. Toda mem&amp;oacute;ria de resultado ir&amp;aacute; automaticamente ser liberada quando o script &amp;eacute; terminado. </p> </div> <a name='function.odbc-free-result.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The result identifier. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-free-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Sempre retorna <b><tt class='constant'>TRUE</tt></b>. </p> </div> <a name='function.odbc-free-result.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Se auto-commit estiver desabilitado (veja <a href='http://www.php.net/manual/pt_BR/function.odbc-autocommit.php' class='function'>odbc_autocommit()</a>) e voc&amp;ecirc; utilizar <b>odbc_free_result()</b> antes de gravar, todas as transa&amp;ccedil;&amp;otilde;es pendentes ser&amp;atilde;o desfeitas. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_foreignkeys" value="<div id='function.odbc-foreignkeys' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-foreignkeys.php'>odbc_foreignkeys</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_foreignkeys</span> &amp;mdash; <span class='dc-title'>Retorna uma lista de chaves estrangeiras na tabela especificada ou uma lista de chaves estrangeiras em outras tabelas que se referem a chave prim&amp;aacute;ria na tabela especificada </span></p> </div> <a name='function.odbc-foreignkeys.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_foreignkeys</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pk_qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pk_owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pk_table</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$fk_qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$fk_owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$fk_table</tt></span> )</div> <p class='para rdfs-comment'> <b>odbc_foreignkeys()</b> obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre as chaves estrangeiras. Retorna um conjunto de resultados ODBC <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>PKTABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>PKTABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>PKTABLE_NAME</span></li> <li class='listitem'><span class='simpara'>PKCOLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>FKTABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>FKTABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>FKTABLE_NAME</span></li> <li class='listitem'><span class='simpara'>FKCOLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>KEY_SEQ</span></li> <li class='listitem'><span class='simpara'>UPDATE_RULE</span></li> <li class='listitem'><span class='simpara'>DELETE_RULE</span></li> <li class='listitem'><span class='simpara'>FK_NAME</span></li> <li class='listitem'><span class='simpara'>PK_NAME</span></li> </ul><p> </p> <p class='simpara'> Se <i><tt class='parameter'>pk_table</tt></i> cont&amp;eacute;m um nome de tabela, <b>odbc_foreignkeys()</b> retorna um conjunto de resultados contendo a chave prim&amp;aacute;ria da tabela especificada e todas as chaves estrangeiras que se referem a ela. </p> <p class='simpara'> Se <i><tt class='parameter'>fk_table</tt></i> cont&amp;eacute;m um nome de tabela, <b>odbc_foreignkeys()</b> retorna um conjunto de resultados de todas as chaves estrangeiras da tabela especificada e as chaves prim&amp;aacute;rias (em outras tabelas) as quais elas se referem. </p> <p class='simpara'> Se ambos <i><tt class='parameter'>pk_table</tt></i> e <i><tt class='parameter'>fk_table</tt></i> contiverem nomes de tabelas, <b>odbc_foreignkeys()</b> retorna as chaves estrangeiras na tabela especificada em <i><tt class='parameter'>fk_table</tt></i> que se referam a chave prim&amp;aacute;ria na tabela especificada em <i><tt class='parameter'>pk_table</tt></i> . Isto deve ser uma chave prim&amp;aacute;ria no m&amp;aacute;ximo. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_field_type" value="<div id='function.odbc-field-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-field-type.php'>odbc_field_type</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_field_type</span> &amp;mdash; <span class='dc-title'>Tipo de dados de um campo</span></p> </div> <a name='function.odbc-field-type.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>odbc_field_type</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o tipo SQL do campo referenciado pelo n&amp;uacute;mero num dado identificador de resultado. </p> </div> <a name='function.odbc-field-type.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do campo. Campos numerados a partir de 1. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-field-type.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o tipo do campo como uma string, ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_field_scale" value="<div id='function.odbc-field-scale' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-field-scale.php'>odbc_field_scale</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_field_scale</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a precis&amp;atilde;o de um campo</span></p> </div> <a name='function.odbc-field-scale.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_field_scale</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m a precis&amp;atilde;o do campo referenciado pelo n&amp;uacute;mero em um dado identificador de resultado. </p> </div> <a name='function.odbc-field-scale.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do campo. A numera&amp;ccedil;&amp;atilde;o do campo inicia em 1. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-field-scale.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a precis&amp;atilde;o do campo como um inteiro, ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_field_num" value="<div id='function.odbc-field-num' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-field-num.php'>odbc_field_num</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_field_num</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero da coluna</span></p> </div> <a name='function.odbc-field-num.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_field_num</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$field_name</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o n&amp;uacute;mero da coluna que corresponde ao nome do campo no dado identificador de resultado. </p> </div> <a name='function.odbc-field-num.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do campo. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-field-num.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o n&amp;uacute;mero do campo como um inteiro, ou <b><tt class='constant'>FALSE</tt></b> em erro. A numera&amp;ccedil;&amp;atilde;o dos campos iniciam em 1. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_field_name" value="<div id='function.odbc-field-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-field-name.php'>odbc_field_name</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_field_name</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o nome da coluna</span></p> </div> <a name='function.odbc-field-name.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>odbc_field_name</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o nome do campo ocupando o n&amp;uacute;mero da coluna em um dado identificador de resultado. </p> </div> <a name='function.odbc-field-name.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do campo. A numera&amp;ccedil;&amp;atilde;o de campos iniciam em 1. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-field-name.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o nome do campo como uma string, ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_field_len" value="<div id='function.odbc-field-len' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-field-len.php'>odbc_field_len</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_field_len</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o tamanho (precis&amp;atilde;o) de um campo</span></p> </div> <a name='function.odbc-field-len.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_field_len</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$field_number</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o tamanho do campo referenciado pelo n&amp;uacute;mero no dado identificador de resultado. </p> </div> <a name='function.odbc-field-len.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador do resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do campo. A numera&amp;ccedil;&amp;atilde;o dos campos inicia em 0. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-field-len.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o nome do campo como uma string, ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> <a name='function.odbc-field-len.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-field-scale.php' class='function' rel='rdfs-seeAlso'>odbc_field_scale()</a> - Obt&amp;eacute;m a precis&amp;atilde;o de um campo para obter a precis&amp;atilde;o de um n&amp;uacute;mero de ponto flutuante</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_fetch_row" value="<div id='function.odbc-fetch-row' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-fetch-row.php'>odbc_fetch_row</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_fetch_row</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma linha</span></p> </div> <a name='function.odbc-fetch-row.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_fetch_row</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m uma linha de dados que foi retornada pela <a href='http://www.php.net/manual/pt_BR/function.odbc-do.php' class='function'>odbc_do()</a> ou <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. Depois de <b>odbc_fetch_row()</b> ser chamada, os campos desta linha podem ser acessados com <a href='http://www.php.net/manual/pt_BR/function.odbc-result.php' class='function'>odbc_result()</a>. </p> </div> <a name='function.odbc-fetch-row.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se <i><tt class='parameter'>row_number</tt></i> n&amp;atilde;o for especificado, <b>odbc_fetch_row()</b> ir&amp;aacute; tentar obter a pr&amp;oacute;xima linha no conjunto de resultados. Chamadas para <b>odbc_fetch_row()</b> com ou sem <i><tt class='parameter'>row_number</tt></i> podem ser misturadas. </p> <p class='para'> Para caminhar atrav&amp;eacute;s do conjunto de resultados mais de uma vez, voc&amp;ecirc; pode usar <b>odbc_fetch_row()</b> com <i><tt class='parameter'>row_number</tt></i> 1, e ent&amp;atilde;o continuar fazendo <b>odbc_fetch_row()</b> sem <i><tt class='parameter'>row_number</tt></i> para ver os resultados. Se um driver n&amp;atilde;o suportar a obten&amp;ccedil;&amp;atilde;o de linhas por n&amp;uacute;meros, o par&amp;acirc;metro <i><tt class='parameter'>row_number</tt></i> &amp;eacute; ignorado. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-fetch-row.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se houver uma linha, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_fetch_object" value="<div id='function.odbc-fetch-object' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-fetch-object.php'>odbc_fetch_object</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.2, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_fetch_object</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m um conjunto de resultados como um objeto</span></p> </div> <a name='function.odbc-fetch-object.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>odbc_fetch_object</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$rownumber</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m um <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a> a partir de uma consulta ODBC. Veja o changelog abaixo para ver quando esta fun&amp;ccedil;&amp;atilde;o esta dispon&amp;iacute;vel. </p> </div> <a name='function.odbc-fetch-object.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O recurso do resultado de <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>rownumber</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Opcionalmente escolha o n&amp;uacute;mero da linha a qual obter. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-fetch-object.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um objeto que corresponde a linha obitida, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houverem mais linhas. </p> </div> <a name='function.odbc-fetch-object.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>4.3.3</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o existe quando compilado com suporte a IBM DB2 ou UnixODBC. </td> </tr> <tr valign='middle'> <td align='left'>4.3.2</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o existe quando compilada para o Windows. </td> </tr> <tr valign='middle'> <td align='left'>4.0.2</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o existe quando compilado com suporte DBMaker. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.odbc-fetch-object.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-row.php' class='function' rel='rdfs-seeAlso'>odbc_fetch_row()</a> - Obt&amp;eacute;m uma linha</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-array.php' class='function' rel='rdfs-seeAlso'>odbc_fetch_array()</a> - Obt&amp;eacute;m uma linha do resultado como uma array associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-num-rows.php' class='function' rel='rdfs-seeAlso'>odbc_num_rows()</a> - N&amp;uacute;mero de linhas em um resultado</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_fetch_into" value="<div id='function.odbc-fetch-into' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-fetch-into.php'>odbc_fetch_into</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_fetch_into</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma linha do conjunto de resultados como uma matriz</span></p> </div> <a name='function.odbc-fetch-into.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>odbc_fetch_into</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$result_array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$rownumber</tt></span> ] )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_fetch_into</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$rownumber</tt></span> ], <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$result_array</tt></span> )</div> <p class='para rdfs-comment'> Retorna o n&amp;uacute;mero de colunas no resultado; <b><tt class='constant'>FALSE</tt></b> em caso de erro. <i><tt class='parameter'>result_array</tt></i> deve ser passado por referencia, mas pode ser de qualquer tipo j&amp;aacute; que vai ser convertido para array. A matriz ir&amp;aacute; conter os valores das colunas com o &amp;iacute;ndice come&amp;ccedil;ando em 0. </p> <p class='para'> A partir do PHP 4.0.5 o par&amp;acirc;metro <i><tt class='parameter'>result_array</tt></i> n&amp;atilde;o precisa mais ser passado por referencia. </p> <p class='para'> A partir do PHP 4.0.6 o par&amp;acirc;metro <i><tt class='parameter'>rownumber</tt></i> n&amp;atilde;o pode ser passado como uma constante, mas sim como uma vari&amp;aacute;vel. </p> <p class='para'> A partir do PHP 4.2.0 o par&amp;acirc;metro <i><tt class='parameter'>result_array</tt></i> e <i><tt class='parameter'>rownumber</tt></i> foram trocados. Isto permite a rownumber poder ser uma constante novamente. Esta mudan&amp;ccedil;a tamb&amp;eacute;m ser&amp;aacute; a &amp;uacute;ltima nesta fun&amp;ccedil;&amp;atilde;o. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>odbc_fetch_into()</b> pr&amp;eacute; 4.0.6</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> ou </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 Exemplo <b>odbc_fetch_into()</b> 4.0.6</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> ou </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #3 Exemplo <b>odbc_fetch_into()</b> 4.2.0</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> ou </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>odbc_fetch_into</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res_id</span><span style='color: #007700'>,</span><span style='color: #0000BB'>$my_array</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_fetch_array" value="<div id='function.odbc-fetch-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-fetch-array.php'>odbc_fetch_array</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.2, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_fetch_array</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma linha do resultado como uma array associativa</span></p> </div> <a name='function.odbc-fetch-array.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>odbc_fetch_array</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$rownumber</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m um <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> associativo de uma consulta ODBC. Veja o changelog abaixo para saber desde quando esta fun&amp;ccedil;&amp;atilde;o esta dispon&amp;iacute;vel. </p> </div> <a name='function.odbc-fetch-array.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O recurso de resultado de <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>rownumber</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Opcionalmente escolha o n&amp;uacute;mero da linha que voc&amp;ecirc; quer obter. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-fetch-array.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma array que corresponde a linha obtida, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houverem mais linhas. </p> </div> <a name='function.odbc-fetch-array.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>4.3.3</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o existe quando compilado com suporte a IBM DB2 ou UnixODBC. </td> </tr> <tr valign='middle'> <td align='left'>4.3.2</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o existe quando compilado para Windows. </td> </tr> <tr valign='middle'> <td align='left'>4.0.2</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o existe quando compilado com suporte DBMaker. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.odbc-fetch-array.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-row.php' class='function' rel='rdfs-seeAlso'>odbc_fetch_row()</a> - Obt&amp;eacute;m uma linha</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-object.php' class='function' rel='rdfs-seeAlso'>odbc_fetch_object()</a> - Obt&amp;eacute;m um conjunto de resultados como um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-num-rows.php' class='function' rel='rdfs-seeAlso'>odbc_num_rows()</a> - N&amp;uacute;mero de linhas em um resultado</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_execute" value="<div id='function.odbc-execute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-execute.php'>odbc_execute</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_execute</span> &amp;mdash; <span class='dc-title'>Executa um comando preparado</span></p> </div> <a name='function.odbc-execute.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_execute</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$parameters_array</tt></span> ] )</div> <p class='para rdfs-comment'> Executa um comando preparado com <a href='http://www.php.net/manual/pt_BR/function.odbc-prepare.php' class='function'>odbc_prepare()</a>.Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. A matriz <i><tt class='parameter'>parameters_array</tt></i> somente precisa ser dada se voc&amp;ecirc; realmente tiver par&amp;acirc;metros em seu comando. </p> <p class='para'> Par&amp;acirc;metros em <i><tt class='parameter'>parameter_array</tt></i> ser&amp;atilde;o substituidos pelos marcadores de lugar na ordem no comando preparado. Elementos desta array ser&amp;atilde;o convertidos para strings ao chamar esta fun&amp;ccedil;&amp;atilde;o. </p> <p class='para'> Quaisquer par&amp;acirc;metros em <i><tt class='parameter'>parameter_array</tt></i> que comecem e terminem com aspas simples ser&amp;atilde;o considerados como um nome de arquivo para ler e enviar para o banco de dados como dados para o marcador de lugar apropriado. </p> <blockquote><p><b class='note'>Nota</b>: A partir do PHP 4.1.1, esta funcionalidade de leitura de arquivo tem as seguintes restri&amp;ccedil;&amp;otilde;es: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> A leitura de arquivos <em class='emphasis'>n&amp;atilde;o</em> &amp;eacute; sujeita a quaiquer restri&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.safe-mode' class='link'>safe mode</a> ou <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.open-basedir' class='link'>open-basedir</a>. Isto foi corrigido no PHP 4.2.0. </span> </li> <li class='listitem'> <span class='simpara'> <a href='http://www.php.net/manual/pt_BR/features.remote-files.php' class='link'>Arquivos Remotos</a> n&amp;atilde;o s&amp;atilde;o suportados. </span> </li> <li class='listitem'> <span class='simpara'> Se voc&amp;ecirc; querrer guardar uma string que comece e termine com aspas simples, voc&amp;ecirc; dever&amp;aacute; escapa-la ou adicionar um espa&amp;ccedil;o ou outro caracter que n&amp;atilde;o seja aspas simples no in&amp;iacute;cio ou no final do par&amp;acirc;metro, o qual ir&amp;aacute; prevenir que o par&amp;acirc;metro seja considerado como um nome de arquivo. Se isto n&amp;atilde;o for uma op&amp;ccedil;&amp;atilde;o, ent&amp;atilde;o voc&amp;ecirc; deve usar outro mecanismo para guardar a string, como executar a consulta diretamente com <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a>. </span> </li> </ul><p> <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_exec" value="<div id='function.odbc-exec' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-exec.php'>odbc_exec</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_exec</span> &amp;mdash; <span class='dc-title'>Prepara e executa um comando SQL</span></p> </div> <a name='function.odbc-exec.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_exec</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query_string</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$flags</tt></span> ] )</div> <p class='para rdfs-comment'> Envia um comando SQL para o servidor de banco de dados. </p> </div> <a name='function.odbc-exec.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador da conex&amp;atilde;o. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query_string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O comando SQL. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-exec.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de resultado ODBC se o comando foi executado com sucesso, ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> <a name='function.odbc-exec.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-prepare.php' class='function' rel='rdfs-seeAlso'>odbc_prepare()</a> - Prepara um comando para execu&amp;ccedil;&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-execute.php' class='function' rel='rdfs-seeAlso'>odbc_execute()</a> - Executa um comando preparado</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_errormsg" value="<div id='function.odbc-errormsg' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-errormsg.php'>odbc_errormsg</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_errormsg</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a &amp;uacute;ltima mensagem de erro</span></p> </div> <a name='function.odbc-errormsg.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>odbc_errormsg</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> ] )</div> <p class='simpara'> Retorna uma string contendo a &amp;uacute;ltima mensagem de erro do ODBC, ou uma string vazia se n&amp;atilde;o houveram erros. </p> </div> <a name='function.odbc-errormsg.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-errormsg.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Se <i><tt class='parameter'>connection_id</tt></i> for especificado, o &amp;uacute;ltimo estado desta conex&amp;atilde;o &amp;eacute; retornado, sen&amp;atilde;o a &amp;uacute;ltima mensagem de qualquer conex&amp;atilde;o &amp;eacute; retornada. </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o retorna um valor significante apenas se a ultima consulta odbc falhou (ex. <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a> retornou <b><tt class='constant'>FALSE</tt></b>). </p> </div> <a name='function.odbc-errormsg.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-error.php' class='function' rel='rdfs-seeAlso'>odbc_error()</a> - Obt&amp;eacute;m o &amp;uacute;ltimo c&amp;oacute;digo de erro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function' rel='rdfs-seeAlso'>odbc_exec()</a> - Prepara e executa um comando SQL</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_error" value="<div id='function.odbc-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-error.php'>odbc_error</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_error</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o &amp;uacute;ltimo c&amp;oacute;digo de erro</span></p> </div> <a name='function.odbc-error.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>odbc_error</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> ] )</div> <p class='simpara'> Retorna um estado ODBC de seis d&amp;iacute;gitos, ou uma string vazia se n&amp;atilde;o houveram erros. </p> </div> <a name='function.odbc-error.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The connection identifier. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Se <i><tt class='parameter'>connection_id</tt></i> &amp;eacute; especificado, o &amp;uacute;ltimo estado desta conex&amp;atilde;o &amp;eacute; especificado, sen&amp;atilde;o o &amp;uacute;ltimo estado de qualquer conex&amp;atilde;o. </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o retorna um valor significante apenas se a ultima consulta odbc falhou (ex. <a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function'>odbc_exec()</a> retornou <b><tt class='constant'>FALSE</tt></b>). </p> </div> <a name='function.odbc-error.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-errormsg.php' class='function' rel='rdfs-seeAlso'>odbc_errormsg()</a> - Obt&amp;eacute;m a &amp;uacute;ltima mensagem de erro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-exec.php' class='function' rel='rdfs-seeAlso'>odbc_exec()</a> - Prepara e executa um comando SQL</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_data_source" value="<div id='function.odbc-data-source' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-data-source.php'>odbc_data_source</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_data_source</span> &amp;mdash; <span class='dc-title'>Retorna informa&amp;ccedil;&amp;atilde;o sobre a conex&amp;atilde;o atual</span></p> </div> <a name='function.odbc-data-source.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>odbc_data_source</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fetch_type</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o retornar&amp;aacute; a lista de DNS dispon&amp;iacute;veis (depois de chamando v&amp;aacute;rias vezes). </p> </div> <a name='function.odbc-data-source.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>fetch_type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O <i><tt class='parameter'>fetch_type</tt></i> pode ser um dos dois tipos de contantes: <b><tt class='constant'>SQL_FETCH_FIRST</tt></b>, <b><tt class='constant'>SQL_FETCH_NEXT</tt></b>. Use <b><tt class='constant'>SQL_FETCH_FIRST</tt></b> na primeira vez que chamar a fun&amp;ccedil;&amp;atilde;o, ent&amp;atilde;o depois use <b><tt class='constant'>SQL_FETCH_NEXT</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-data-source.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>FALSE</tt></b> em erro, e um array em sucesso. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_cursor" value="<div id='function.odbc-cursor' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-cursor.php'>odbc_cursor</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_cursor</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o nome do cursor</span></p> </div> <a name='function.odbc-cursor.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>odbc_cursor</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o nome do cursor de um dado result_id. </p> </div> <a name='function.odbc-cursor.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de resultado. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-cursor.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o nome do cursor, como uma string. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_connect" value="<div id='function.odbc-connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-connect.php'>odbc_connect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_connect</span> &amp;mdash; <span class='dc-title'>Conecta com uma fonte de dados</span></p> </div> <a name='function.odbc-connect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_connect</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dsn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$user</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$password</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cursor_type</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna o id de uma conex&amp;atilde;o ODBC ou 0 (<b><tt class='constant'>FALSE</tt></b>) em caso de erro. </p> <p class='simpara'> O id da conex&amp;atilde;o retornado por esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; necess&amp;aacute;rio por outras fun&amp;ccedil;&amp;otilde;es ODBC. Voc&amp;ecirc; pode ter v&amp;aacute;rias conex&amp;otilde;es abertas de uma vez contando que elas usem um banco de dados ou credenciais diferentes. O quarto par&amp;acirc;metro, que &amp;eacute; opcional, define o tipo de cursor para ser utilizado nesta conex&amp;atilde;o. Este par&amp;acirc;metro normalmente n&amp;atilde;o &amp;eacute; necess&amp;aacute;rio, mas pode ser &amp;uacute;til para contornar problemas com alguns drivers ODBC. </p> <p class='simpara'> Com alguns drivers ODBC, executar uma stored procedure complexa pode falhar com um erro semelhante a este: &amp;quot;Cannot open a cursor on a stored procedure that has anything other than a single select statement in it&amp;quot;. Usar SQL_CUR_USE_ODBC pode previnir este erro. Tamb&amp;eacute;m, alguns drivers n&amp;atilde;o suportam o par&amp;acirc;metro opcional row_number em <a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-row.php' class='function'>odbc_fetch_row()</a>. SQL_CUR_USE_ODBC deve ajudar neste caso tamb&amp;eacute;m. </p> <p class='simpara'> As seguintes constantes s&amp;atilde;o definidas para cursortype: </p> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> SQL_CUR_USE_IF_NEEDED </span> </li> <li class='listitem'> <span class='simpara'> SQL_CUR_USE_ODBC </span> </li> <li class='listitem'> <span class='simpara'> SQL_CUR_USE_DRIVER </span> </li> <li class='listitem'> <span class='simpara'> SQL_CUR_DEFAULT </span></li> </ul><p> </p> <p class='simpara'> Para conex&amp;otilde;es persistentes veja <a href='http://www.php.net/manual/pt_BR/function.odbc-pconnect.php' class='function'>odbc_pconnect()</a>. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_commit" value="<div id='function.odbc-commit' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-commit.php'>odbc_commit</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_commit</span> &amp;mdash; <span class='dc-title'>Grava uma transa&amp;ccedil;&amp;atilde;o ODBC</span></p> </div> <a name='function.odbc-commit.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_commit</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> )</div> <p class='para rdfs-comment'> Grava todas as transa&amp;ccedil;&amp;otilde;es pendentes na conex&amp;atilde;o. </p> </div> <a name='function.odbc-commit.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-commit.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_columns" value="<div id='function.odbc-columns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-columns.php'>odbc_columns</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_columns</span> &amp;mdash; <span class='dc-title'>Lista os nomes das colunas na tabela especificada</span></p> </div> <a name='function.odbc-columns.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_columns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$column_name</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Lista todas as colunas no intervalo requerido. </p> </div> <a name='function.odbc-columns.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O quantificador. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The owner. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da tabela. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da coluna. </p> </dd> </dl> <p> </p> <p class='para'> O <i><tt class='parameter'>schema</tt></i> , <i><tt class='parameter'>table_name</tt></i> , e <i><tt class='parameter'>column_name</tt></i> aceitam padr&amp;otilde;es de busca (&amp;#039;%&amp;#039; para casar zero ou mais caracteres e &amp;#039;_&amp;#039; para casar um &amp;uacute;nico caractere). </p> </div> <a name='function.odbc-columns.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>TABLE_SCHEM</span></li> <li class='listitem'><span class='simpara'>TABLE_NAME</span></li> <li class='listitem'><span class='simpara'>COLUMN_NAME</span></li> <li class='listitem'><span class='simpara'>DATA_TYPE</span></li> <li class='listitem'><span class='simpara'>TYPE_NAME</span></li> <li class='listitem'><span class='simpara'>PRECISION</span></li> <li class='listitem'><span class='simpara'>LENGTH</span></li> <li class='listitem'><span class='simpara'>SCALE</span></li> <li class='listitem'><span class='simpara'>RADIX</span></li> <li class='listitem'><span class='simpara'>NULLABLE</span></li> <li class='listitem'><span class='simpara'>REMARKS</span></li> </ul><p> </p> <p class='para'> O conjunto de resultados &amp;eacute; ordenado por TABLE_QUALIFIER, TABLE_SCHEM e TABLE_NAME. </p> </div> <a name='function.odbc-columns.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-columnprivileges.php' class='function' rel='rdfs-seeAlso'>odbc_columnprivileges()</a> - Retorna um identificador de resultado que pode ser usado para obter uma lista das colunas e seus privil&amp;eacute;gios associados para recuperar privil&amp;eacute;gios associados</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_columnprivileges" value="<div id='function.odbc-columnprivileges' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-columnprivileges.php'>odbc_columnprivileges</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_columnprivileges</span> &amp;mdash; <span class='dc-title'>Retorna um identificador de resultado que pode ser usado para obter uma lista das colunas e seus privil&amp;eacute;gios associados</span></p> </div> <a name='function.odbc-columnprivileges.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>odbc_columnprivileges</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$owner</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$column_name</tt></span> )</div> <p class='para rdfs-comment'> Lista colunas e os privil&amp;eacute;gios associados a tabela indicada. </p> </div> <a name='function.odbc-columnprivileges.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O quantificador. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>owner</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O propriet&amp;aacute;rio. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da tabela. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O argumento <i><tt class='parameter'>column_name</tt></i> aceita padr&amp;otilde;es de busca (&amp;#039;%&amp;#039; para casar zero ou mais caracteres e &amp;#039;_&amp;#039; para casa um &amp;uacute;nico caractere). </p> </dd> </dl> <p> </p> <p class='para'> The <i><tt class='parameter'>owner</tt></i> , <i><tt class='parameter'>table_name</tt></i> , and <i><tt class='parameter'>column_name</tt></i> accept search patterns (&amp;#039;%&amp;#039; to match zero or more characters and &amp;#039;_&amp;#039; to match a single character). </p> </div> <a name='function.odbc-columnprivileges.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de resultado ODBC ou <b><tt class='constant'>FALSE</tt></b> em erro. Este identificador de resultado pode ser usado para obter uma lista de colunas e seus privil&amp;eacute;gios. </p> <p class='para'> O conjunto de resultados tem as seguintes colunas: </p><ul class='itemizedlist'> <li class='listitem'><span class='simpara'>TABLE_QUALIFIER</span></li> <li class='listitem'><span class='simpara'>TABLE_OWNER</span></li> <li class='listitem'><span class='simpara'>TABLE_NAME</span></li> <li class='listitem'><span class='simpara'>GRANTOR</span></li> <li class='listitem'><span class='simpara'>GRANTEE</span></li> <li class='listitem'><span class='simpara'>PRIVILEGE</span></li> <li class='listitem'><span class='simpara'>IS_GRANTABLE</span></li> </ul><p> </p> <p class='para'> O conjunto de resultados &amp;eacute; ordenado por TABLE_QUALIFIER, TABLE_OWNER e TABLE_NAME. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_close_all" value="<div id='function.odbc-close-all' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-close-all.php'>odbc_close_all</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_close_all</span> &amp;mdash; <span class='dc-title'>Fecha todas as conex&amp;otilde;es ODBC</span></p> </div> <a name='function.odbc-close-all.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>odbc_close_all</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> <b>odbc_close_all()</b> ir&amp;aacute; fechar todas as conex&amp;otilde;es para os servidores de banco de dados. </p> </div> <a name='function.odbc-close-all.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> N&amp;atilde;o h&amp;aacute; valor retornado. </p> </div> <a name='function.odbc-close-all.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; falhar se houverem transa&amp;ccedil;&amp;otilde;es abertas na conex&amp;atilde;o. Neste caso a conex&amp;atilde;o permanecer&amp;aacute; aberta. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_close" value="<div id='function.odbc-close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-close.php'>odbc_close</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_close</span> &amp;mdash; <span class='dc-title'>Fecha uma conex&amp;atilde;o ODBC</span></p> </div> <a name='function.odbc-close.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>odbc_close</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> )</div> <p class='para rdfs-comment'> Fecha a conex&amp;atilde;o com o servidor de banco de dados. </p> </div> <a name='function.odbc-close.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-close.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> N&amp;atilde;o h&amp;aacute; valor retornado. </p> </div> <a name='function.odbc-close.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; falhar se houverem transa&amp;ccedil;&amp;otilde;es abertas nesta conex&amp;atilde;o. A conex&amp;atilde;o permanecer&amp;aacute; aberta neste caso. <br /> </p></blockquote> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_binmode" value="<div id='function.odbc-binmode' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-binmode.php'>odbc_binmode</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_binmode</span> &amp;mdash; <span class='dc-title'>Manipula&amp;ccedil;&amp;atilde;o de uma coluna com dados bin&amp;aacute;rios</span></p> </div> <a name='function.odbc-binmode.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>odbc_binmode</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_id</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mode</tt></span> )</div> <p class='para rdfs-comment'> Habilita o manuseamento de coluna de dados bin&amp;aacute;rios. Tipos ODBC SQL afetados s&amp;atilde;o BINARY, VARBINARY, e LONGVARBINARY. </p> <p class='para'> Quando dados bin&amp;aacute;rios SQL s&amp;atilde;o convertidos para dados de caractere C, cada (8 bits) dos dados da fonte s&amp;atilde;o representados como dois caracteres ASCII. Estes caracteres s&amp;atilde;o a representa&amp;ccedil;&amp;atilde;o em caracteres ASCII do n&amp;uacute;mero em sua forma hexadecimal. por exemplo, um bin&amp;aacute;rio 00000001 &amp;eacute; convertido para <i>&amp;quot;01&amp;quot;</i> e um bin&amp;aacute;rio 11111111 &amp;eacute; convertido para <i>&amp;quot;FF&amp;quot;</i>. </p><table class='doctable table'> <caption><b>Manipulando LONGVARBINARY</b></caption> <thead valign='middle'> <tr valign='middle'> <th>binmode</th> <th>longreadlen</th> <th>result</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>ODBC_BINMODE_PASSTHRU</td> <td align='left'>0</td> <td align='left'>passthru</td> </tr> <tr valign='middle'> <td align='left'>ODBC_BINMODE_RETURN</td> <td align='left'>0</td> <td align='left'>passthru</td> </tr> <tr valign='middle'> <td align='left'>ODBC_BINMODE_CONVERT</td> <td align='left'>0</td> <td align='left'>passthru</td> </tr> <tr valign='middle'> <td align='left'>ODBC_BINMODE_PASSTHRU</td> <td align='left'>0</td> <td align='left'>passthru</td> </tr> <tr valign='middle'> <td align='left'>ODBC_BINMODE_PASSTHRU</td> <td align='left'>&amp;gt;0</td> <td align='left'>passthru</td> </tr> <tr valign='middle'> <td align='left'>ODBC_BINMODE_RETURN</td> <td align='left'>&amp;gt;0</td> <td align='left'>retorna como esta</td> </tr> <tr valign='middle'> <td align='left'>ODBC_BINMODE_CONVERT</td> <td align='left'>&amp;gt;0</td> <td align='left'>retorna como char</td> </tr> </tbody> </table> <p> </p> <p class='para'> Se <a href='http://www.php.net/manual/pt_BR/function.odbc-fetch-into.php' class='function'>odbc_fetch_into()</a> &amp;eacute; usada, passthru indica que uma string vazia &amp;eacute; retornada para estas colunas. </p> </div> <a name='function.odbc-binmode.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The result identifier. </p> <p class='para'> Se <i><tt class='parameter'>result_id</tt></i> for <i>0</i>, as defini&amp;ccedil;&amp;otilde;es aplicam-se como padr&amp;atilde;o para novos resultados. </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> O padr&amp;atilde;o para longreadlen e <i>4096</i> e <i><tt class='parameter'>mode</tt></i> padr&amp;atilde;o para <i>ODBC_BINMODE_RETURN</i>. A manipula&amp;ccedil;&amp;atilde;o de colunas binary long tamb&amp;eacute;m &amp;eacute; afetada por <a href='http://www.php.net/manual/pt_BR/function.odbc-longreadlen.php' class='function'>odbc_longreadlen()</a>. </span> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>mode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Poss&amp;iacute;veis valores para <i><tt class='parameter'>mode</tt></i> s&amp;atilde;o: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>ODBC_BINMODE_PASSTHRU</tt></b>: Passthru BINARY data </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>ODBC_BINMODE_RETURN</tt></b>: Retorna como &amp;eacute; </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>ODBC_BINMODE_CONVERT</tt></b>: Converte para char e retorna </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-binmode.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="odbc_autocommit" value="<div id='function.odbc-autocommit' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.odbc-autocommit.php'>odbc_autocommit</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>odbc_autocommit</span> &amp;mdash; <span class='dc-title'>Modifica o funcionamento do autocommit</span></p> </div> <a name='function.odbc-autocommit.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>odbc_autocommit</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection_id</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$OnOff</tt></span> ] )</div> <p class='para rdfs-comment'> Modifica o comportamento do autocommit. </p> <p class='para'> Por padr&amp;atilde;o. o auto-commit esta em on para a conex&amp;atilde;o. Desabilitar o auto-commit &amp;eacute; equivalente a come&amp;ccedil;ar uma transa&amp;ccedil;&amp;atilde;o. </p> </div> <a name='function.odbc-autocommit.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection_id</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O identificador de conex&amp;atilde;o. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>OnOff</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se <i><tt class='parameter'>OnOff</tt></i> &amp;eacute; <b><tt class='constant'>TRUE</tt></b>, auto-commit &amp;eacute; habilitado, se &amp;eacute; <b><tt class='constant'>FALSE</tt></b> auto-commit &amp;eacute; desabilitado. </p> </dd> </dl> <p> </p> </div> <a name='function.odbc-autocommit.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Sem o par&amp;acirc;metro <i><tt class='parameter'>OnOff</tt></i> , esta fun&amp;ccedil;&amp;atilde;o retorna status do auto-commit para <i><tt class='parameter'>connection_id</tt></i> . Valor diferente de zero retorna se auto-commit est&amp;aacute; on, 0 se ele est&amp;aacute; off, ou <b><tt class='constant'>FALSE</tt></b> se um erro ocorrer. </p> <p class='para'> Se <i><tt class='parameter'>OnOff</tt></i> &amp;eacute; definido, esta fun&amp;ccedil;&amp;atilde;o retorna <b><tt class='constant'>TRUE</tt></b> em sucesso e <b><tt class='constant'>FALSE</tt></b> em falha. </p> </div> <a name='function.odbc-autocommit.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-commit.php' class='function' rel='rdfs-seeAlso'>odbc_commit()</a> - Grava uma transa&amp;ccedil;&amp;atilde;o ODBC</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.odbc-rollback.php' class='function' rel='rdfs-seeAlso'>odbc_rollback()</a> - Desfaz uma transa&amp;ccedil;&amp;atilde;o</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_unbind" value="<div id='function.ldap-unbind' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-unbind.php'>ldap_unbind</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_unbind</span> &amp;mdash; <span class='dc-title'>Unbind from LDAP directory</span></p> </div> <a name='function.ldap-unbind.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_unbind</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> )</div> <p class='para rdfs-comment'> Unbinds from the LDAP directory. </p> </div> <a name='function.ldap-unbind.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-unbind.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-unbind.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-bind.php' class='function' rel='rdfs-seeAlso'>ldap_bind()</a> - Bind to LDAP directory</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_start_tls" value="<div id='function.ldap-start-tls' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-start-tls.php'>ldap_start_tls</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_start_tls</span> &amp;mdash; <span class='dc-title'>Start TLS</span></p> </div> <a name='function.ldap-start-tls.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_start_tls</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link</tt></span> )</div> <div class='warning'><b class='warning'>Aviso</b><p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; documentada; somente a lista de argumentos est&amp;aacute; dispon&amp;iacute;vel.</p></div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_sort" value="<div id='function.ldap-sort' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-sort.php'>ldap_sort</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_sort</span> &amp;mdash; <span class='dc-title'>Sort LDAP result entries</span></p> </div> <a name='function.ldap-sort.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_sort</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$sortfilter</tt></span> )</div> <div class='warning'><b class='warning'>Aviso</b><p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; documentada; somente a lista de argumentos est&amp;aacute; dispon&amp;iacute;vel.</p></div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_set_option" value="<div id='function.ldap-set-option' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-set-option.php'>ldap_set_option</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_set_option</span> &amp;mdash; <span class='dc-title'>Set the value of the given option</span></p> </div> <a name='function.ldap-set-option.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_set_option</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$option</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$newval</tt></span> )</div> <p class='para rdfs-comment'> Sets the value of the specified option to be <i><tt class='parameter'>newval</tt></i> . </p> </div> <a name='function.ldap-set-option.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The parameter <i><tt class='parameter'>option</tt></i> can be one of: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Option</th> <th>Type</th> <th>Available since</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_DEREF</tt></b></td> <td align='left'>integer</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_SIZELIMIT</tt></b></td> <td align='left'>integer</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_TIMELIMIT</tt></b></td> <td align='left'>integer</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_NETWORK_TIMEOUT</tt></b></td> <td align='left'>integer</td> <td align='left'>PHP 5.3.0</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_PROTOCOL_VERSION</tt></b></td> <td align='left'>integer</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_ERROR_NUMBER</tt></b></td> <td align='left'>integer</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_REFERRALS</tt></b></td> <td align='left'>bool</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_RESTART</tt></b></td> <td align='left'>bool</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_HOST_NAME</tt></b></td> <td align='left'>string</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_ERROR_STRING</tt></b></td> <td align='left'>string</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_MATCHED_DN</tt></b></td> <td align='left'>string</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_SERVER_CONTROLS</tt></b></td> <td align='left'>array</td> <td class='empty'>&amp;nbsp;</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_CLIENT_CONTROLS</tt></b></td> <td align='left'>array</td> <td class='empty'>&amp;nbsp;</td> </tr> </tbody> </table> <p> </p> <p class='para'> <b><tt class='constant'>LDAP_OPT_SERVER_CONTROLS</tt></b> and <b><tt class='constant'>LDAP_OPT_CLIENT_CONTROLS</tt></b> require a list of controls, this means that the value must be an array of controls. A control consists of an <em class='emphasis'>oid</em> identifying the control, an optional <em class='emphasis'>value</em>, and an optional flag for <em class='emphasis'>criticality</em>. In PHP a control is given by an array containing an element with the key <em class='emphasis'>oid</em> and string value, and two optional elements. The optional elements are key <em class='emphasis'>value</em> with string value and key <em class='emphasis'>iscritical</em> with boolean value. <em class='emphasis'>iscritical</em> defaults to <em class='emphasis'><b><tt class='constant'>FALSE</tt></b></em> if not supplied. See <a href='http://www.openldap.org/devel/cvsweb.cgi/~checkout~/doc/drafts/draft-ietf-ldapext-ldap-c-api-xx.txt' class='link external'>&amp;raquo; draft-ietf-ldapext-ldap-c-api-xx.txt</a> for details. See also the second example below. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>newval</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The new value for the specified <i><tt class='parameter'>option</tt></i> . </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-set-option.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-set-option.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Set protocol version</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;server<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>ldap_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>LDAP_OPT_PROTOCOL_VERSION</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Using&amp;nbsp;LDAPv3'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Failed&amp;nbsp;to&amp;nbsp;set&amp;nbsp;protocol&amp;nbsp;version&amp;nbsp;to&amp;nbsp;3'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Set server controls</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;server<br />//&amp;nbsp;control&amp;nbsp;with&amp;nbsp;no&amp;nbsp;value<br /></span><span style='color: #0000BB'>$ctrl1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'oid'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'1.2.752.58.10.1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'iscritical'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//&amp;nbsp;iscritical&amp;nbsp;defaults&amp;nbsp;to&amp;nbsp;FALSE<br /></span><span style='color: #0000BB'>$ctrl2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'oid'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'1.2.752.58.1.10'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'value'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'magic'</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//&amp;nbsp;try&amp;nbsp;to&amp;nbsp;set&amp;nbsp;both&amp;nbsp;controls<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>ldap_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>LDAP_OPT_SERVER_CONTROLS</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>$ctrl1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$ctrl2</span><span style='color: #007700'>)))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Failed&amp;nbsp;to&amp;nbsp;set&amp;nbsp;server&amp;nbsp;controls'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-set-option.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function is only available when using OpenLDAP 2.x.x OR Netscape Directory SDK x.x. <br /> </p></blockquote> </div> <a name='function.ldap-set-option.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-option.php' class='function' rel='rdfs-seeAlso'>ldap_get_option()</a> - Get the current value for given option</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_search" value="<div id='function.ldap-search' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-search.php'>ldap_search</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_search</span> &amp;mdash; <span class='dc-title'>Search LDAP tree</span></p> </div> <a name='function.ldap-search.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_search</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$base_dn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filter</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$attributes</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attrsonly</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$sizelimit</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$timelimit</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$deref</tt></span> ]]]]] )</div> <p class='para rdfs-comment'> Performs the search for a specified filter on the directory with the scope of <b><tt class='constant'>LDAP_SCOPE_SUBTREE</tt></b>. This is equivalent to searching the entire directory. </p> <p class='para'> From 4.0.5 on it&amp;#039;s also possible to do parallel searches. To do this you use an array of link identifiers, rather than a single identifier, as the first argument. If you don&amp;#039;t want the same base DN and the same filter for all the searches, you can also use an array of base DNs and/or an array of filters. Those arrays must be of the same size as the link identifier array since the first entries of the arrays are used for one search, the second entries are used for another, and so on. When doing parallel searches an array of search result identifiers is returned, except in case of error, then the entry corresponding to the search will be <b><tt class='constant'>FALSE</tt></b>. This is very much like the value normally returned, except that a result identifier is always returned when a search was made. There are some rare cases where the normal search returns <b><tt class='constant'>FALSE</tt></b> while the parallel search returns an identifier. </p> </div> <a name='function.ldap-search.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>base_dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The base DN for the directory. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filter</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search filter can be simple or advanced, using boolean operators in the format described in the LDAP documentation (see the <a href='http://www.mozilla.org/directory/csdk-docs/filter.htm' class='link external'>&amp;raquo; Netscape Directory SDK</a> for full information on filters). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attributes</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of the required attributes, e.g. <i>array(&amp;quot;mail&amp;quot;, &amp;quot;sn&amp;quot;, &amp;quot;cn&amp;quot;)</i>. Note that the &amp;quot;dn&amp;quot; is always returned irrespective of which attributes types are requested. </p> <p class='para'> Using this parameter is much more efficient than the default action (which is to return all attributes and their associated values). The use of this parameter should therefore be considered good practice. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attrsonly</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Should be set to 1 if only attribute types are wanted. If set to 0 both attributes types and attribute values are fetched which is the default behaviour. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>sizelimit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Enables you to limit the count of entries fetched. Setting this to 0 means no limit. </p> <blockquote><p><b class='note'>Nota</b>: This parameter can NOT override server-side preset sizelimit. You can set it lower though. <br /> Some directory server hosts will be configured to return no more than a preset number of entries. If this occurs, the server will indicate that it has only returned a partial results set. This also occurs if you use this parameter to limit the count of fetched entries. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>timelimit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Sets the number of seconds how long is spend on the search. Setting this to 0 means no limit. </p> <blockquote><p><b class='note'>Nota</b>: This parameter can NOT override server-side preset timelimit. You can set it lower though. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>deref</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies how aliases should be handled during the search. It can be one of the following: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_NEVER</tt></b> - (default) aliases are never dereferenced. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_SEARCHING</tt></b> - aliases should be dereferenced during the search but not when locating the base object of the search. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_FINDING</tt></b> - aliases should be dereferenced when locating the base object but not during the search. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_ALWAYS</tt></b> - aliases should be dereferenced always. </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-search.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a search result identifier or <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-search.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>4.0.5</td> <td align='left'> Parallel searches support was added. </td> </tr> <tr valign='middle'> <td align='left'>4.0.2</td> <td align='left'> The <i><tt class='parameter'>attrsonly</tt></i> , <i><tt class='parameter'>sizelimit</tt></i> , <i><tt class='parameter'>timelimit</tt></i> and <i><tt class='parameter'>deref</tt></i> were added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ldap-search.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> The example below retrieves the organizational unit, surname, given name and email address for all people in &amp;quot;My Company&amp;quot; where the surname or given name contains the substring <var class='varname'>$person</var>. This example uses a boolean filter to tell the server to look for information in more than one attribute. </p><div class='example'> <p><b>Exemplo #1 LDAP search</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;server<br /><br />//&amp;nbsp;$person&amp;nbsp;is&amp;nbsp;all&amp;nbsp;or&amp;nbsp;part&amp;nbsp;of&amp;nbsp;a&amp;nbsp;person's&amp;nbsp;name,&amp;nbsp;eg&amp;nbsp;'Jo'<br /><br /></span><span style='color: #0000BB'>$dn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'o=My&amp;nbsp;Company,&amp;nbsp;c=US'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$filter</span><span style='color: #007700'>=</span><span style='color: #DD0000'>'(|(sn=</span><span style='color: #0000BB'>$person</span><span style='color: #DD0000'>*)(givenname=</span><span style='color: #0000BB'>$person</span><span style='color: #DD0000'>*))'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$justthese&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'ou'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'sn'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'givenname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mail'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$sr</span><span style='color: #007700'>=</span><span style='color: #0000BB'>ldap_search</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$dn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$filter</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$justthese</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$info&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_get_entries</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sr</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'count'</span><span style='color: #007700'>].</span><span style='color: #DD0000'>'&amp;nbsp;entries&amp;nbsp;returned\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_rename" value="<div id='function.ldap-rename' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-rename.php'>ldap_rename</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_rename</span> &amp;mdash; <span class='dc-title'>Modify the name of an entry</span></p> </div> <a name='function.ldap-rename.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_rename</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$newrdn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$newparent</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$deleteoldrdn</tt></span> )</div> <p class='para rdfs-comment'> The entry specified by <i><tt class='parameter'>dn</tt></i> is renamed/moved. </p> </div> <a name='function.ldap-rename.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>newrdn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The new RDN. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>newparent</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The new parent/superior entry. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>deleteoldrdn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If <b><tt class='constant'>TRUE</tt></b> the old RDN value(s) is removed, else the old RDN value(s) is retained as non-distinguished values of the entry. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-rename.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-rename.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function currently only works with LDAPv3. You may have to use <a href='http://www.php.net/manual/pt_BR/function.ldap-set-option.php' class='function'>ldap_set_option()</a> prior to binding to use LDAPv3. This function is only available when using OpenLDAP 2.x.x OR Netscape Directory SDK x.x. <br /> </p></blockquote> </div> <a name='function.ldap-rename.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-modify.php' class='function' rel='rdfs-seeAlso'>ldap_modify()</a> - Modify an LDAP entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_read" value="<div id='function.ldap-read' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-read.php'>ldap_read</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_read</span> &amp;mdash; <span class='dc-title'>Read an entry</span></p> </div> <a name='function.ldap-read.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_read</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$base_dn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filter</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$attributes</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attrsonly</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$sizelimit</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$timelimit</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$deref</tt></span> ]]]]] )</div> <p class='para rdfs-comment'> Performs the search for a specified <i><tt class='parameter'>filter</tt></i> on the directory with the scope <b><tt class='constant'>LDAP_SCOPE_BASE</tt></b>. So it is equivalent to reading an entry from the directory. </p> </div> <a name='function.ldap-read.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>base_dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The base DN for the directory. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filter</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An empty filter is not allowed. If you want to retrieve absolutely all information for this entry, use a filter of <i>objectClass=*</i>. If you know which entry types are used on the directory server, you might use an appropriate filter such as <i>objectClass=inetOrgPerson</i>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attributes</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of the required attributes, e.g. array(&amp;quot;mail&amp;quot;, &amp;quot;sn&amp;quot;, &amp;quot;cn&amp;quot;). Note that the &amp;quot;dn&amp;quot; is always returned irrespective of which attributes types are requested. </p> <p class='para'> Using this parameter is much more efficient than the default action (which is to return all attributes and their associated values). The use of this parameter should therefore be considered good practice. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attrsonly</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Should be set to 1 if only attribute types are wanted. If set to 0 both attributes types and attribute values are fetched which is the default behaviour. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>sizelimit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Enables you to limit the count of entries fetched. Setting this to 0 means no limit. </p> <blockquote><p><b class='note'>Nota</b>: This parameter can NOT override server-side preset sizelimit. You can set it lower though. <br /> Some directory server hosts will be configured to return no more than a preset number of entries. If this occurs, the server will indicate that it has only returned a partial results set. This also occurs if you use this parameter to limit the count of fetched entries. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>timelimit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Sets the number of seconds how long is spend on the search. Setting this to 0 means no limit. </p> <blockquote><p><b class='note'>Nota</b>: This parameter can NOT override server-side preset timelimit. You can set it lower though. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>deref</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies how aliases should be handled during the search. It can be one of the following: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_NEVER</tt></b> - (default) aliases are never dereferenced. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_SEARCHING</tt></b> - aliases should be dereferenced during the search but not when locating the base object of the search. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_FINDING</tt></b> - aliases should be dereferenced when locating the base object but not during the search. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_ALWAYS</tt></b> - aliases should be dereferenced always. </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-read.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a search result identifier or <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-read.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>4.0.5</td> <td align='left'> Parallel searches support was added. See <a href='http://www.php.net/manual/pt_BR/function.ldap-search.php' class='function'>ldap_search()</a> for details. </td> </tr> <tr valign='middle'> <td align='left'>4.0.2</td> <td align='left'> The <i><tt class='parameter'>attrsonly</tt></i> , <i><tt class='parameter'>sizelimit</tt></i> , <i><tt class='parameter'>timelimit</tt></i> and <i><tt class='parameter'>deref</tt></i> were added. </td> </tr> </tbody> </table> <p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_parse_result" value="<div id='function.ldap-parse-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-parse-result.php'>ldap_parse_result</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_parse_result</span> &amp;mdash; <span class='dc-title'>Extract information from result</span></p> </div> <a name='function.ldap-parse-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_parse_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter reference'>&amp;amp;$errcode</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter reference'>&amp;amp;$matcheddn</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter reference'>&amp;amp;$errmsg</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$referrals</tt></span> ]]] )</div> <div class='warning'><b class='warning'>Aviso</b><p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; documentada; somente a lista de argumentos est&amp;aacute; dispon&amp;iacute;vel.</p></div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_parse_reference" value="<div id='function.ldap-parse-reference' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-parse-reference.php'>ldap_parse_reference</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_parse_reference</span> &amp;mdash; <span class='dc-title'>Extract information from reference entry</span></p> </div> <a name='function.ldap-parse-reference.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_parse_reference</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$entry</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$referrals</tt></span> )</div> <div class='warning'><b class='warning'>Aviso</b><p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; documentada; somente a lista de argumentos est&amp;aacute; dispon&amp;iacute;vel.</p></div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_next_reference" value="<div id='function.ldap-next-reference' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-next-reference.php'>ldap_next_reference</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_next_reference</span> &amp;mdash; <span class='dc-title'>Get next reference</span></p> </div> <a name='function.ldap-next-reference.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_next_reference</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$entry</tt></span> )</div> <div class='warning'><b class='warning'>Aviso</b><p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; documentada; somente a lista de argumentos est&amp;aacute; dispon&amp;iacute;vel.</p></div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_next_entry" value="<div id='function.ldap-next-entry' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-next-entry.php'>ldap_next_entry</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_next_entry</span> &amp;mdash; <span class='dc-title'>Get next result entry</span></p> </div> <a name='function.ldap-next-entry.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_next_entry</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> )</div> <p class='para rdfs-comment'> Retrieve the entries stored in the result. Successive calls to the <b>ldap_next_entry()</b> return entries one by one till there are no more entries. The first call to <b>ldap_next_entry()</b> is made after the call to <a href='http://www.php.net/manual/pt_BR/function.ldap-first-entry.php' class='function'>ldap_first_entry()</a> with the <i><tt class='parameter'>result_entry_identifier</tt></i> as returned from the <a href='http://www.php.net/manual/pt_BR/function.ldap-first-entry.php' class='function'>ldap_first_entry()</a>. </p> </div> <a name='function.ldap-next-entry.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-next-entry.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns entry identifier for the next entry in the result whose entries are being read starting with <a href='http://www.php.net/manual/pt_BR/function.ldap-first-entry.php' class='function'>ldap_first_entry()</a>. If there are no more entries in the result then it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.ldap-next-entry.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-entries.php' class='function' rel='rdfs-seeAlso'>ldap_get_entries()</a> - Get all result entries</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_next_attribute" value="<div id='function.ldap-next-attribute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-next-attribute.php'>ldap_next_attribute</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_next_attribute</span> &amp;mdash; <span class='dc-title'>Get the next attribute in result</span></p> </div> <a name='function.ldap-next-attribute.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>ldap_next_attribute</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> )</div> <p class='para rdfs-comment'> Retrieves the attributes in an entry. The first call to <b>ldap_next_attribute()</b> is made with the <i><tt class='parameter'>result_entry_identifier</tt></i> returned from <a href='http://www.php.net/manual/pt_BR/function.ldap-first-attribute.php' class='function'>ldap_first_attribute()</a>. </p> </div> <a name='function.ldap-next-attribute.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>ber_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The internal state of the pointer is maintained by this parameter. </p> <blockquote><p><b class='note'>Nota</b>: This parameter is no longer used as this is now handled automatically by PHP. For backwards compatibility PHP will not throw an error if this parameter is passed. <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='function.ldap-next-attribute.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the next attribute in an entry on success and <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-next-attribute.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>5.2.4</td> <td align='left'> The <i><tt class='parameter'>ber_identifier</tt></i> was removed. This is now handled automatically by PHP. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ldap-next-attribute.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-attributes.php' class='function' rel='rdfs-seeAlso'>ldap_get_attributes()</a> - Get attributes from a search result entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_mod_replace" value="<div id='function.ldap-mod-replace' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-mod-replace.php'>ldap_mod_replace</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_mod_replace</span> &amp;mdash; <span class='dc-title'>Replace attribute values with new ones</span></p> </div> <a name='function.ldap-mod-replace.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_mod_replace</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$entry</tt></span> )</div> <p class='para rdfs-comment'> Replaces one or more attributes from the specified <i><tt class='parameter'>dn</tt></i> . It performs the modification at the attribute level as opposed to the object level. Object-level modifications are done by the <a href='http://www.php.net/manual/pt_BR/function.ldap-modify.php' class='function'>ldap_modify()</a> function. </p> </div> <a name='function.ldap-mod-replace.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>entry</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-mod-replace.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-mod-replace.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; compat&amp;iacute;vel com dados bin&amp;aacute;rios</span></p></blockquote> </div> <a name='function.ldap-mod-replace.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-mod-del.php' class='function' rel='rdfs-seeAlso'>ldap_mod_del()</a> - Delete attribute values from current attributes</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-mod-add.php' class='function' rel='rdfs-seeAlso'>ldap_mod_add()</a> - Add attribute values to current attributes</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_mod_del" value="<div id='function.ldap-mod-del' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-mod-del.php'>ldap_mod_del</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_mod_del</span> &amp;mdash; <span class='dc-title'>Delete attribute values from current attributes</span></p> </div> <a name='function.ldap-mod-del.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_mod_del</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$entry</tt></span> )</div> <p class='para rdfs-comment'> Removes one or more attributes from the specified <i><tt class='parameter'>dn</tt></i> . It performs the modification at the attribute level as opposed to the object level. Object-level deletions are done by the <a href='http://www.php.net/manual/pt_BR/function.ldap-delete.php' class='function'>ldap_delete()</a> function. </p> </div> <a name='function.ldap-mod-del.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>entry</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-mod-del.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-mod-del.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-mod-add.php' class='function' rel='rdfs-seeAlso'>ldap_mod_add()</a> - Add attribute values to current attributes</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-mod-replace.php' class='function' rel='rdfs-seeAlso'>ldap_mod_replace()</a> - Replace attribute values with new ones</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_mod_add" value="<div id='function.ldap-mod-add' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-mod-add.php'>ldap_mod_add</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_mod_add</span> &amp;mdash; <span class='dc-title'>Add attribute values to current attributes</span></p> </div> <a name='function.ldap-mod-add.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_mod_add</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$entry</tt></span> )</div> <p class='para rdfs-comment'> Adds one or more attributes to the specified <i><tt class='parameter'>dn</tt></i> . It performs the modification at the attribute level as opposed to the object level. Object-level additions are done by the <a href='http://www.php.net/manual/pt_BR/function.ldap-add.php' class='function'>ldap_add()</a> function. </p> </div> <a name='function.ldap-mod-add.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>entry</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-mod-add.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-mod-add.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; compat&amp;iacute;vel com dados bin&amp;aacute;rios</span></p></blockquote> </div> <a name='function.ldap-mod-add.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-mod-del.php' class='function' rel='rdfs-seeAlso'>ldap_mod_del()</a> - Delete attribute values from current attributes</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-mod-replace.php' class='function' rel='rdfs-seeAlso'>ldap_mod_replace()</a> - Replace attribute values with new ones</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_modify" value="<div id='function.ldap-modify' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-modify.php'>ldap_modify</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_modify</span> &amp;mdash; <span class='dc-title'>Modify an LDAP entry</span></p> </div> <a name='function.ldap-modify.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_modify</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$entry</tt></span> )</div> <p class='para rdfs-comment'> Modify the existing entries in the LDAP directory. The structure of the entry is same as in <a href='http://www.php.net/manual/pt_BR/function.ldap-add.php' class='function'>ldap_add()</a>. </p> </div> <a name='function.ldap-modify.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>entry</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-modify.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-modify.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; compat&amp;iacute;vel com dados bin&amp;aacute;rios</span></p></blockquote> </div> <a name='function.ldap-modify.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-rename.php' class='function' rel='rdfs-seeAlso'>ldap_rename()</a> - Modify the name of an entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_list" value="<div id='function.ldap-list' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-list.php'>ldap_list</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_list</span> &amp;mdash; <span class='dc-title'>Single-level search</span></p> </div> <a name='function.ldap-list.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_list</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$base_dn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filter</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$attributes</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attrsonly</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$sizelimit</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$timelimit</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$deref</tt></span> ]]]]] )</div> <p class='para rdfs-comment'> Performs the search for a specified <i><tt class='parameter'>filter</tt></i> on the directory with the scope <b><tt class='constant'>LDAP_SCOPE_ONELEVEL</tt></b>. </p> <p class='para'> <b><tt class='constant'>LDAP_SCOPE_ONELEVEL</tt></b> means that the search should only return information that is at the level immediately below the <i><tt class='parameter'>base_dn</tt></i> given in the call. (Equivalent to typing &amp;quot;<strong class='command'>ls</strong>&amp;quot; and getting a list of files and folders in the current working directory.) </p> </div> <a name='function.ldap-list.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>base_dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The base DN for the directory. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filter</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attributes</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of the required attributes, e.g. array(&amp;quot;mail&amp;quot;, &amp;quot;sn&amp;quot;, &amp;quot;cn&amp;quot;). Note that the &amp;quot;dn&amp;quot; is always returned irrespective of which attributes types are requested. </p> <p class='para'> Using this parameter is much more efficient than the default action (which is to return all attributes and their associated values). The use of this parameter should therefore be considered good practice. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attrsonly</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Should be set to 1 if only attribute types are wanted. If set to 0 both attributes types and attribute values are fetched which is the default behaviour. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>sizelimit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Enables you to limit the count of entries fetched. Setting this to 0 means no limit. </p> <blockquote><p><b class='note'>Nota</b>: This parameter can NOT override server-side preset sizelimit. You can set it lower though. <br /> Some directory server hosts will be configured to return no more than a preset number of entries. If this occurs, the server will indicate that it has only returned a partial results set. This also occurs if you use this parameter to limit the count of fetched entries. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>timelimit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Sets the number of seconds how long is spend on the search. Setting this to 0 means no limit. </p> <blockquote><p><b class='note'>Nota</b>: This parameter can NOT override server-side preset timelimit. You can set it lower though. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>deref</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies how aliases should be handled during the search. It can be one of the following: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_NEVER</tt></b> - (default) aliases are never dereferenced. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_SEARCHING</tt></b> - aliases should be dereferenced during the search but not when locating the base object of the search. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_FINDING</tt></b> - aliases should be dereferenced when locating the base object but not during the search. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>LDAP_DEREF_ALWAYS</tt></b> - aliases should be dereferenced always. </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-list.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a search result identifier or <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-list.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>4.0.5</td> <td align='left'> Parallel searches support was added. See <a href='http://www.php.net/manual/pt_BR/function.ldap-search.php' class='function'>ldap_search()</a> for details. </td> </tr> <tr valign='middle'> <td align='left'>4.0.2</td> <td align='left'> The <i><tt class='parameter'>attrsonly</tt></i> , <i><tt class='parameter'>sizelimit</tt></i> , <i><tt class='parameter'>timelimit</tt></i> and <i><tt class='parameter'>deref</tt></i> were added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ldap-list.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Produce a list of all organizational units of an organization</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> //&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;server<br /><br />$basedn&amp;nbsp;=&amp;nbsp;'o=My&amp;nbsp;Company,&amp;nbsp;c=US';<br />$justthese&amp;nbsp;=&amp;nbsp;array('ou');<br /><br />$sr=ldap_list($ds,&amp;nbsp;$basedn,&amp;nbsp;'ou=*',&amp;nbsp;$justthese);<br /><br />$info&amp;nbsp;=&amp;nbsp;ldap_get_entries($ds,&amp;nbsp;$sr);<br /><br />for&amp;nbsp;($i=0;&amp;nbsp;$i&amp;lt;$info['count'];&amp;nbsp;$i++)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;$info[$i]['ou'][0]&amp;nbsp;;<br />}</span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-list.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-search.php' class='function' rel='rdfs-seeAlso'>ldap_search()</a> - Search LDAP tree</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_get_values_len" value="<div id='function.ldap-get-values-len' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-get-values-len.php'>ldap_get_values_len</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_get_values_len</span> &amp;mdash; <span class='dc-title'>Get all binary values from a result entry</span></p> </div> <a name='function.ldap-get-values-len.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>ldap_get_values_len</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$attribute</tt></span> )</div> <p class='para rdfs-comment'> Reads all the values of the attribute in the entry in the result. </p> <p class='para'> This function is used exactly like <a href='http://www.php.net/manual/pt_BR/function.ldap-get-values.php' class='function'>ldap_get_values()</a> except that it handles binary data and not string data. </p> </div> <a name='function.ldap-get-values-len.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attribute</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-get-values-len.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an array of values for the attribute on success and <b><tt class='constant'>FALSE</tt></b> on error. Individual values are accessed by integer index in the array. The first index is 0. The number of values can be found by indexing &amp;quot;count&amp;quot; in the resultant array. </p> </div> <a name='function.ldap-get-values-len.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-values.php' class='function' rel='rdfs-seeAlso'>ldap_get_values()</a> - Get all values from a result entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_get_values" value="<div id='function.ldap-get-values' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-get-values.php'>ldap_get_values</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_get_values</span> &amp;mdash; <span class='dc-title'>Get all values from a result entry</span></p> </div> <a name='function.ldap-get-values.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>ldap_get_values</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$attribute</tt></span> )</div> <p class='para rdfs-comment'> Reads all the values of the attribute in the entry in the result. </p> <p class='para'> This call needs a <i><tt class='parameter'>result_entry_identifier</tt></i> , so needs to be preceded by one of the ldap search calls and one of the calls to get an individual entry. </p> <p class='para'> You application will either be hard coded to look for certain attributes (such as &amp;quot;surname&amp;quot; or &amp;quot;mail&amp;quot;) or you will have to use the <a href='http://www.php.net/manual/pt_BR/function.ldap-get-attributes.php' class='function'>ldap_get_attributes()</a> call to work out what attributes exist for a given entry. </p> </div> <a name='function.ldap-get-values.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attribute</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-get-values.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an array of values for the attribute on success and <b><tt class='constant'>FALSE</tt></b> on error. The number of values can be found by indexing &amp;quot;count&amp;quot; in the resultant array. Individual values are accessed by integer index in the array. The first index is 0. </p> <p class='para'> LDAP allows more than one entry for an attribute, so it can, for example, store a number of email addresses for one person&amp;#039;s directory entry all labeled with the attribute &amp;quot;mail&amp;quot; </p><div class='informalexample'> <pre class='literallayout'> return_value[&amp;quot;count&amp;quot;] = number of values for attribute return_value[0] = first value of attribute return_value[i] = ith value of attribute </pre> </div><p> </p> </div> <a name='function.ldap-get-values.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 List all values of the &amp;quot;mail&amp;quot; attribute for a directory entry </b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;server<br /><br />//&amp;nbsp;$sr&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;search&amp;nbsp;result&amp;nbsp;from&amp;nbsp;a&amp;nbsp;prior&amp;nbsp;call&amp;nbsp;to<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;one&amp;nbsp;of&amp;nbsp;the&amp;nbsp;ldap&amp;nbsp;directory&amp;nbsp;search&amp;nbsp;calls<br /><br />//&amp;nbsp;$entry&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;entry&amp;nbsp;identifier&amp;nbsp;from&amp;nbsp;a&amp;nbsp;prior&amp;nbsp;call&amp;nbsp;to<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;one&amp;nbsp;of&amp;nbsp;the&amp;nbsp;calls&amp;nbsp;that&amp;nbsp;returns&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;entry<br /><br /></span><span style='color: #0000BB'>$values&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_get_values</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$entry</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mail'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$values</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'count'</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;email&amp;nbsp;addresses&amp;nbsp;for&amp;nbsp;this&amp;nbsp;entry.&amp;lt;br&amp;nbsp;/&amp;gt;'</span><span style='color: #007700'>;<br /><br />for&amp;nbsp;(</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>=</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>$values</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'count'</span><span style='color: #007700'>];&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>++)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$values</span><span style='color: #007700'>[</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-get-values.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-values-len.php' class='function' rel='rdfs-seeAlso'>ldap_get_values_len()</a> - Get all binary values from a result entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_get_option" value="<div id='function.ldap-get-option' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-get-option.php'>ldap_get_option</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_get_option</span> &amp;mdash; <span class='dc-title'>Get the current value for given option</span></p> </div> <a name='function.ldap-get-option.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_get_option</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$option</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter reference'>&amp;amp;$retval</tt></span> )</div> <p class='para rdfs-comment'> Sets <i><tt class='parameter'>retval</tt></i> to the value of the specified option. </p> </div> <a name='function.ldap-get-option.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The parameter <i><tt class='parameter'>option</tt></i> can be one of: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Option</th> <th>Type</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_DEREF</tt></b></td> <td align='left'>integer</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_SIZELIMIT</tt></b></td> <td align='left'>integer</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_TIMELIMIT</tt></b></td> <td align='left'>integer</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_NETWORK_TIMEOUT</tt></b></td> <td align='left'>integer</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_PROTOCOL_VERSION</tt></b></td> <td align='left'>integer</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_ERROR_NUMBER</tt></b></td> <td align='left'>integer</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_REFERRALS</tt></b></td> <td align='left'>bool</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_RESTART</tt></b></td> <td align='left'>bool</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_HOST_NAME</tt></b></td> <td align='left'>string</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_ERROR_STRING</tt></b></td> <td align='left'>string</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_MATCHED_DN</tt></b></td> <td align='left'>string</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_SERVER_CONTROLS</tt></b></td> <td align='left'>array</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>LDAP_OPT_CLIENT_CONTROLS</tt></b></td> <td align='left'>array</td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>retval</tt></i> </span> </dt><dd class='listitem'> <p class='para'> This will be set to the option value. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-get-option.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-get-option.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Check protocol version</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;a&amp;nbsp;directory&amp;nbsp;server<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>ldap_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>LDAP_OPT_PROTOCOL_VERSION</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$version</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Using&amp;nbsp;protocol&amp;nbsp;version&amp;nbsp;</span><span style='color: #0000BB'>$version</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Unable&amp;nbsp;to&amp;nbsp;determine&amp;nbsp;protocol&amp;nbsp;version\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-get-option.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function is only available when using OpenLDAP 2.x.x OR Netscape Directory SDK x.x. <br /> </p></blockquote> </div> <a name='function.ldap-get-option.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-set-option.php' class='function' rel='rdfs-seeAlso'>ldap_set_option()</a> - Set the value of the given option</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_get_entries" value="<div id='function.ldap-get-entries' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-get-entries.php'>ldap_get_entries</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_get_entries</span> &amp;mdash; <span class='dc-title'>Get all result entries</span></p> </div> <a name='function.ldap-get-entries.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>ldap_get_entries</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_identifier</tt></span> )</div> <p class='para rdfs-comment'> Reads multiple entries from the given result, and then reading the attributes and multiple values. </p> </div> <a name='function.ldap-get-entries.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-get-entries.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a complete result information in a multi-dimensional array on success and <b><tt class='constant'>FALSE</tt></b> on error. </p> <p class='para'> The structure of the array is as follows. The attribute index is converted to lowercase. (Attributes are case-insensitive for directory servers, but not when used as array indices.) </p><div class='informalexample'> <div class='example-contents programlisting'> <div class='cdata'><pre> return_value[&amp;quot;count&amp;quot;] = number of entries in the result return_value[0] : refers to the details of first entry return_value[i][&amp;quot;dn&amp;quot;] = DN of the ith entry in the result return_value[i][&amp;quot;count&amp;quot;] = number of attributes in ith entry return_value[i][j] = jth attribute in the ith entry in the result return_value[i][&amp;quot;attribute&amp;quot;][&amp;quot;count&amp;quot;] = number of values for attribute in ith entry return_value[i][&amp;quot;attribute&amp;quot;][j] = jth value of attribute in ith entry </pre></div> </div> </div><p> </p> </div> <a name='function.ldap-get-entries.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-first-entry.php' class='function' rel='rdfs-seeAlso'>ldap_first_entry()</a> - Return first result id</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-next-entry.php' class='function' rel='rdfs-seeAlso'>ldap_next_entry()</a> - Get next result entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_get_dn" value="<div id='function.ldap-get-dn' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-get-dn.php'>ldap_get_dn</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_get_dn</span> &amp;mdash; <span class='dc-title'>Get the DN of a result entry</span></p> </div> <a name='function.ldap-get-dn.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>ldap_get_dn</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> )</div> <p class='para rdfs-comment'> Finds out the DN of an entry in the result. </p> </div> <a name='function.ldap-get-dn.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-get-dn.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the DN of the result entry and <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_get_attributes" value="<div id='function.ldap-get-attributes' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-get-attributes.php'>ldap_get_attributes</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_get_attributes</span> &amp;mdash; <span class='dc-title'>Get attributes from a search result entry</span></p> </div> <a name='function.ldap-get-attributes.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>ldap_get_attributes</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> )</div> <p class='para rdfs-comment'> Reads attributes and values from an entry in the search result. </p> <p class='para'> Having located a specific entry in the directory, you can find out what information is held for that entry by using this call. You would use this call for an application which &amp;quot;browses&amp;quot; directory entries and/or where you do not know the structure of the directory entries. In many applications you will be searching for a specific attribute such as an email address or a surname, and won&amp;#039;t care what other data is held. </p><div class='informalexample'> <div class='example-contents programlisting'> <div class='cdata'><pre> return_value[&amp;quot;count&amp;quot;] = number of attributes in the entry return_value[0] = first attribute return_value[n] = nth attribute return_value[&amp;quot;attribute&amp;quot;][&amp;quot;count&amp;quot;] = number of values for attribute return_value[&amp;quot;attribute&amp;quot;][0] = first value of the attribute return_value[&amp;quot;attribute&amp;quot;][i] = (i+1)th value of the attribute </pre></div> </div> </div><p> </p> </div> <a name='function.ldap-get-attributes.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-get-attributes.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a complete entry information in a multi-dimensional array on success and <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-get-attributes.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Show the list of attributes held for a particular directory entry </b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;$ds&amp;nbsp;is&amp;nbsp;the&amp;nbsp;link&amp;nbsp;identifier&amp;nbsp;for&amp;nbsp;the&amp;nbsp;directory<br /><br />//&amp;nbsp;$sr&amp;nbsp;is&amp;nbsp;a&amp;nbsp;valid&amp;nbsp;search&amp;nbsp;result&amp;nbsp;from&amp;nbsp;a&amp;nbsp;prior&amp;nbsp;call&amp;nbsp;to<br />//&amp;nbsp;one&amp;nbsp;of&amp;nbsp;the&amp;nbsp;ldap&amp;nbsp;directory&amp;nbsp;search&amp;nbsp;calls<br /><br /></span><span style='color: #0000BB'>$entry&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_first_entry</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sr</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$attrs&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_get_attributes</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$entry</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$attrs</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'count'</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;attributes&amp;nbsp;held&amp;nbsp;for&amp;nbsp;this&amp;nbsp;entry:&amp;lt;p&amp;gt;'</span><span style='color: #007700'>;<br /><br />for&amp;nbsp;(</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>=</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>$attrs</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'count'</span><span style='color: #007700'>];&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>++)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$attrs</span><span style='color: #007700'>[</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-get-attributes.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-first-attribute.php' class='function' rel='rdfs-seeAlso'>ldap_first_attribute()</a> - Return first attribute</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-next-attribute.php' class='function' rel='rdfs-seeAlso'>ldap_next_attribute()</a> - Get the next attribute in result</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_free_result" value="<div id='function.ldap-free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-free-result.php'>ldap_free_result</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_free_result</span> &amp;mdash; <span class='dc-title'>Free result memory</span></p> </div> <a name='function.ldap-free-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_free_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_identifier</tt></span> )</div> <p class='para rdfs-comment'> Frees up the memory allocated internally to store the result. All result memory will be automatically freed when the script terminates. </p> <p class='para'> Typically all the memory allocated for the LDAP result gets freed at the end of the script. In case the script is making successive searches which return large result sets, <b>ldap_free_result()</b> could be called to keep the runtime memory usage by the script low. </p> </div> <a name='function.ldap-free-result.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-free-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_first_reference" value="<div id='function.ldap-first-reference' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-first-reference.php'>ldap_first_reference</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_first_reference</span> &amp;mdash; <span class='dc-title'>Return first reference</span></p> </div> <a name='function.ldap-first-reference.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_first_reference</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <div class='warning'><b class='warning'>Aviso</b><p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; documentada; somente a lista de argumentos est&amp;aacute; dispon&amp;iacute;vel.</p></div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_first_entry" value="<div id='function.ldap-first-entry' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-first-entry.php'>ldap_first_entry</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_first_entry</span> &amp;mdash; <span class='dc-title'>Return first result id</span></p> </div> <a name='function.ldap-first-entry.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_first_entry</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_identifier</tt></span> )</div> <p class='para rdfs-comment'> Returns the entry identifier for first entry in the result. This entry identifier is then supplied to <a href='http://www.php.net/manual/pt_BR/function.ldap-next-entry.php' class='function'>ldap_next_entry()</a> routine to get successive entries from the result. </p> <p class='para'> Entries in the LDAP result are read sequentially using the <b>ldap_first_entry()</b> and <a href='http://www.php.net/manual/pt_BR/function.ldap-next-entry.php' class='function'>ldap_next_entry()</a> functions. </p> </div> <a name='function.ldap-first-entry.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-first-entry.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the result entry identifier for the first entry on success and <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-first-entry.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-entries.php' class='function' rel='rdfs-seeAlso'>ldap_get_entries()</a> - Get all result entries</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_first_attribute" value="<div id='function.ldap-first-attribute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-first-attribute.php'>ldap_first_attribute</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_first_attribute</span> &amp;mdash; <span class='dc-title'>Return first attribute</span></p> </div> <a name='function.ldap-first-attribute.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>ldap_first_attribute</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_entry_identifier</tt></span> )</div> <p class='para rdfs-comment'> Gets the first attribute in the given entry. Remaining attributes are retrieved by calling <a href='http://www.php.net/manual/pt_BR/function.ldap-next-attribute.php' class='function'>ldap_next_attribute()</a> successively. </p> <p class='para'> Similar to reading entries, attributes are also read one by one from a particular entry. </p> </div> <a name='function.ldap-first-attribute.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_entry_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>ber_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>ber_identifier</tt></i> is the identifier to internal memory location pointer. It is passed by reference. The same <i><tt class='parameter'>ber_identifier</tt></i> is passed to <a href='http://www.php.net/manual/pt_BR/function.ldap-next-attribute.php' class='function'>ldap_next_attribute()</a> , which modifies that pointer. </p> <blockquote><p><b class='note'>Nota</b>: This parameter is no longer used as this is now handled automatically by PHP. For backwards compatibility PHP will not throw an error if this parameter is passed. <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='function.ldap-first-attribute.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the first attribute in the entry on success and <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.ldap-first-attribute.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>5.2.4</td> <td align='left'> The <i><tt class='parameter'>ber_identifier</tt></i> was removed. This is now handled automatically by PHP. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ldap-first-attribute.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-next-attribute.php' class='function' rel='rdfs-seeAlso'>ldap_next_attribute()</a> - Get the next attribute in result</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-get-attributes.php' class='function' rel='rdfs-seeAlso'>ldap_get_attributes()</a> - Get attributes from a search result entry</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_explode_dn" value="<div id='function.ldap-explode-dn' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-explode-dn.php'>ldap_explode_dn</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_explode_dn</span> &amp;mdash; <span class='dc-title'>Splits DN into its component parts</span></p> </div> <a name='function.ldap-explode-dn.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>ldap_explode_dn</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$with_attrib</tt></span> )</div> <p class='para rdfs-comment'> Splits the DN returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-get-dn.php' class='function'>ldap_get_dn()</a> and breaks it up into its component parts. Each part is known as Relative Distinguished Name, or RDN. </p> </div> <a name='function.ldap-explode-dn.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>with_attrib</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Used to request if the RDNs are returned with only values or their attributes as well. To get RDNs with the attributes (i.e. in attribute=value format) set <i><tt class='parameter'>with_attrib</tt></i> to 0 and to get only values set it to 1. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-explode-dn.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an array of all DN components. The first element in this array has <i>count</i> key and represents the number of returned values, next elements are numerically indexed DN components. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_error" value="<div id='function.ldap-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-error.php'>ldap_error</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_error</span> &amp;mdash; <span class='dc-title'>Return the LDAP error message of the last LDAP command</span></p> </div> <a name='function.ldap-error.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>ldap_error</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> )</div> <p class='para rdfs-comment'> Returns the string error message explaining the error generated by the last LDAP command for the given <i><tt class='parameter'>link_identifier</tt></i> . While LDAP errno numbers are standardized, different libraries return different or even localized textual error messages. Never check for a specific error message text, but always use an error number to check. </p> <p class='para'> Unless you lower your warning level in your <var class='filename'>php.ini</var> sufficiently or prefix your LDAP commands with <i>@</i> (at) characters to suppress warning output, the errors generated will also show up in your HTML output. </p> </div> <a name='function.ldap-error.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns string error message. </p> </div> <a name='function.ldap-error.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-err2str.php' class='function' rel='rdfs-seeAlso'>ldap_err2str()</a> - Convert LDAP error number into string error message</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-errno.php' class='function' rel='rdfs-seeAlso'>ldap_errno()</a> - Return the LDAP error number of the last LDAP command</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_errno" value="<div id='function.ldap-errno' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-errno.php'>ldap_errno</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_errno</span> &amp;mdash; <span class='dc-title'>Return the LDAP error number of the last LDAP command</span></p> </div> <a name='function.ldap-errno.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>ldap_errno</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> )</div> <p class='para rdfs-comment'> Returns the standardized error number returned by the last LDAP command. This number can be converted into a textual error message using <a href='http://www.php.net/manual/pt_BR/function.ldap-err2str.php' class='function'>ldap_err2str()</a>. </p> </div> <a name='function.ldap-errno.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-errno.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Return the LDAP error number of the last LDAP command for this link. </p> </div> <a name='function.ldap-errno.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> Unless you lower your warning level in your <var class='filename'>php.ini</var> sufficiently or prefix your LDAP commands with @ (at) characters to suppress warning output, the errors generated will also show up in your HTML output. </p><div class='example'> <p><b>Exemplo #1 Generating and catching an error</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>//&amp;nbsp;This&amp;nbsp;example&amp;nbsp;contains&amp;nbsp;an&amp;nbsp;error,&amp;nbsp;which&amp;nbsp;we&amp;nbsp;will&amp;nbsp;catch.<br /></span><span style='color: #0000BB'>$ld&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$bind&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_bind</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ld</span><span style='color: #007700'>);<br /></span><span style='color: #FF8000'>//&amp;nbsp;syntax&amp;nbsp;error&amp;nbsp;in&amp;nbsp;filter&amp;nbsp;expression&amp;nbsp;(errno&amp;nbsp;87),<br />//&amp;nbsp;must&amp;nbsp;be&amp;nbsp;'objectclass=*'&amp;nbsp;to&amp;nbsp;work.<br /></span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;&amp;nbsp;@</span><span style='color: #0000BB'>ldap_search</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ld</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'o=Myorg,&amp;nbsp;c=DE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'objectclass'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LDAP-Errno:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>ldap_errno</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ld</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LDAP-Error:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>ldap_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ld</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Argh!&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>$info&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_get_entries</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ld</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'count'</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;matching&amp;nbsp;entries.&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-errno.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-err2str.php' class='function' rel='rdfs-seeAlso'>ldap_err2str()</a> - Convert LDAP error number into string error message</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-error.php' class='function' rel='rdfs-seeAlso'>ldap_error()</a> - Return the LDAP error message of the last LDAP command</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_err2str" value="<div id='function.ldap-err2str' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-err2str.php'>ldap_err2str</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_err2str</span> &amp;mdash; <span class='dc-title'>Convert LDAP error number into string error message</span></p> </div> <a name='function.ldap-err2str.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>ldap_err2str</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$errno</tt></span> )</div> <p class='para rdfs-comment'> Returns the string error message explaining the error number <i><tt class='parameter'>errno</tt></i> . While LDAP errno numbers are standardized, different libraries return different or even localized textual error messages. Never check for a specific error message text, but always use an error number to check. </p> </div> <a name='function.ldap-err2str.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>errno</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The error number. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-err2str.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the error message, as a string. </p> </div> <a name='function.ldap-err2str.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Enumerating all LDAP error messages</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>for&amp;nbsp;(</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>=</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>&amp;lt;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>++)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Error&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #DD0000'>:&amp;nbsp;%s&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>ldap_err2str</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-err2str.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-errno.php' class='function' rel='rdfs-seeAlso'>ldap_errno()</a> - Return the LDAP error number of the last LDAP command</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-error.php' class='function' rel='rdfs-seeAlso'>ldap_error()</a> - Return the LDAP error message of the last LDAP command</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_dn2ufn" value="<div id='function.ldap-dn2ufn' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-dn2ufn.php'>ldap_dn2ufn</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_dn2ufn</span> &amp;mdash; <span class='dc-title'>Convert DN to User Friendly Naming format</span></p> </div> <a name='function.ldap-dn2ufn.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>ldap_dn2ufn</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> )</div> <p class='para rdfs-comment'> Turns the specified <i><tt class='parameter'>dn</tt></i> , into a more user-friendly form, stripping off type names. </p> </div> <a name='function.ldap-dn2ufn.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-dn2ufn.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the user friendly name. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_delete" value="<div id='function.ldap-delete' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-delete.php'>ldap_delete</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_delete</span> &amp;mdash; <span class='dc-title'>Delete an entry from a directory</span></p> </div> <a name='function.ldap-delete.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_delete</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> )</div> <p class='para rdfs-comment'> Deletes a particular entry in LDAP directory. </p> </div> <a name='function.ldap-delete.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-delete.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-delete.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-add.php' class='function' rel='rdfs-seeAlso'>ldap_add()</a> - Add entries to LDAP directory</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_count_entries" value="<div id='function.ldap-count-entries' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-count-entries.php'>ldap_count_entries</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_count_entries</span> &amp;mdash; <span class='dc-title'>Count the number of entries in a search</span></p> </div> <a name='function.ldap-count-entries.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>ldap_count_entries</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result_identifier</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of entries stored in the result of previous search operations. </p> </div> <a name='function.ldap-count-entries.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The internal LDAP result. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-count-entries.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns number of entries in the result or <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_connect" value="<div id='function.ldap-connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-connect.php'>ldap_connect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_connect</span> &amp;mdash; <span class='dc-title'>Connect to an LDAP server</span></p> </div> <a name='function.ldap-connect.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>ldap_connect</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$hostname</tt><span class='initializer'> = NULL</span></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$port</tt><span class='initializer'> = 389</span></span> ]] )</div> <p class='para rdfs-comment'> Establishes a connection to a LDAP server on a specified <i><tt class='parameter'>hostname</tt></i> and <i><tt class='parameter'>port</tt></i> . </p> </div> <a name='function.ldap-connect.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>hostname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If you are using OpenLDAP 2.x.x you can specify a URL instead of the hostname. To use LDAP with SSL, compile OpenLDAP 2.x.x with SSL support, configure PHP with SSL, and set this parameter as <i>ldaps://hostname/</i>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>port</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The port to connect to. Not used when using URLs. Defaults to 389. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-connect.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a positive LDAP link identifier on success, or <b><tt class='constant'>FALSE</tt></b> on error. When OpenLDAP 2.x.x is used, <b>ldap_connect()</b> will always return a <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> as it does not actually connect but just initializes the connecting parameters. The actual connect happens with the next calls to ldap_* funcs, usually with <a href='http://www.php.net/manual/pt_BR/function.ldap-bind.php' class='function'>ldap_bind()</a>. </p> <p class='para'> If no arguments are specified then the link identifier of the already opened link will be returned. </p> </div> <a name='function.ldap-connect.changelog'></a><div class='refsect1 changelog'> <h3 class='title'>Hist&amp;oacute;rico</h3> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Vers&amp;atilde;o</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>4.0.4</td> <td align='left'> URL and SSL support was added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ldap-connect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Example of connecting to LDAP server.</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;LDAP&amp;nbsp;variables<br /></span><span style='color: #0000BB'>$ldaphost&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ldap.example.com'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;your&amp;nbsp;ldap&amp;nbsp;servers<br /></span><span style='color: #0000BB'>$ldapport&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>389</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;your&amp;nbsp;ldap&amp;nbsp;server's&amp;nbsp;port&amp;nbsp;number<br /><br />//&amp;nbsp;Connecting&amp;nbsp;to&amp;nbsp;LDAP<br /></span><span style='color: #0000BB'>$ldapconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ldaphost</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$ldapport</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;</span><span style='color: #0000BB'>$ldaphost</span><span style='color: #DD0000'>'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Example of connecting securely to LDAP server.</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;make&amp;nbsp;sure&amp;nbsp;your&amp;nbsp;host&amp;nbsp;is&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;one<br />//&amp;nbsp;that&amp;nbsp;you&amp;nbsp;issued&amp;nbsp;your&amp;nbsp;secure&amp;nbsp;certificate&amp;nbsp;to<br /></span><span style='color: #0000BB'>$ldaphost&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ldaps://ldap.example.com/'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Connecting&amp;nbsp;to&amp;nbsp;LDAP<br /></span><span style='color: #0000BB'>$ldapconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ldaphost</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$ldaphost</span><span style='color: #007700'>}</span><span style='color: #DD0000'>'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-connect.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-bind.php' class='function' rel='rdfs-seeAlso'>ldap_bind()</a> - Bind to LDAP directory</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_compare" value="<div id='function.ldap-compare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-compare.php'>ldap_compare</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.2, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_compare</span> &amp;mdash; <span class='dc-title'>Compare value of attribute found in entry specified with DN</span></p> </div> <a name='function.ldap-compare.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>ldap_compare</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$attribute</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$value</tt></span> )</div> <p class='para rdfs-comment'> Compare <i><tt class='parameter'>value</tt></i> of <i><tt class='parameter'>attribute</tt></i> with value of same attribute in an LDAP directory entry. </p> </div> <a name='function.ldap-compare.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attribute</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The attribute name. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>value</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The compared value. </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-compare.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns <b><tt class='constant'>TRUE</tt></b> if <i><tt class='parameter'>value</tt></i> matches otherwise returns <b><tt class='constant'>FALSE</tt></b>. Returns -1 on error. </p> </div> <a name='function.ldap-compare.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> The following example demonstrates how to check whether or not given password matches the one defined in DN specified entry. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Complete example of password check</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$ds</span><span style='color: #007700'>=</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;assuming&amp;nbsp;the&amp;nbsp;LDAP&amp;nbsp;server&amp;nbsp;is&amp;nbsp;on&amp;nbsp;this&amp;nbsp;host<br /><br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>)&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;bind<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>ldap_bind</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;prepare&amp;nbsp;data<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$dn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'cn=Matti&amp;nbsp;Meikku,&amp;nbsp;ou=My&amp;nbsp;Unit,&amp;nbsp;o=My&amp;nbsp;Company,&amp;nbsp;c=FI'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$value&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'secretpassword'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$attr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'password'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;compare&amp;nbsp;value<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$r</span><span style='color: #007700'>=</span><span style='color: #0000BB'>ldap_compare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$dn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$attr</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$value</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$r&amp;nbsp;</span><span style='color: #007700'>===&amp;nbsp;-</span><span style='color: #0000BB'>1</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Error:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>ldap_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;elseif&amp;nbsp;(</span><span style='color: #0000BB'>$r&amp;nbsp;</span><span style='color: #007700'>===&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Password&amp;nbsp;correct.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;elseif&amp;nbsp;(</span><span style='color: #0000BB'>$r&amp;nbsp;</span><span style='color: #007700'>===&amp;nbsp;</span><span style='color: #0000BB'>false</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Wrong&amp;nbsp;guess!&amp;nbsp;Password&amp;nbsp;incorrect.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Unable&amp;nbsp;to&amp;nbsp;bind&amp;nbsp;to&amp;nbsp;LDAP&amp;nbsp;server.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>ldap_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>);<br /><br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Unable&amp;nbsp;to&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;LDAP&amp;nbsp;server.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-compare.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <div class='warning'><b class='warning'>Aviso</b> <p class='para'> <b>ldap_compare()</b> can NOT be used to compare BINARY values! </p> </div> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_bind" value="<div id='function.ldap-bind' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-bind.php'>ldap_bind</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_bind</span> &amp;mdash; <span class='dc-title'>Bind to LDAP directory</span></p> </div> <a name='function.ldap-bind.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_bind</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$bind_rdn</tt><span class='initializer'> = NULL</span></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$bind_password</tt><span class='initializer'> = NULL</span></span> ]] )</div> <p class='para rdfs-comment'> Binds to the LDAP directory with specified RDN and password. </p> </div> <a name='function.ldap-bind.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>bind_rdn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>bind_password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> <p class='para'> If <i><tt class='parameter'>bind_rdn</tt></i> and <i><tt class='parameter'>bind_password</tt></i> are not specified, an anonymous bind is attempted. </p> </div> <a name='function.ldap-bind.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-bind.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Using LDAP Bind</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;using&amp;nbsp;ldap&amp;nbsp;bind<br /></span><span style='color: #0000BB'>$ldaprdn&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'uname'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;ldap&amp;nbsp;rdn&amp;nbsp;or&amp;nbsp;dn<br /></span><span style='color: #0000BB'>$ldappass&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'password'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;associated&amp;nbsp;password<br /><br />//&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;ldap&amp;nbsp;server<br /></span><span style='color: #0000BB'>$ldapconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'ldap.example.com'</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;LDAP&amp;nbsp;server.'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$ldapconn</span><span style='color: #007700'>)&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;binding&amp;nbsp;to&amp;nbsp;ldap&amp;nbsp;server<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$ldapbind&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_bind</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ldapconn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$ldaprdn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$ldappass</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;verify&amp;nbsp;binding<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$ldapbind</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LDAP&amp;nbsp;bind&amp;nbsp;successful...'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LDAP&amp;nbsp;bind&amp;nbsp;failed...'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Using LDAP Bind Anonymously</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br /></span><span style='color: #FF8000'>//using&amp;nbsp;ldap&amp;nbsp;bind&amp;nbsp;anonymously<br /><br />//&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;ldap&amp;nbsp;server<br /></span><span style='color: #0000BB'>$ldapconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'ldap.example.com'</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;LDAP&amp;nbsp;server.'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$ldapconn</span><span style='color: #007700'>)&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;binding&amp;nbsp;anonymously<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$ldapbind&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_bind</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ldapconn</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$ldapbind</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LDAP&amp;nbsp;bind&amp;nbsp;anonymous&amp;nbsp;successful...'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LDAP&amp;nbsp;bind&amp;nbsp;anonymous&amp;nbsp;failed...'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-bind.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-unbind.php' class='function' rel='rdfs-seeAlso'>ldap_unbind()</a> - Unbind from LDAP directory</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="ldap_add" value="<div id='function.ldap-add' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ldap-add.php'>ldap_add</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ldap_add</span> &amp;mdash; <span class='dc-title'>Add entries to LDAP directory</span></p> </div> <a name='function.ldap-add.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>ldap_add</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dn</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$entry</tt></span> )</div> <p class='para rdfs-comment'> Add entries in the LDAP directory. </p> </div> <a name='function.ldap-add.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An LDAP link identifier, returned by <a href='http://www.php.net/manual/pt_BR/function.ldap-connect.php' class='function'>ldap_connect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dn</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The distinguished name of an LDAP entity. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>entry</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array that specifies the information about the entry. The values in the entries are indexed by individual attributes. In case of multiple values for an attribute, they are indexed using integers starting with 0. </p><div class='informalexample'> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$entree</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'attribut1'</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'value'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$entree</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'attribut2'</span><span style='color: #007700'>][</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'value1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$entree</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'attribut2'</span><span style='color: #007700'>][</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'value2'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </dd> </dl> <p> </p> </div> <a name='function.ldap-add.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.ldap-add.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Complete example with authenticated bind</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$ds&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;assuming&amp;nbsp;the&amp;nbsp;LDAP&amp;nbsp;server&amp;nbsp;is&amp;nbsp;on&amp;nbsp;this&amp;nbsp;host<br /><br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;bind&amp;nbsp;with&amp;nbsp;appropriate&amp;nbsp;dn&amp;nbsp;to&amp;nbsp;give&amp;nbsp;update&amp;nbsp;access<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$r&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_bind</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cn=root,&amp;nbsp;o=My&amp;nbsp;Company,&amp;nbsp;c=US'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'secret'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;prepare&amp;nbsp;data<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'cn'</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'John&amp;nbsp;Jones'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'sn'</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'Jones'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'mail'</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'jonj@example.com'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'objectclass'</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'person'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;add&amp;nbsp;data&amp;nbsp;to&amp;nbsp;directory<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$r&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ldap_add</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cn=John&amp;nbsp;Jones,&amp;nbsp;o=My&amp;nbsp;Company,&amp;nbsp;c=US'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$info</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>ldap_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ds</span><span style='color: #007700'>);<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Unable&amp;nbsp;to&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;LDAP&amp;nbsp;server'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ldap-add.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; compat&amp;iacute;vel com dados bin&amp;aacute;rios</span></p></blockquote> </div> <a name='function.ldap-add.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ldap-delete.php' class='function' rel='rdfs-seeAlso'>ldap_delete()</a> - Delete an entry from a directory</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_table_privileges" value="<div id='function.db2-table-privileges' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-table-privileges.php'>db2_table_privileges</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_table_privileges</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the tables and associated privileges in a database </span></p> </div> <a name='function.db2-table-privileges.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_table_privileges</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> ]]] )</div> <p class='para rdfs-comment'> Returns a result set listing the tables and associated privileges in a database. </p> </div> <a name='function.db2-table-privileges.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-table-privileges.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the privileges for the tables that match the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>TABLE_CAT</td> <td align='left'>The catalog that contains the table. The value is <b><tt class='constant'>NULL</tt></b> if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_SCHEM</td> <td align='left'>Name of the schema that contains the table.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_NAME</td> <td align='left'>Name of the table.</td> </tr> <tr valign='middle'> <td align='left'>GRANTOR</td> <td align='left'>Authorization ID of the user who granted the privilege.</td> </tr> <tr valign='middle'> <td align='left'>GRANTEE</td> <td align='left'>Authorization ID of the user to whom the privilege was granted.</td> </tr> <tr valign='middle'> <td align='left'>PRIVILEGE</td> <td align='left'> The privilege that has been granted. This can be one of ALTER, CONTROL, DELETE, INDEX, INSERT, REFERENCES, SELECT, or UPDATE. </td> </tr> <tr valign='middle'> <td align='left'>IS_GRANTABLE</td> <td align='left'> A string value of &amp;quot;YES&amp;quot; or &amp;quot;NO&amp;quot; indicating whether the grantee can grant the privilege to other users. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-table-privileges.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_tables" value="<div id='function.db2-tables' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-tables.php'>db2_tables</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_tables</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the tables and associated metadata in a database </span></p> </div> <a name='function.db2-tables.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_tables</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-name</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-type</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Returns a result set listing the tables and associated metadata in a database. </p> </div> <a name='function.db2-tables.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table-type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A list of comma-delimited table type identifiers. To match all table types, pass <b><tt class='constant'>NULL</tt></b> or an empty string. Valid table type identifiers include: ALIAS, HIERARCHY TABLE, INOPERATIVE VIEW, NICKNAME, MATERIALIZED QUERY TABLE, SYSTEM TABLE, TABLE, TYPED TABLE, TYPED VIEW, and VIEW. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-tables.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the tables that match the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>TABLE_CAT</td> <td align='left'>The catalog that contains the table. The value is <b><tt class='constant'>NULL</tt></b> if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_SCHEM</td> <td align='left'>Name of the schema that contains the table.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_NAME</td> <td align='left'>Name of the table.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_TYPE</td> <td align='left'>Table type identifier for the table.</td> </tr> <tr valign='middle'> <td align='left'>REMARKS</td> <td align='left'>Description of the table.</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-tables.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_stmt_errormsg" value="<div id='function.db2-stmt-errormsg' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-stmt-errormsg.php'>db2_stmt_errormsg</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_stmt_errormsg</span> &amp;mdash; <span class='dc-title'> Returns a string containing the last SQL statement error message </span></p> </div> <a name='function.db2-stmt-errormsg.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_stmt_errormsg</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> ] )</div> <p class='para rdfs-comment'> Returns a string containing the last SQL statement error message. </p> <p class='para'> If you do not pass a statement resource as an argument to <b>db2_stmt_errormsg()</b>, the driver returns the error message associated with the last attempt to return a statement resource, for example, from <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function'>db2_exec()</a>. </p> </div> <a name='function.db2-stmt-errormsg.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-stmt-errormsg.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing the error message and SQLCODE value for the last error that occurred issuing an SQL statement. </p> </div> <a name='function.db2-stmt-errormsg.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-conn-error.php' class='function' rel='rdfs-seeAlso'>db2_conn_error()</a> - Returns a string containing the SQLSTATE returned by the last connection attempt</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-conn-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_conn_errormsg()</a> - Returns the last connection error message and SQLCODE value</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-error.php' class='function' rel='rdfs-seeAlso'>db2_stmt_error()</a> - Returns a string containing the SQLSTATE returned by an SQL statement</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_stmt_error" value="<div id='function.db2-stmt-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-stmt-error.php'>db2_stmt_error</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_stmt_error</span> &amp;mdash; <span class='dc-title'> Returns a string containing the SQLSTATE returned by an SQL statement </span></p> </div> <a name='function.db2-stmt-error.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_stmt_error</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> ] )</div> <p class='para rdfs-comment'> Returns a string containing the SQLSTATE value returned by an SQL statement. </p> <p class='para'> If you do not pass a statement resource as an argument to <b>db2_stmt_error()</b>, the driver returns the SQLSTATE value associated with the last attempt to return a statement resource, for example, from <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function'>db2_exec()</a>. </p> <p class='para'> To learn what the SQLSTATE value means, you can issue the following command at a DB2 Command Line Processor prompt: <strong class='userinput'><code>db2 &amp;#039;? <i><tt class='parameter'>sqlstate-value</tt></i> &amp;#039;</code></strong> . You can also call <a href='http://www.php.net/manual/pt_BR/function.db2-stmt-errormsg.php' class='function'>db2_stmt_errormsg()</a> to retrieve an explicit error message and the associated SQLCODE value. </p> </div> <a name='function.db2-stmt-error.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-stmt-error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing an SQLSTATE value. </p> </div> <a name='function.db2-stmt-error.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-conn-error.php' class='function' rel='rdfs-seeAlso'>db2_conn_error()</a> - Returns a string containing the SQLSTATE returned by the last connection attempt</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-conn-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_conn_errormsg()</a> - Returns the last connection error message and SQLCODE value</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_stmt_errormsg()</a> - Returns a string containing the last SQL statement error message</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_statistics" value="<div id='function.db2-statistics' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-statistics.php'>db2_statistics</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_statistics</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the index and statistics for a table </span></p> </div> <a name='function.db2-statistics.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_statistics</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-name</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$unique</tt></span> )</div> <p class='para rdfs-comment'> Returns a result set listing the index and statistics for a table. </p> </div> <a name='function.db2-statistics.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema that contains the targeted table. If this parameter is <b><tt class='constant'>NULL</tt></b>, the statistics and indexes are returned for the schema of the current user. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>unique</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An integer value representing the type of index information to return. </p><dl> <dt class='varlistentry'> <br /><span class='term'><i><tt class='parameter'>0</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Return only the information for unique indexes on the table. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>1</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Return the information for all indexes on the table. </p> </dd> </dl> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.db2-statistics.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the statistics and indexes for the base tables matching the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>TABLE_CAT</td> <td align='left'>The catalog that contains the table. The value is <b><tt class='constant'>NULL</tt></b> if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_SCHEM</td> <td align='left'>Name of the schema that contains the table.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_NAME</td> <td align='left'>Name of the table.</td> </tr> <tr valign='middle'> <td align='left'>NON_UNIQUE</td> <td align='left'> <p class='para'> An integer value representing whether the index prohibits unique values, or whether the row represents statistics on the table itself: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Return value</th> <th>Parameter type</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0 (SQL_FALSE)</td> <td align='left'>The index allows duplicate values.</td> </tr> <tr valign='middle'> <td align='left'>1 (SQL_TRUE)</td> <td align='left'>The index values must be unique.</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>NULL</tt></b></td> <td align='left'>This row is statistics information for the table itself.</td> </tr> </tbody> </table> <p> </p> </td> </tr> <tr valign='middle'> <td align='left'>INDEX_QUALIFIER</td> <td align='left'>A string value representing the qualifier that would have to be prepended to INDEX_NAME to fully qualify the index.</td> </tr> <tr valign='middle'> <td align='left'>INDEX_NAME</td> <td align='left'>A string representing the name of the index.</td> </tr> <tr valign='middle'> <td align='left'>TYPE</td> <td align='left'> <p class='para'> An integer value representing the type of information contained in this row of the result set: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Return value</th> <th>Parameter type</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0 (SQL_TABLE_STAT)</td> <td align='left'>The row contains statistics about the table itself.</td> </tr> <tr valign='middle'> <td align='left'>1 (SQL_INDEX_CLUSTERED)</td> <td align='left'>The row contains information about a clustered index.</td> </tr> <tr valign='middle'> <td align='left'>2 (SQL_INDEX_HASH)</td> <td align='left'>The row contains information about a hashed index.</td> </tr> <tr valign='middle'> <td align='left'>3 (SQL_INDEX_OTHER)</td> <td align='left'>The row contains information about a type of index that is neither clustered nor hashed.</td> </tr> </tbody> </table> <p> </p> </td> </tr> <tr valign='middle'> <td align='left'>ORDINAL_POSITION</td> <td align='left'>The 1-indexed position of the column in the index. <b><tt class='constant'>NULL</tt></b> if the row contains statistics information about the table itself.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_NAME</td> <td align='left'>The name of the column in the index. <b><tt class='constant'>NULL</tt></b> if the row contains statistics information about the table itself.</td> </tr> <tr valign='middle'> <td align='left'>ASC_OR_DESC</td> <td align='left'> <i>A</i> if the column is sorted in ascending order, <i>D</i> if the column is sorted in descending order, <b><tt class='constant'>NULL</tt></b> if the row contains statistics information about the table itself. </td> </tr> <tr valign='middle'> <td align='left'>CARDINALITY</td> <td align='left'> <p class='para'> If the row contains information about an index, this column contains an integer value representing the number of unique values in the index. </p> <p class='para'> If the row contains information about the table itself, this column contains an integer value representing the number of rows in the table. </p> </td> </tr> <tr valign='middle'> <td align='left'>PAGES</td> <td align='left'> <p class='para'> If the row contains information about an index, this column contains an integer value representing the number of pages used to store the index. </p> <p class='para'> If the row contains information about the table itself, this column contains an integer value representing the number of pages used to store the table. </p> </td> </tr> <tr valign='middle'> <td align='left'>FILTER_CONDITION</td> <td align='left'>Always returns <b><tt class='constant'>NULL</tt></b>.</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-statistics.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_special_columns" value="<div id='function.db2-special-columns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-special-columns.php'>db2_special_columns</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_special_columns</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the unique row identifier columns for a table </span></p> </div> <a name='function.db2-special-columns.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_special_columns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$scope</tt></span> )</div> <p class='para rdfs-comment'> Returns a result set listing the unique row identifier columns for a table. </p> </div> <a name='function.db2-special-columns.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>scope</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Integer value representing the minimum duration for which the unique row identifier is valid. This can be one of the following values: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Integer value</th> <th>SQL constant</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>SQL_SCOPE_CURROW</td> <td align='left'>Row identifier is valid only while the cursor is positioned on the row.</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>SQL_SCOPE_TRANSACTION</td> <td align='left'>Row identifier is valid for the duration of the transaction.</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>SQL_SCOPE_SESSION</td> <td align='left'>Row identifier is valid for the duration of the connection.</td> </tr> </tbody> </table> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.db2-special-columns.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows with unique row identifier information for a table. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>SCOPE</td> <td align='left'> <p class='para'> </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Integer value</th> <th>SQL constant</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>SQL_SCOPE_CURROW</td> <td align='left'>Row identifier is valid only while the cursor is positioned on the row.</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>SQL_SCOPE_TRANSACTION</td> <td align='left'>Row identifier is valid for the duration of the transaction.</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>SQL_SCOPE_SESSION</td> <td align='left'>Row identifier is valid for the duration of the connection.</td> </tr> </tbody> </table> <p> </p> </td> </tr> <tr valign='middle'> <td align='left'>COLUMN_NAME</td> <td align='left'>Name of the unique column.</td> </tr> <tr valign='middle'> <td align='left'>DATA_TYPE</td> <td align='left'>SQL data type for the column.</td> </tr> <tr valign='middle'> <td align='left'>TYPE_NAME</td> <td align='left'>Character string representation of the SQL data type for the column.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_SIZE</td> <td align='left'>An integer value representing the size of the column.</td> </tr> <tr valign='middle'> <td align='left'>BUFFER_LENGTH</td> <td align='left'> Maximum number of bytes necessary to store data from this column. </td> </tr> <tr valign='middle'> <td align='left'>DECIMAL_DIGITS</td> <td align='left'> The scale of the column, or <b><tt class='constant'>NULL</tt></b> where scale is not applicable. </td> </tr> <tr valign='middle'> <td align='left'>NUM_PREC_RADIX</td> <td align='left'> An integer value of either <i>10</i> (representing an exact numeric data type), <i>2</i> (representing an approximate numeric data type), or <b><tt class='constant'>NULL</tt></b> (representing a data type for which radix is not applicable). </td> </tr> <tr valign='middle'> <td align='left'>PSEUDO_COLUMN</td> <td align='left'>Always returns 1.</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-special-columns.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_set_option" value="<div id='function.db2-set-option' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-set-option.php'>db2_set_option</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_set_option</span> &amp;mdash; <span class='dc-title'>Set options for connection or statement resources</span></p> </div> <a name='function.db2-set-option.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_set_option</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$resource</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$options</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$type</tt></span> )</div> <p class='para rdfs-comment'> Sets options for a statement resource or a connection resource. You cannot set options for result set resources. </p> </div> <a name='function.db2-set-option.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>resource</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> or a valid connection resource as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>options</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An associative array containing valid statement or connection options. This parameter can be used to change autocommit values, cursor types (scrollable or forward), and to specify the case of the column names (lower, upper, or natural) that will appear in a result set. </p><dl> <dt class='varlistentry'> <br /><span class='term'><i><tt class='parameter'>autocommit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing <i>DB2_AUTOCOMMIT_ON</i> turns autocommit on for the specified connection resource. </p> <p class='para'> Passing <i>DB2_AUTOCOMMIT_OFF</i> turns autocommit off for the specified connection resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>cursor</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing <i>DB2_FORWARD_ONLY</i> specifies a forward-only cursor for a statement resource. This is the default cursor type, and is supported by all database servers. </p> <p class='para'> Passing <i>DB2_SCROLLABLE</i> specifies a scrollable cursor for a statement resource. Scrollable cursors enable result set rows to be accessed in non-sequential order, but are only supported by IBM DB2 Universal Database databases. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>binmode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing <i>DB2_BINARY</i> specifies that binary data will be returned as is. This is the default mode. This is the equivalent of setting <i>ibm_db2.binmode=1</i> in <var class='filename'>php.ini</var>. </p> <p class='para'> Passing <i>DB2_CONVERT</i> specifies that binary data will be converted to hexadecimal encoding, and will be returned as such. This is the equivalent of setting <i>ibm_db2.binmode=2</i> in <var class='filename'>php.ini</var>. </p> <p class='para'> Passing <i>DB2_PASSTHRU</i> specifies that binary data will be converted to <b><tt class='constant'>NULL</tt></b>. This is the equivalent of setting <i>ibm_db2.binmode=3</i> in <var class='filename'>php.ini</var>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>db2_attr_case</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing <i>DB2_CASE_LOWER</i> specifies that column names of the result set are returned in lower case. </p> <p class='para'> Passing <i>DB2_CASE_UPPER</i> specifies that column names of the result set are returned in upper case. </p> <p class='para'> Passing <i>DB2_CASE_NATURAL</i> specifies that column names of the result set are returned in natural case. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>deferred_prepare</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing <i>DB2_DEFERRED_PREPARE_ON</i> turns deferred prepare on for the specified statement resource. </p> <p class='para'> Passing <i>DB2_DEFERRED_PREPARE_OFF</i> turns deferred prepare off for the specified statement resource. </p> </dd> </dl> <p> </p> <p class='para'> The following new i5/OS options are available in ibm_db2 version 1.5.1 and later. These options apply only when running PHP and ibm_db2 natively on i5 systems. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_fetch_only</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_FETCH_ON</i> - Cursors are read-only and cannot be used for positioned updates or deletes. This is the default unless <i>SQL_ATTR_FOR_FETCH_ONLY</i> environment has been set to <i>SQL_FALSE</i>. </p> <p class='para'> <i>DB2_I5_FETCH_OFF</i> - Cursors can be used for positioned updates and deletes. </p> </dd> </dl> <p> </p> <p class='para'> The following new option is available in ibm_db2 version 1.8.0 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>rowcount</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_ROWCOUNT_PREFETCH_ON</i> - Client can request the full row count prior to fetching, which means that <a href='http://www.php.net/manual/pt_BR/function.db2-num-rows.php' class='function'>db2_num_rows()</a> returns the number of rows selected even when a <i>ROLLFORWARD_ONLY</i> cursor is used. </p> <p class='para'> <i>DB2_ROWCOUNT_PREFETCH_OFF</i> - Client cannot request the full row count prior to fetching. </p> </dd> </dl> <p> </p> <p class='para'> The following new options are available in ibm_db2 version 1.7.0 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>trusted_user</tt></i> </span> </dt><dd class='listitem'> <p class='para'> To switch the user to a trusted user, pass the User ID (String) of the trusted user as the value of this key. This option can be set on a connection resource only. To use this option, trusted context must be enabled on the connection resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>trusted_password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The password (String) that corresponds to the user specified by the trusted_user key. </p> </dd> </dl> <p> </p> <p class='para'> The following new options are available in ibm_db2 version 1.6.0 and later. These options provide useful tracking information that can be accessed during execution with <a href='http://www.php.net/manual/pt_BR/function.db2-get-option.php' class='function'>db2_get_option()</a>. </p><blockquote><p><b class='note'>Nota</b>: When the value in each option is being set, some servers might not handle the entire length provided and might truncate the value. <br /> To ensure that the data specified in each option is converted correctly when transmitted to a host system, use only the characters A through Z, 0 through 9, and the underscore (_) or period (.). <br /> </p></blockquote><p> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>userid</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_USERID</i> - A pointer to a null-terminated character string used to identify the client user ID sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 16 characters. This user-id is not to be confused with the authentication user-id, it is for identification purposes only and is not used for any authorization. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>acctstr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_ACCTSTR</i> - A pointer to a null-terminated character string used to identify the client accounting string sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 200 characters. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>applname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_APPLNAME</i> - A pointer to a null-terminated character string used to identify the client application name sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 32 characters. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>wrkstnname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_WRKSTNNAME</i> - A pointer to a null-terminated character string used to identify the client workstation name sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 18 characters. <br /> </p></blockquote><p> </p> </dd> </dl> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An integer value that specifies the type of resource that was passed into the function. The type of resource and this value must correspond. </p> <p class='para'> Passing <i>1</i> as the value specifies that a connection resource has been passed into the function. </p> <p class='para'> Passing any integer not equal to <i>1</i> as the value specifies that a statement resource has been passed into the function. </p> </dd> </dl> <p> </p> <p class='para'> </p> <p class='para'> The following table specifies which options are compatible with the available resource types: </p><table class='doctable table'> <caption><b>Resource-Parameter Matrix</b></caption> <col align='center' /> <col align='center' /> <col align='center' /> <col align='center' /> <col align='center' /> <thead valign='middle'> <tr valign='middle'> <th>Key</th> <th>Value</th> <th colspan='3'>Resource Type</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td class='empty'>&amp;nbsp;</td><td class='empty'>&amp;nbsp;</td><td align='center'>Connection</td> <td align='center'>Statement</td> <td align='center'>Result Set</td> </tr> <tr valign='middle'> <td align='left'>autocommit</td> <td align='left'><i>DB2_AUTOCOMMIT_ON</i></td> <td align='center'>X</td> <td align='center'>-</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>autocommit</td> <td align='left'><i>DB2_AUTOCOMMIT_OFF</i></td> <td align='center'>X</td> <td align='center'>-</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>cursor</td> <td align='left'><i>DB2_SCROLLABLE</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>cursor</td> <td align='left'><i>DB2_FORWARD_ONLY</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>binmode</td> <td align='left'><i>DB2_BINARY</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>binmode</td> <td align='left'><i>DB2_CONVERT</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>binmode</td> <td align='left'><i>DB2_PASSTHRU</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>db2_attr_case</td> <td align='left'><i>DB2_CASE_LOWER</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>db2_attr_case</td> <td align='left'><i>DB2_CASE_UPPER</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>db2_attr_case</td> <td align='left'><i>DB2_CASE_NATURAL</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>deferred_prepare</td> <td align='left'><i>DB2_DEFERRED_PREPARE_ON</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>deferred_prepare</td> <td align='left'><i>DB2_DEFERRED_PREPARE_OFF</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>i5_fetch_only</td> <td align='left'><i>DB2_I5_FETCH_ON</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>i5_fetch_only</td> <td align='left'><i>DB2_I5_FETCH_OFF</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>rowcount</td> <td align='left'><i>DB2_ROWCOUNT_PREFETCH_ON</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>rowcount</td> <td align='left'><i>DB2_ROWCOUNT_PREFETCH_OFF</i></td> <td align='center'>-</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>trusted_user</td> <td align='left'><i>&amp;lt;USER NAME&amp;gt; (String)</i></td> <td align='center'>X</td> <td align='center'>-</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>trusted_password</td> <td align='left'><i>&amp;lt;PASSWORD&amp;gt; (String)</i></td> <td align='center'>X</td> <td align='center'>-</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>userid</td> <td align='left'><i>SQL_ATTR_INFO_USERID</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>acctstr</td> <td align='left'><i>SQL_ATTR_INFO_ACCTSTR</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>applname</td> <td align='left'><i>SQL_ATTR_INFO_APPLNAME</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>wrkstnname</td> <td align='left'><i>SQL_ATTR_INFO_WRKSTNNAME</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-set-option.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-set-option.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Setting one parameter with a connection resource</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_ON</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;resource,&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;type&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Check&amp;nbsp;if&amp;nbsp;all&amp;nbsp;options&amp;nbsp;could&amp;nbsp;be&amp;nbsp;set&amp;nbsp;correctly&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Options&amp;nbsp;Set&amp;nbsp;Successfully'</span><span style='color: #007700'>;<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;Not&amp;nbsp;Set&amp;nbsp;Options'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Options Set Successfully</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Setting multiple parameters with a connection resource</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'binmode'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_PASSTHRU</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'db2_attr_case'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_CASE_UPPER</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;resource,&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;type&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Check&amp;nbsp;if&amp;nbsp;all&amp;nbsp;options&amp;nbsp;could&amp;nbsp;be&amp;nbsp;set&amp;nbsp;correctly&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Options&amp;nbsp;Set&amp;nbsp;Successfully'</span><span style='color: #007700'>;<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;Not&amp;nbsp;Set&amp;nbsp;Options'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Options Set Successfully</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #3 Setting multiple parameters with an invalid key</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'MY_INVALID_KEY'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_PASSTHRU</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'db2_attr_case'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_CASE_UPPER</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;resource,&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;type&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Check&amp;nbsp;if&amp;nbsp;all&amp;nbsp;options&amp;nbsp;could&amp;nbsp;be&amp;nbsp;set&amp;nbsp;correctly&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Options&amp;nbsp;Set&amp;nbsp;Successfully'</span><span style='color: #007700'>;<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;Not&amp;nbsp;Set&amp;nbsp;Options'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Could Not Set Options</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #4 Setting multiple parameters with an invalid value</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'binmode'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'INVALID_VALUE'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'db2_attr_case'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_CASE_UPPER</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;resource,&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;type&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Check&amp;nbsp;if&amp;nbsp;all&amp;nbsp;options&amp;nbsp;could&amp;nbsp;be&amp;nbsp;set&amp;nbsp;correctly&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Options&amp;nbsp;Set&amp;nbsp;Successfully'</span><span style='color: #007700'>;<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;Not&amp;nbsp;Set&amp;nbsp;Options'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Could Not Set Options</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #5 Setting multiple parameters with a connection resource and the wrong type</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'binmode'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_PASSTHRU</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'db2_attr_case'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_CASE_UPPER</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;resource,&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;the&amp;nbsp;wrong&amp;nbsp;type&amp;nbsp;value&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Check&amp;nbsp;if&amp;nbsp;all&amp;nbsp;options&amp;nbsp;could&amp;nbsp;be&amp;nbsp;set&amp;nbsp;correctly&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Options&amp;nbsp;Set&amp;nbsp;Successfully'</span><span style='color: #007700'>;<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;Not&amp;nbsp;Set&amp;nbsp;Options'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Could Not Set Options</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #6 Setting multiple parameters with the wrong resource</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'binmode'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_PASSTHRU</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'db2_attr_case'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_CASE_UPPER</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;EMPLOYEE'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;wrong&amp;nbsp;resource,&amp;nbsp;and&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;type&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Check&amp;nbsp;if&amp;nbsp;all&amp;nbsp;options&amp;nbsp;could&amp;nbsp;be&amp;nbsp;set&amp;nbsp;correctly&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Options&amp;nbsp;Set&amp;nbsp;Successfully'</span><span style='color: #007700'>;<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;Not&amp;nbsp;Set&amp;nbsp;Options'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Could Not Set Options</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #7 Putting it all together</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$protocol&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'TCPIP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Connection&amp;nbsp;String&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=</span><span style='color: #0000BB'>$protocol</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'UID=</span><span style='color: #0000BB'>$username</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'db2_attr_case'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_CASE_LOWER</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;EMPLOYEE&amp;nbsp;WHERE&amp;nbsp;EMPNO&amp;nbsp;=&amp;nbsp;?&amp;nbsp;OR&amp;nbsp;EMPNO&amp;nbsp;=&amp;nbsp;?'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Call&amp;nbsp;the&amp;nbsp;function&amp;nbsp;using&amp;nbsp;the&amp;nbsp;correct&amp;nbsp;resource,&amp;nbsp;options&amp;nbsp;array,&amp;nbsp;and&amp;nbsp;type&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$option_result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'000130'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'000140'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;Row&amp;nbsp;2&amp;nbsp;before&amp;nbsp;Row&amp;nbsp;1&amp;nbsp;since&amp;nbsp;Scrollable&amp;nbsp;Cursor&amp;nbsp;*/<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>db2_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>));<br />print&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;nbsp;/&amp;gt;&amp;lt;br&amp;nbsp;/&amp;gt;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>db2_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>Array ( [empno] =&amp;gt; 000140 [firstnme] =&amp;gt; HEATHER [midinit] =&amp;gt; A [lastname] =&amp;gt; NICHOLLS [workdept] =&amp;gt; C01 [phoneno] =&amp;gt; 1793 [hiredate] =&amp;gt; 1976-12-15 [job] =&amp;gt; ANALYST [edlevel] =&amp;gt; 18 [sex] =&amp;gt; F [birthdate] =&amp;gt; 1946-01-19 [salary] =&amp;gt; 28420.00 [bonus] =&amp;gt; 600.00 [comm] =&amp;gt; 2274.00 ) Array ( [empno] =&amp;gt; 000130 [firstnme] =&amp;gt; DELORES [midinit] =&amp;gt; M [lastname] =&amp;gt; QUINTANA [workdept] =&amp;gt; C01 [phoneno] =&amp;gt; 4578 [hiredate] =&amp;gt; 1971-07-28 [job] =&amp;gt; ANALYST [edlevel] =&amp;gt; 16 [sex] =&amp;gt; F [birthdate] =&amp;gt; 1925-09-15 [salary] =&amp;gt; 23800.00 [bonus] =&amp;gt; 500.00 [comm] =&amp;gt; 1904.00 )</pre></div></div> </div><p> </p><div class='example'> <p><b>Exemplo #8 i5/OS cursors are read-only</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'i5_lib'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'nobody'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;names&amp;nbsp;where&amp;nbsp;first&amp;nbsp;=&amp;nbsp;?'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'first2'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'name'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'i5_fetch_only'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>DB2_I5_FETCH_ON</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>,</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> first2 last2 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-set-option.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function' rel='rdfs-seeAlso'>db2_pconnect()</a> - Returns a persistent connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function' rel='rdfs-seeAlso'>db2_exec()</a> - Executes an SQL statement directly</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-cursor-type.php' class='function' rel='rdfs-seeAlso'>db2_cursor_type()</a> - Returns the cursor type used by a statement resource</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_server_info" value="<div id='function.db2-server-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-server-info.php'>db2_server_info</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.1.1)</p><p class='refpurpose'><span class='refname'>db2_server_info</span> &amp;mdash; <span class='dc-title'>Returns an object with properties that describe the DB2 database server</span></p> </div> <a name='function.db2-server-info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>db2_server_info</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> This function returns an object with read-only properties that return information about the IBM DB2, Cloudscape, or Apache Derby database server. The following table lists the database server properties: </p><table class='doctable table'> <caption><b>Database server properties</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Property name</th> <th>Return type</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>DBMS_NAME</td> <td align='left'>string</td> <td align='left'>The name of the database server to which you are connected. For DB2 servers this is a combination of <i>DB2</i> followed by the operating system on which the database server is running.</td> </tr> <tr valign='middle'> <td align='left'>DBMS_VER</td> <td align='left'>string</td> <td align='left'>The version of the database server, in the form of a string &amp;quot;MM.mm.uuuu&amp;quot; where <var class='varname'>MM</var> is the major version, <var class='varname'>mm</var> is the minor version, and <var class='varname'>uuuu</var> is the update. For example, &amp;quot;08.02.0001&amp;quot; represents major version 8, minor version 2, update 1. </td> </tr> <tr valign='middle'> <td align='left'>DB_CODEPAGE</td> <td align='left'>int</td> <td align='left'>The code page of the database to which you are connected.</td> </tr> <tr valign='middle'> <td align='left'>DB_NAME</td> <td align='left'>string</td> <td align='left'>The name of the database to which you are connected.</td> </tr> <tr valign='middle'> <td align='left'>DFT_ISOLATION</td> <td align='left'>string</td> <td align='left'> <p class='para'>The default transaction isolation level supported by the server: </p><dl> <dt class='varlistentry'> <span class='term'>UR</span> </dt><dd class='listitem'> <p class='para'> Uncommitted read: changes are immediately visible by all concurrent transactions. </p> </dd> <dt class='varlistentry'> <span class='term'>CS</span> </dt><dd class='listitem'> <p class='para'> Cursor stability: a row read by one transaction can be altered and committed by a second concurrent transaction. </p> </dd> <dt class='varlistentry'> <span class='term'>RS</span> </dt><dd class='listitem'> <p class='para'> Read stability: a transaction can add or remove rows matching a search condition or a pending transaction. </p> </dd> <dt class='varlistentry'> <span class='term'>RR</span> </dt><dd class='listitem'> <p class='para'> Repeatable read: data affected by pending transaction is not available to other transactions. </p> </dd> <dt class='varlistentry'> <span class='term'>NC</span> </dt><dd class='listitem'> <p class='para'> No commit: any changes are visible at the end of a successful operation. Explicit commits and rollbacks are not allowed. </p> </dd> </dl> <p> </p> </td> </tr> <tr valign='middle'> <td align='left'>IDENTIFIER_QUOTE_CHAR</td> <td align='left'>string</td> <td align='left'>The character used to delimit an identifier.</td> </tr> <tr valign='middle'> <td align='left'>INST_NAME</td> <td align='left'>string</td> <td align='left'>The instance on the database server that contains the database.</td> </tr> <tr valign='middle'> <td align='left'>ISOLATION_OPTION</td> <td align='left'>array</td> <td align='left'>An array of the isolation options supported by the database server. The isolation options are described in the DFT_ISOLATION property.</td> </tr> <tr valign='middle'> <td align='left'>KEYWORDS</td> <td align='left'>array</td> <td align='left'>An array of the keywords reserved by the database server.</td> </tr> <tr valign='middle'> <td align='left'>LIKE_ESCAPE_CLAUSE</td> <td align='left'>bool</td> <td align='left'><b><tt class='constant'>TRUE</tt></b> if the database server supports the use of <i>%</i> and <i>_</i> wildcard characters. <b><tt class='constant'>FALSE</tt></b> if the database server does not support these wildcard characters.</td> </tr> <tr valign='middle'> <td align='left'>MAX_COL_NAME_LEN</td> <td align='left'>int</td> <td align='left'>Maximum length of a column name supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>MAX_IDENTIFIER_LEN</td> <td align='left'>int</td> <td align='left'>Maximum length of an SQL identifier supported by the database server, expressed in characters.</td> </tr> <tr valign='middle'> <td align='left'>MAX_INDEX_SIZE</td> <td align='left'>int</td> <td align='left'>Maximum size of columns combined in an index supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>MAX_PROC_NAME_LEN</td> <td align='left'>int</td> <td align='left'>Maximum length of a procedure name supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>MAX_ROW_SIZE</td> <td align='left'>int</td> <td align='left'>Maximum length of a row in a base table supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>MAX_SCHEMA_NAME_LEN</td> <td align='left'>int</td> <td align='left'>Maximum length of a schema name supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>MAX_STATEMENT_LEN</td> <td align='left'>int</td> <td align='left'>Maximum length of an SQL statement supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>MAX_TABLE_NAME_LEN</td> <td align='left'>int</td> <td align='left'>Maximum length of a table name supported by the database server, expressed in bytes.</td> </tr> <tr valign='middle'> <td align='left'>NON_NULLABLE_COLUMNS</td> <td align='left'>bool</td> <td align='left'><b><tt class='constant'>TRUE</tt></b> if the database server supports columns that can be defined as NOT NULL, <b><tt class='constant'>FALSE</tt></b> if the database server does not support columns defined as NOT NULL.</td> </tr> <tr valign='middle'> <td align='left'>PROCEDURES</td> <td align='left'>bool</td> <td align='left'><b><tt class='constant'>TRUE</tt></b> if the database server supports the use of the CALL statement to call stored procedures, <b><tt class='constant'>FALSE</tt></b> if the database server does not support the CALL statement.</td> </tr> <tr valign='middle'> <td align='left'>SPECIAL_CHARS</td> <td align='left'>string</td> <td align='left'>A string containing all of the characters other than a-Z, 0-9, and underscore that can be used in an identifier name.</td> </tr> <tr valign='middle'> <td align='left'>SQL_CONFORMANCE</td> <td align='left'>string</td> <td align='left'> <p class='para'>The level of conformance to the ANSI/ISO SQL-92 specification offered by the database server: </p><dl> <dt class='varlistentry'> <span class='term'>ENTRY</span> </dt><dd class='listitem'> <p class='para'> Entry-level SQL-92 compliance. </p> </dd> <dt class='varlistentry'> <span class='term'>FIPS127</span> </dt><dd class='listitem'> <p class='para'> FIPS-127-2 transitional compliance. </p> </dd> <dt class='varlistentry'> <span class='term'>FULL</span> </dt><dd class='listitem'> <p class='para'> Full level SQL-92 compliance. </p> </dd> <dt class='varlistentry'> <span class='term'>INTERMEDIATE</span> </dt><dd class='listitem'> <p class='para'> Intermediate level SQL-92 compliance. </p> </dd> </dl> <p> </p> </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-server-info.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies an active DB2 client connection. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-server-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an object on a successful call. Returns <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.db2-server-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_server_info()</b> example</b></p> <div class='example-contents para'><p> To retrieve information about the server, you must pass a valid database connection resource to <b>db2_server_info()</b>. </p></div> <div class='example-contents programlisting'><div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'sample'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$server&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_server_info</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DBMS_NAME:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DBMS_NAME&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DBMS_VER:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DBMS_VER&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DB_CODEPAGE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DB_CODEPAGE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DB_NAME:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DB_NAME&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'INST_NAME:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>INST_NAME&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'SPECIAL_CHARS:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>SPECIAL_CHARS&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'KEYWORDS:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>sizeof</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>KEYWORDS</span><span style='color: #007700'>)&amp;nbsp;);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DFT_ISOLATION:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DFT_ISOLATION&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'ISOLATION_OPTION:&amp;nbsp;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$il&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;foreach(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>ISOLATION_OPTION&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$opt&amp;nbsp;</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$il&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #0000BB'>$opt</span><span style='color: #007700'>.</span><span style='color: #DD0000'>'&amp;nbsp;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$il&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'SQL_CONFORMANCE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>SQL_CONFORMANCE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'PROCEDURES:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PROCEDURES&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'IDENTIFIER_QUOTE_CHAR:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>IDENTIFIER_QUOTE_CHAR&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'LIKE_ESCAPE_CLAUSE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>LIKE_ESCAPE_CLAUSE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_COL_NAME_LEN:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_COL_NAME_LEN&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_ROW_SIZE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_ROW_SIZE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_IDENTIFIER_LEN:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_IDENTIFIER_LEN&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_INDEX_SIZE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_INDEX_SIZE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_PROC_NAME_LEN:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_PROC_NAME_LEN&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_SCHEMA_NAME_LEN:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_SCHEMA_NAME_LEN&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_STATEMENT_LEN:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_STATEMENT_LEN&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MAX_TABLE_NAME_LEN:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>MAX_TABLE_NAME_LEN&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'NON_NULLABLE_COLUMNS:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$server</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>NON_NULLABLE_COLUMNS&amp;nbsp;</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div></div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'><div class='cdata'><pre>DBMS_NAME: string(9) &amp;quot;DB2/LINUX&amp;quot; DBMS_VER: string(10) &amp;quot;08.02.0000&amp;quot; DB_CODEPAGE: int(1208) DB_NAME: string(6) &amp;quot;SAMPLE&amp;quot; INST_NAME: string(8) &amp;quot;db2inst1&amp;quot; SPECIAL_CHARS: string(2) &amp;quot;@#&amp;quot; KEYWORDS: int(179) DFT_ISOLATION: string(2) &amp;quot;CS&amp;quot; ISOLATION_OPTION: string(12) &amp;quot;UR CS RS RR &amp;quot; SQL_CONFORMANCE: string(7) &amp;quot;FIPS127&amp;quot; PROCEDURES: bool(true) IDENTIFIER_QUOTE_CHAR: string(1) &amp;quot;&amp;quot;&amp;quot; LIKE_ESCAPE_CLAUSE: bool(true) MAX_COL_NAME_LEN: int(30) MAX_ROW_SIZE: int(32677) MAX_IDENTIFIER_LEN: int(18) MAX_INDEX_SIZE: int(1024) MAX_PROC_NAME_LEN: int(128) MAX_SCHEMA_NAME_LEN: int(30) MAX_STATEMENT_LEN: int(2097152) MAX_TABLE_NAME_LEN: int(128) NON_NULLABLE_COLUMNS: bool(true)</pre></div></div> </div><p> </p> </div> <a name='function.db2-server-info.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-client-info.php' class='function' rel='rdfs-seeAlso'>db2_client_info()</a> - Returns an object with properties that describe the DB2 database client</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_rollback" value="<div id='function.db2-rollback' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-rollback.php'>db2_rollback</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_rollback</span> &amp;mdash; <span class='dc-title'> Rolls back a transaction </span></p> </div> <a name='function.db2-rollback.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_rollback</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> Rolls back an in-progress transaction on the specified connection resource and begins a new transaction. PHP applications normally default to AUTOCOMMIT mode, so <b>db2_rollback()</b> normally has no effect unless AUTOCOMMIT has been turned off for the connection resource. </p> <blockquote><p><b class='note'>Nota</b>: If the specified connection resource is a persistent connection, all transactions in progress for all applications using that persistent connection will be rolled back. For this reason, persistent connections are not recommended for use in applications that require transactions. <br /> </p></blockquote> </div> <a name='function.db2-rollback.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid database connection resource variable as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-rollback.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-rollback.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Rolling back a DELETE statement</b></p> <div class='example-contents para'><p> In the following example, we count the number of rows in a table, turn off AUTOCOMMIT mode on a database connection, delete all of the rows in the table and return the count of <i>0</i> to prove that the rows have been removed. We then issue <b>db2_rollback()</b> and return the updated count of rows in the table to show that the number is the same as before we issued the DELETE statement. The return to the original state of the table demonstrates that the roll back of the transaction succeeded. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;count(*)&amp;nbsp;FROM&amp;nbsp;animals'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Turn&amp;nbsp;AUTOCOMMIT&amp;nbsp;off<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Delete&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;from&amp;nbsp;ANIMALS<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;animals'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;count(*)&amp;nbsp;FROM&amp;nbsp;animals'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Roll&amp;nbsp;back&amp;nbsp;the&amp;nbsp;DELETE&amp;nbsp;statement<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_rollback</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;count(*)&amp;nbsp;FROM&amp;nbsp;animals'&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 7 0 7 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-rollback.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-autocommit.php' class='function' rel='rdfs-seeAlso'>db2_autocommit()</a> - Returns or sets the AUTOCOMMIT state for a database connection</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-commit.php' class='function' rel='rdfs-seeAlso'>db2_commit()</a> - Commits a transaction</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_result" value="<div id='function.db2-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-result.php'>db2_result</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_result</span> &amp;mdash; <span class='dc-title'> Returns a single column from a row in the result set </span></p> </div> <a name='function.db2-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>db2_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Use <b>db2_result()</b> to return the value of a specified column in the current row of a result set. You must call <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function'>db2_fetch_row()</a> before calling <b>db2_result()</b> to set the location of the result set pointer. </p> </div> <a name='function.db2-result.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Either an integer mapping to the 0-indexed field in the result set, or a string matching the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the value of the requested field if the field exists in the result set. Returns NULL if the field does not exist, and issues a warning. </p> </div> <a name='function.db2-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_result()</b> example</b></p> <div class='example-contents para'><p> The following example demonstrates how to iterate through a result set with <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function'>db2_fetch_row()</a> and retrieve columns from the result set with <b>db2_result()</b>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;name,&amp;nbsp;breed&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;WHERE&amp;nbsp;weight&amp;nbsp;&amp;lt;&amp;nbsp;?'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>10</span><span style='color: #007700'>));<br />while&amp;nbsp;(</span><span style='color: #0000BB'>db2_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$breed&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'BREED'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$name</span><span style='color: #DD0000'>&amp;nbsp;</span><span style='color: #0000BB'>$breed</span><span style='color: #DD0000'>'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> cat Pook gold fish Bubbles budgerigar Gizmo goat Rickety Ride </pre></div> </div> </div><p> </p> </div> <a name='function.db2-result.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function' rel='rdfs-seeAlso'>db2_fetch_array()</a> - Returns an array, indexed by column position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>db2_fetch_assoc()</a> - Returns an array, indexed by column name, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function' rel='rdfs-seeAlso'>db2_fetch_both()</a> - Returns an array, indexed by both column name and position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function' rel='rdfs-seeAlso'>db2_fetch_object()</a> - Returns an object with properties representing columns in the fetched row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_procedure_columns" value="<div id='function.db2-procedure-columns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-procedure-columns.php'>db2_procedure_columns</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_procedure_columns</span> &amp;mdash; <span class='dc-title'> Returns a result set listing stored procedure parameters </span></p> </div> <a name='function.db2-procedure-columns.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_procedure_columns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$procedure</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$parameter</tt></span> )</div> <p class='para rdfs-comment'> Returns a result set listing the parameters for one or more stored procedures. </p> </div> <a name='function.db2-procedure-columns.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the procedures. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>procedure</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the procedure. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>parameter</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the parameter. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. If this parameter is <b><tt class='constant'>NULL</tt></b>, all parameters for the specified stored procedures are returned. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-procedure-columns.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the parameters for the stored procedures matching the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>PROCEDURE_CAT</td> <td align='left'>The catalog that contains the procedure. The value is <b><tt class='constant'>NULL</tt></b> if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>PROCEDURE_SCHEM</td> <td align='left'>Name of the schema that contains the stored procedure.</td> </tr> <tr valign='middle'> <td align='left'>PROCEDURE_NAME</td> <td align='left'>Name of the procedure.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_NAME</td> <td align='left'>Name of the parameter.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_TYPE</td> <td align='left'> <p class='para'> An integer value representing the type of the parameter: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Return value</th> <th>Parameter type</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>1 (SQL_PARAM_INPUT)</td> <td align='left'>Input (IN) parameter.</td> </tr> <tr valign='middle'> <td align='left'>2 (SQL_PARAM_INPUT_OUTPUT)</td> <td align='left'>Input/output (INOUT) parameter.</td> </tr> <tr valign='middle'> <td align='left'>3 (SQL_PARAM_OUTPUT)</td> <td align='left'>Output (OUT) parameter.</td> </tr> </tbody> </table> <p> </p> </td> </tr> <tr valign='middle'> <td align='left'>DATA_TYPE</td> <td align='left'>The SQL data type for the parameter represented as an integer value.</td> </tr> <tr valign='middle'> <td align='left'>TYPE_NAME</td> <td align='left'>A string representing the data type for the parameter.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_SIZE</td> <td align='left'>An integer value representing the size of the parameter.</td> </tr> <tr valign='middle'> <td align='left'>BUFFER_LENGTH</td> <td align='left'> Maximum number of bytes necessary to store data for this parameter. </td> </tr> <tr valign='middle'> <td align='left'>DECIMAL_DIGITS</td> <td align='left'> The scale of the parameter, or <b><tt class='constant'>NULL</tt></b> where scale is not applicable. </td> </tr> <tr valign='middle'> <td align='left'>NUM_PREC_RADIX</td> <td align='left'> An integer value of either <i>10</i> (representing an exact numeric data type), <i>2</i> (representing an approximate numeric data type), or <b><tt class='constant'>NULL</tt></b> (representing a data type for which radix is not applicable). </td> </tr> <tr valign='middle'> <td align='left'>NULLABLE</td> <td align='left'>An integer value representing whether the parameter is nullable or not.</td> </tr> <tr valign='middle'> <td align='left'>REMARKS</td> <td align='left'>Description of the parameter.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_DEF</td> <td align='left'>Default value for the parameter.</td> </tr> <tr valign='middle'> <td align='left'>SQL_DATA_TYPE</td> <td align='left'>An integer value representing the size of the parameter.</td> </tr> <tr valign='middle'> <td align='left'>SQL_DATETIME_SUB</td> <td align='left'> Returns an integer value representing a datetime subtype code, or <b><tt class='constant'>NULL</tt></b> for SQL data types to which this does not apply. </td> </tr> <tr valign='middle'> <td align='left'>CHAR_OCTET_LENGTH</td> <td align='left'> Maximum length in octets for a character data type parameter, which matches COLUMN_SIZE for single-byte character set data, or <b><tt class='constant'>NULL</tt></b> for non-character data types. </td> </tr> <tr valign='middle'> <td align='left'>ORDINAL_POSITION</td> <td align='left'>The 1-indexed position of the parameter in the CALL statement.</td> </tr> <tr valign='middle'> <td align='left'>IS_NULLABLE</td> <td align='left'> A string value where &amp;#039;YES&amp;#039; means that the parameter accepts or returns <b><tt class='constant'>NULL</tt></b> values and &amp;#039;NO&amp;#039; means that the parameter does not accept or return <b><tt class='constant'>NULL</tt></b> values. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-procedure-columns.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_procedures" value="<div id='function.db2-procedures' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-procedures.php'>db2_procedures</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_procedures</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the stored procedures registered in a database </span></p> </div> <a name='function.db2-procedures.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_procedures</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$procedure</tt></span> )</div> <p class='para rdfs-comment'> Returns a result set listing the stored procedures registered in a database. </p> </div> <a name='function.db2-procedures.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the procedures. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>procedure</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the procedure. This parameter accepts a search pattern containing <i>_</i> and <i>%</i> as wildcards. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-procedures.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the stored procedures matching the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>PROCEDURE_CAT</td> <td align='left'>The catalog that contains the procedure. The value is <b><tt class='constant'>NULL</tt></b> if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>PROCEDURE_SCHEM</td> <td align='left'>Name of the schema that contains the stored procedure.</td> </tr> <tr valign='middle'> <td align='left'>PROCEDURE_NAME</td> <td align='left'>Name of the procedure.</td> </tr> <tr valign='middle'> <td align='left'>NUM_INPUT_PARAMS</td> <td align='left'>Number of input (IN) parameters for the stored procedure.</td> </tr> <tr valign='middle'> <td align='left'>NUM_OUTPUT_PARAMS</td> <td align='left'>Number of output (OUT) parameters for the stored procedure.</td> </tr> <tr valign='middle'> <td align='left'>NUM_RESULT_SETS</td> <td align='left'>Number of result sets returned by the stored procedure.</td> </tr> <tr valign='middle'> <td align='left'>REMARKS</td> <td align='left'>Any comments about the stored procedure.</td> </tr> <tr valign='middle'> <td align='left'>PROCEDURE_TYPE</td> <td align='left'>Always returns <i>1</i>, indicating that the stored procedure does not return a return value.</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-procedures.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_primary_keys" value="<div id='function.db2-primary-keys' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-primary-keys.php'>db2_primary_keys</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_primary_keys</span> &amp;mdash; <span class='dc-title'> Returns a result set listing primary keys for a table </span></p> </div> <a name='function.db2-primary-keys.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_primary_keys</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-name</tt></span> )</div> <p class='para rdfs-comment'> Returns a result set listing the primary keys for a table. </p> </div> <a name='function.db2-primary-keys.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. If <i><tt class='parameter'>schema</tt></i> is <b><tt class='constant'>NULL</tt></b>, <b>db2_primary_keys()</b> matches the schema for the current connection. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-primary-keys.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the primary keys for the specified table. The result set is composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>TABLE_CAT</td> <td align='left'> Name of the catalog for the table containing the primary key. The value is NULL if this table does not have catalogs. </td> </tr> <tr valign='middle'> <td align='left'>TABLE_SCHEM</td> <td align='left'> Name of the schema for the table containing the primary key. </td> </tr> <tr valign='middle'> <td align='left'>TABLE_NAME</td> <td align='left'>Name of the table containing the primary key.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_NAME</td> <td align='left'>Name of the column containing the primary key.</td> </tr> <tr valign='middle'> <td align='left'>KEY_SEQ</td> <td align='left'>1-indexed position of the column in the key.</td> </tr> <tr valign='middle'> <td align='left'>PK_NAME</td> <td align='left'>The name of the primary key.</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-primary-keys.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_prepare" value="<div id='function.db2-prepare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-prepare.php'>db2_prepare</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_prepare</span> &amp;mdash; <span class='dc-title'> Prepares an SQL statement to be executed </span></p> </div> <a name='function.db2-prepare.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_prepare</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$statement</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> <b>db2_prepare()</b> creates a prepared SQL statement which can include 0 or more parameter markers (<i>?</i> characters) representing parameters for input, output, or input/output. You can pass parameters to the prepared statement using <a href='http://www.php.net/manual/pt_BR/function.db2-bind-param.php' class='function'>db2_bind_param()</a>, or for input values only, as an array passed to <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a>. </p> <p class='para'> There are three main advantages to using prepared statements in your application: </p><ul class='itemizedlist'> <li class='listitem'> <p class='para'> <em class='emphasis'>Performance</em>: when you prepare a statement, the database server creates an optimized access plan for retrieving data with that statement. Subsequently issuing the prepared statement with <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a> enables the statements to reuse that access plan and avoids the overhead of dynamically creating a new access plan for every statement you issue. </p> </li> <li class='listitem'> <p class='para'> <em class='emphasis'>Security</em>: when you prepare a statement, you can include parameter markers for input values. When you execute a prepared statement with input values for placeholders, the database server checks each input value to ensure that the type matches the column definition or parameter definition. </p> </li> <li class='listitem'> <p class='para'> <em class='emphasis'>Advanced functionality</em>: Parameter markers not only enable you to pass input values to prepared SQL statements, they also enable you to retrieve OUT and INOUT parameters from stored procedures using <a href='http://www.php.net/manual/pt_BR/function.db2-bind-param.php' class='function'>db2_bind_param()</a>. </p> </li> </ul><p> </p> </div> <a name='function.db2-prepare.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid database connection resource variable as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>statement</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An SQL statement, optionally containing one or more parameter markers.. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>options</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An associative array containing statement options. You can use this parameter to request a scrollable cursor on database servers that support this functionality. </p> <p class='para'> For a description of valid statement options, see <a href='http://www.php.net/manual/pt_BR/function.db2-set-option.php' class='function'>db2_set_option()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-prepare.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource if the SQL statement was successfully parsed and prepared by the database server. Returns <b><tt class='constant'>FALSE</tt></b> if the database server returned an error. You can determine which error was returned by calling <a href='http://www.php.net/manual/pt_BR/function.db2-stmt-error.php' class='function'>db2_stmt_error()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-stmt-errormsg.php' class='function'>db2_stmt_errormsg()</a>. </p> </div> <a name='function.db2-prepare.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Preparing and executing an SQL statement with parameter markers</b></p> <div class='example-contents para'><p> The following example prepares an INSERT statement that accepts four parameter markers, then iterates over an array of arrays containing the input values to be passed to <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$animals&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cat'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Pook'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3.2</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'dog'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Peaches'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12.3</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'horse'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Smarty'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>350.0</span><span style='color: #007700'>),<br />);<br /><br /></span><span style='color: #0000BB'>$insert&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;animals&amp;nbsp;(id,&amp;nbsp;breed,&amp;nbsp;name,&amp;nbsp;weight)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;VALUES&amp;nbsp;(?,&amp;nbsp;?,&amp;nbsp;?,&amp;nbsp;?)'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$insert</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;foreach&amp;nbsp;(</span><span style='color: #0000BB'>$animals&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.db2-prepare.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-bind-param.php' class='function' rel='rdfs-seeAlso'>db2_bind_param()</a> - Binds a PHP variable to an SQL statement parameter</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function' rel='rdfs-seeAlso'>db2_execute()</a> - Executes a prepared SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-error.php' class='function' rel='rdfs-seeAlso'>db2_stmt_error()</a> - Returns a string containing the SQLSTATE returned by an SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_stmt_errormsg()</a> - Returns a string containing the last SQL statement error message</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_pconnect" value="<div id='function.db2-pconnect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-pconnect.php'>db2_pconnect</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_pconnect</span> &amp;mdash; <span class='dc-title'> Returns a persistent connection to a database </span></p> </div> <a name='function.db2-pconnect.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_pconnect</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$database</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$username</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$password</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> Returns a persistent connection to an IBM DB2 Universal Database, IBM Cloudscape, or Apache Derby database. For more information on persistent connections, refer to <a href='http://www.php.net/manual/pt_BR/features.persistent-connections.php' class='xref'>Conex&amp;atilde;o Permanente com o Banco de Dados</a>. </p> <p class='para'> Calling <a href='http://www.php.net/manual/pt_BR/function.db2-close.php' class='function'>db2_close()</a> on a persistent connection always returns <b><tt class='constant'>TRUE</tt></b>, but the underlying DB2 client connection remains open and waiting to serve the next matching <b>db2_pconnect()</b> request. </p> </div> <a name='function.db2-pconnect.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>database</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The database alias in the DB2 client catalog. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>username</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The username with which you are connecting to the database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The password with which you are connecting to the database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>options</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An associative array of connection options that affect the behavior of the connection, where valid array keys include: </p><dl> <dt class='varlistentry'> <br /><span class='term'><i><tt class='parameter'>autocommit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the <i>DB2_AUTOCOMMIT_ON</i> value turns autocommit on for this connection handle. </p> <p class='para'> Passing the <i>DB2_AUTOCOMMIT_OFF</i> value turns autocommit off for this connection handle. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>DB2_ATTR_CASE</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the <i>DB2_CASE_NATURAL</i> value specifies that column names are returned in natural case. </p> <p class='para'> Passing the <i>DB2_CASE_LOWER</i> value specifies that column names are returned in lower case. </p> <p class='para'> Passing the <i>DB2_CASE_UPPER</i> value specifies that column names are returned in upper case. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>CURSOR</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the <i>DB2_FORWARD_ONLY</i> value specifies a forward-only cursor for a statement resource. This is the default cursor type and is supported on all database servers. </p> <p class='para'> Passing the <i>DB2_SCROLLABLE</i> value specifies a scrollable cursor for a statement resource. This mode enables random access to rows in a result set, but currently is supported only by IBM DB2 Universal Database. </p> </dd> </dl> <p> </p> <p class='para'> The following new option is available in ibm_db2 version 1.7.0 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>trustedcontext</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the DB2_TRUSTED_CONTEXT_ENABLE value turns trusted context on for this connection handle. This parameter cannot be set using <a href='http://www.php.net/manual/pt_BR/function.db2-set-option.php' class='function'>db2_set_option()</a>. </p> <p class='para'> This key works only if the database is cataloged (even if the database is local), or if you specify the full DSN when you create the connection. </p> <p class='para'> To catalog the database, use following commands: </p> <p class='para'> <pre class='literallayout'>db2 catalog tcpip node loopback remote &amp;lt;SERVERNAME&amp;gt; server &amp;lt;SERVICENAME&amp;gt; db2 catalog database &amp;lt;LOCALDBNAME&amp;gt; as &amp;lt;REMOTEDBNAME&amp;gt; at node loopback db2 &amp;quot;update dbm cfg using svcename &amp;lt;SERVICENAME&amp;gt;&amp;quot; db2set DB2COMM=TCPIP</pre> </p> </dd> </dl> <p> </p> <p class='para'> The following new i5/OS options are available in ibm_db2 version 1.5.1 and later. <div class='tip'><b class='tip'>Dica</b> <p class='para'>Conflicting connection attributes used in conjunction with persistent connections can produce indeterminate results on i5/OS. Site policies should be establish for all applications using each persistent connection user profile. The default DB2_AUTOCOMMIT_ON is suggested when using persistent connections. </p> </div> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_lib</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A character value that indicates the default library that will be used for resolving unqualified file references. This is not valid if the connection is using system naming mode. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_naming</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_NAMING_ON</i> value turns on DB2 UDB CLI iSeries system naming mode. Files are qualified using the slash (/) delimiter. Unqualified files are resolved using the library list for the job. </p> <p class='para'> <i>DB2_I5_NAMING_OFF</i> value turns off DB2 UDB CLI default naming mode, which is SQL naming. Files are qualified using the period (.) delimiter. Unqualified files are resolved using either the default library or the current user ID. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_commit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <i><tt class='parameter'>i5_commit</tt></i> attribute should be set before the <b>db2_pconnect()</b>. If the value is changed after the connection has been established, and the connection is to a remote data source, the change does not take effect until the next successful <b>db2_pconnect()</b> for the connection handle. </p><blockquote><p><b class='note'>Nota</b>: The php.ini setting <i><tt class='parameter'>ibm_db2.i5_allow_commit</tt></i> ==0 or <i>DB2_I5_TXN_NO_COMMIT</i> is the default, but may be overridden with the <i><tt class='parameter'>i5_commit</tt></i> option. <br /> </p></blockquote><p> </p> <p class='para'> <i>DB2_I5_TXN_NO_COMMIT</i> - Commitment control is not used. </p> <p class='para'> <i>DB2_I5_TXN_READ_UNCOMMITTED</i> - Dirty reads, nonrepeatable reads, and phantoms are possible. </p> <p class='para'> <i>DB2_I5_TXN_READ_COMMITTED</i> - Dirty reads are not possible. Nonrepeatable reads, and phantoms are possible. </p> <p class='para'> <i>DB2_I5_TXN_REPEATABLE_READ</i> - Dirty reads and nonrepeatable reads are not possible. Phantoms are possible. </p> <p class='para'> <i>DB2_I5_TXN_SERIALIZABLE</i> - Transactions are serializable. Dirty reads, non-repeatable reads, and phantoms are not possible </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_query_optimize</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_FIRST_IO</i> All queries are optimized with the goal of returning the first page of output as fast as possible. This goal works well when the output is controlled by a user who is most likely to cancel the query after viewing the first page of output data. Queries coded with an OPTIMIZE FOR nnn ROWS clause honor the goal specified by the clause. </p> <p class='para'> <i>DB2_ALL_IO</i> All queries are optimized with the goal of running the entire query to completion in the shortest amount of elapsed time. This is a good option when the output of a query is being written to a file or report, or the interface is queuing the output data. Queries coded with an OPTIMIZE FOR nnn ROWS clause honor the goal specified by the clause. This is the default. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_dbcs_alloc</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_DBCS_ALLOC_ON</i> value turns on DB2 6X allocation scheme for DBCS translation column size growth. </p> <p class='para'> <i>DB2_I5_DBCS_ALLOC_OFF</i> value turns off DB2 6X allocation scheme for DBCS translation column size growth. </p><blockquote><p><b class='note'>Nota</b>: The php.ini setting <i><tt class='parameter'>ibm_db2.i5_dbcs_alloc</tt></i> ==0 or <i>DB2_I5_DBCS_ALLOC_OFF</i> is the default, but may be overridden with the <i><tt class='parameter'>i5_dbcs_alloc</tt></i> option. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_date_fmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_FMT_ISO</i> - The International Organization for Standardization (ISO) date format yyyy-mm-dd is used. This is the default. </p> <p class='para'> <i>DB2_I5_FMT_USA</i> - The United States date format mm/dd/yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_EUR</i> - The European date format dd.mm.yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_JIS</i> - The Japanese Industrial Standard date format yyyy-mm-dd is used. </p> <p class='para'> <i>DB2_I5_FMT_MDY</i> - The date format mm/dd/yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_DMY</i> - The date format dd/mm/yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_YMD</i> - The date format yy/mm/dd is used. </p> <p class='para'> <i>DB2_I5_FMT_JUL</i> - The Julian date format yy/ddd is used. </p> <p class='para'> <i>DB2_I5_FMT_JOB</i> - The job default is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_date_sep</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_SEP_SLASH</i> - A slash ( / ) is used as the date separator. This is the default. </p> <p class='para'> <i>DB2_I5_SEP_DASH</i> - A dash ( - ) is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_PERIOD</i> - A period ( . ) is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_COMMA</i> - A comma ( , ) is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_BLANK</i> - A blank is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_JOB</i> - The job default is used </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_time_fmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_FMT_ISO</i> - The International Organization for Standardization (ISO) time format hh.mm.ss is used. This is the default. </p> <p class='para'> <i>DB2_I5_FMT_USA</i> - The United States time format hh:mmxx is used, where xx is AM or PM. </p> <p class='para'> <i>DB2_I5_FMT_EUR</i> - The European time format hh.mm.ss is used. </p> <p class='para'> <i>DB2_I5_FMT_JIS</i> - The Japanese Industrial Standard time format hh:mm:ss is used. </p> <p class='para'> <i>DB2_I5_FMT_HMS</i> - The hh:mm:ss format is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_time_sep</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_SEP_COLON</i> - A colon ( : ) is used as the time separator. This is the default. </p> <p class='para'> <i>DB2_I5_SEP_PERIOD</i> - A period ( . ) is used as the time separator. </p> <p class='para'> <i>DB2_I5_SEP_COMMA</i> - A comma ( , ) is used as the time separator. </p> <p class='para'> <i>DB2_I5_SEP_BLANK</i> - A blank is used as the time separator. </p> <p class='para'> <i>DB2_I5_SEP_JOB</i> - The job default is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_decimal_sep</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_SEP_PERIOD</i> - A period ( . ) is used as the decimal separator. This is the default. </p> <p class='para'> <i>DB2_I5_SEP_COMMA</i> - A comma ( , ) is used as the decimal separator. </p> <p class='para'> <i>DB2_I5_SEP_JOB</i> - The job default is used. </p> </dd> </dl> <p> </p> <p class='para'> The following new i5/OS option is available in ibm_db2 version 1.8.0 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_libl</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A character value that indicates the library list that will be used for resolving unqualified file references. Specify the library list elements separated by blanks &amp;#039;i5_libl&amp;#039;=&amp;gt;&amp;quot;MYLIB YOURLIB ANYLIB&amp;quot;. </p><blockquote><p><b class='note'>Nota</b>: i5_libl calls qsys2/qcmdexc(&amp;#039;cmd&amp;#039;,cmdlen), which is only available in i5/OS V5R4 and later. <br /> </p></blockquote><p> </p> </dd> </dl> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.db2-pconnect.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a connection handle resource if the connection attempt is successful. <b>db2_pconnect()</b> tries to reuse an existing connection resource that exactly matches the <i><tt class='parameter'>database</tt></i> , <i><tt class='parameter'>username</tt></i> , and <i><tt class='parameter'>password</tt></i> parameters. If the connection attempt fails, <b>db2_pconnect()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-pconnect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_pconnect()</b> example</b></p> <div class='example-contents para'><p> In the following example, the first call to <b>db2_pconnect()</b> returns a new persistent connection resource. The second call to <b>db2_pconnect()</b> returns a persistent connection resource that simply reuses the first persistent connection resource. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$pconn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_pconnect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$pconn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Persistent&amp;nbsp;connection&amp;nbsp;succeeded.'</span><span style='color: #007700'>;<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Persistent&amp;nbsp;connection&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>$pconn2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_pconnect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$pconn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Second&amp;nbsp;persistent&amp;nbsp;connection&amp;nbsp;succeeded.'</span><span style='color: #007700'>;<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Second&amp;nbsp;persistent&amp;nbsp;connection&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Persistent connection succeeded. Second persistent connection succeeded. </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Using trusted context</b></p> <div class='example-contents para'><p> The following example shows how to enable trusted context, switch users, and get the current user ID. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$authID&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$auth_pass&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$tc_user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'tcuser'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$tc_pass&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'tcpassword'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$dsn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;<br />&amp;nbsp;&amp;nbsp;PROTOCOL=TCPIP;UID=</span><span style='color: #0000BB'>$authID</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$auth_pass</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array&amp;nbsp;(</span><span style='color: #DD0000'>'trustedcontext'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_TRUSTED_CONTEXT_ENABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$tc_conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_pconnect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dsn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>);<br />if(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Explicit&amp;nbsp;trusted&amp;nbsp;connection&amp;nbsp;succeeded.\n'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if(</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'trustedcontext'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$userBefore&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'trusted_user'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//Do&amp;nbsp;some&amp;nbsp;work&amp;nbsp;as&amp;nbsp;user&amp;nbsp;1.<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;//Switching&amp;nbsp;to&amp;nbsp;trusted&amp;nbsp;user.<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$parameters&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'trusted_user'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$tc_user</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'trusted_password'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$tcuser_pass</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$parameters</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$userAfter&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'trusted_user'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//Do&amp;nbsp;more&amp;nbsp;work&amp;nbsp;as&amp;nbsp;trusted&amp;nbsp;user.<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$userBefore&amp;nbsp;</span><span style='color: #007700'>!=&amp;nbsp;</span><span style='color: #0000BB'>$userAfter</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'User&amp;nbsp;has&amp;nbsp;been&amp;nbsp;switched.'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Explicit&amp;nbsp;trusted&amp;nbsp;connection&amp;nbsp;failed.\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Explicit trusted connection succeeded. User has been switched. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-pconnect.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_pclose" value="<div id='function.db2-pclose' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-pclose.php'>db2_pclose</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.8.0)</p><p class='refpurpose'><span class='refname'>db2_pclose</span> &amp;mdash; <span class='dc-title'>Closes a persistent database connection</span></p> </div> <a name='function.db2-pclose.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_pclose</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$resource</tt></span> )</div> <p class='para rdfs-comment'> This function closes a DB2 client connection created with <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a> and returns the corresponding resources to the database server. </p><blockquote><p><b class='note'>Nota</b>: This function is only available on i5/OS in response to i5/OS system administration requests. <br /> </p></blockquote><p> </p> <p class='para'> If you have a persistent DB2 client connection created with <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>, you may use this function to close the connection. To avoid substantial connection performance penalties, this function should only be used in rare cases when the persistent connection has become unresponsive or the persistent connection will not be needed for a long period of time. </p> </div> <a name='function.db2-pclose.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies an active DB2 client connection. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-pclose.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-pclose.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Closing a persistent connection</b></p> <div class='example-contents para'><p> The following example demonstrates a successful attempt to close a connection to an IBM DB2 i5/OS database. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_pconnect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_pclose</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$rc</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;was&amp;nbsp;successfully&amp;nbsp;closed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Connection was successfully closed. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-pclose.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-close.php' class='function' rel='rdfs-seeAlso'>db2_close()</a> - Closes a database connection</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function' rel='rdfs-seeAlso'>db2_pconnect()</a> - Returns a persistent connection to a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_num_rows" value="<div id='function.db2-num-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-num-rows.php'>db2_num_rows</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_num_rows</span> &amp;mdash; <span class='dc-title'> Returns the number of rows affected by an SQL statement </span></p> </div> <a name='function.db2-num-rows.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_num_rows</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of rows deleted, inserted, or updated by an SQL statement. </p> <p class='para'> To determine the number of rows that will be returned by a SELECT statement, issue SELECT COUNT(*) with the same predicates as your intended SELECT statement and retrieve the value. </p> <p class='para'> If your application logic checks the number of rows returned by a SELECT statement and branches if the number of rows is 0, consider modifying your application to attempt to return the first row with one of <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function'>db2_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function'>db2_fetch_both()</a>, <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function'>db2_fetch_array()</a>, or <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function'>db2_fetch_row()</a>, and branch if the fetch function returns <b><tt class='constant'>FALSE</tt></b>. </p> <blockquote><p><b class='note'>Nota</b>: If you issue a SELECT statement using a scrollable cursor, <b>db2_num_rows()</b> returns the number of rows returned by the SELECT statement. However, the overhead associated with scrollable cursors significantly degrades the performance of your application, so if this is the only reason you are considering using scrollable cursors, you should use a forward-only cursor and either call SELECT COUNT(*) or rely on the <a href='http://www.php.net/manual/pt_BR/language.types.boolean.php' class='type boolean'>boolean</a> return value of the fetch functions to achieve the equivalent functionality with much better performance. <br /> </p></blockquote> </div> <a name='function.db2-num-rows.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource containing a result set. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-num-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the number of rows affected by the last SQL statement issued by the specified statement handle. </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_num_fields" value="<div id='function.db2-num-fields' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-num-fields.php'>db2_num_fields</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_num_fields</span> &amp;mdash; <span class='dc-title'> Returns the number of fields contained in a result set </span></p> </div> <a name='function.db2-num-fields.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_num_fields</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of fields contained in a result set. This is most useful for handling the result sets returned by dynamically generated queries, or for result sets returned by stored procedures, where your application cannot otherwise know how to retrieve and use the results. </p> </div> <a name='function.db2-num-fields.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource containing a result set. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-num-fields.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer value representing the number of fields in the result set associated with the specified statement resource. Returns <b><tt class='constant'>FALSE</tt></b> if the statement resource is not a valid input value. </p> </div> <a name='function.db2-num-fields.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retrieving the number of fields in a result set</b></p> <div class='example-contents para'><p> The following example demonstrates how to retrieve the number of fields returned in a result set. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$columns&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_num_fields</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'There&amp;nbsp;are&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$columns</span><span style='color: #007700'>}</span><span style='color: #DD0000'>&amp;nbsp;columns&amp;nbsp;in&amp;nbsp;the&amp;nbsp;result&amp;nbsp;set.'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> There are 4 columns in the result set. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-num-fields.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function' rel='rdfs-seeAlso'>db2_execute()</a> - Executes a prepared SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_next_result" value="<div id='function.db2-next-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-next-result.php'>db2_next_result</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_next_result</span> &amp;mdash; <span class='dc-title'> Requests the next result set from a stored procedure </span></p> </div> <a name='function.db2-next-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_next_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> A stored procedure can return zero or more result sets. While you handle the first result set in exactly the same way you would handle the results returned by a simple SELECT statement, to fetch the second and subsequent result sets from a stored procedure you must call the <b>db2_next_result()</b> function and return the result to a uniquely named PHP variable. </p> </div> <a name='function.db2-next-result.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A prepared statement returned from <a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function'>db2_exec()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-next-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a new statement resource containing the next result set if the stored procedure returned another result set. Returns <b><tt class='constant'>FALSE</tt></b> if the stored procedure did not return another result set. </p> </div> <a name='function.db2-next-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Calling a stored procedure that returns multiple result sets</b></p> <div class='example-contents para'><p> In the following example, we call a stored procedure that returns three result sets. The first result set is fetched directly from the same statement resource on which we invoked the CALL statement, while the second and third result sets are fetched from statement resources returned from our calls to the <b>db2_next_result()</b> function. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CALL&amp;nbsp;multiResults()'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Fetching&amp;nbsp;first&amp;nbsp;result&amp;nbsp;set\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'\nFetching&amp;nbsp;second&amp;nbsp;result&amp;nbsp;set\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'\nFetching&amp;nbsp;third&amp;nbsp;result&amp;nbsp;set\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$res2</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res2</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Fetching first result set array(2) { [0]=&amp;gt; string(16) &amp;quot;Bubbles &amp;quot; [1]=&amp;gt; int(3) } array(2) { [0]=&amp;gt; string(16) &amp;quot;Gizmo &amp;quot; [1]=&amp;gt; int(4) } Fetching second result set array(4) { [0]=&amp;gt; string(16) &amp;quot;Sweater &amp;quot; [1]=&amp;gt; int(6) [2]=&amp;gt; string(5) &amp;quot;llama&amp;quot; [3]=&amp;gt; string(6) &amp;quot;150.00&amp;quot; } array(4) { [0]=&amp;gt; string(16) &amp;quot;Smarty &amp;quot; [1]=&amp;gt; int(2) [2]=&amp;gt; string(5) &amp;quot;horse&amp;quot; [3]=&amp;gt; string(6) &amp;quot;350.00&amp;quot; } Fetching third result set array(1) { [0]=&amp;gt; string(16) &amp;quot;Bubbles &amp;quot; } array(1) { [0]=&amp;gt; string(16) &amp;quot;Gizmo &amp;quot; } </pre></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_lob_read" value="<div id='function.db2-lob-read' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-lob-read.php'>db2_lob_read</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.6.0)</p><p class='refpurpose'><span class='refname'>db2_lob_read</span> &amp;mdash; <span class='dc-title'> Gets a user defined size of LOB files with each invocation </span></p> </div> <a name='function.db2-lob-read.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_lob_read</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$colnum</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$length</tt></span> )</div> <p class='para rdfs-comment'> Use <b>db2_lob_read()</b> to iterate through a specified column of a result set and retrieve a user defined size of LOB data. </p> </div> <a name='function.db2-lob-read.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource containing LOB data. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>colnum</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid column number in the result set of the <i>stmt</i> resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>length</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The size of the LOB data to be retrieved from the <i>stmt</i> resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-lob-read.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the amount of data the user specifies. Returns <b><tt class='constant'>FALSE</tt></b> if the data cannot be retrieved. </p> </div> <a name='function.db2-lob-read.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Iterating through different types of data</b></p> <div class='example-contents para'><p> </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$username&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,</span><span style='color: #0000BB'>$username</span><span style='color: #007700'>,</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$drop&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;clob_stream'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$drop&amp;nbsp;</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$create&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;clob_stream&amp;nbsp;(id&amp;nbsp;INTEGER,&amp;nbsp;my_clob&amp;nbsp;CLOB)'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$create&amp;nbsp;</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$variable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;clob_stream&amp;nbsp;(id,my_clob)&amp;nbsp;VALUES&amp;nbsp;(1,&amp;nbsp;?)'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$variable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'THIS&amp;nbsp;IS&amp;nbsp;A&amp;nbsp;CLOB&amp;nbsp;TEST.&amp;nbsp;THIS&amp;nbsp;IS&amp;nbsp;A&amp;nbsp;CLOB&amp;nbsp;TEST.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'variable'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,my_clob&amp;nbsp;FROM&amp;nbsp;clob_stream'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Read&amp;nbsp;LOB&amp;nbsp;data&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_lob_read</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>6</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Loop&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #DD0000'>:&amp;nbsp;</span><span style='color: #0000BB'>$data</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$drop&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;blob_stream'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$drop&amp;nbsp;</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$create&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;blob_stream&amp;nbsp;(id&amp;nbsp;INTEGER,&amp;nbsp;my_blob&amp;nbsp;CLOB)'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$create&amp;nbsp;</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$variable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;blob_stream&amp;nbsp;(id,my_blob)&amp;nbsp;VALUES&amp;nbsp;(1,&amp;nbsp;?)'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$variable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'THIS&amp;nbsp;IS&amp;nbsp;A&amp;nbsp;BLOB&amp;nbsp;TEST.&amp;nbsp;THIS&amp;nbsp;IS&amp;nbsp;A&amp;nbsp;BLOB&amp;nbsp;TEST.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'variable'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,my_blob&amp;nbsp;FROM&amp;nbsp;blob_stream'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Read&amp;nbsp;LOB&amp;nbsp;data&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_lob_read</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>6</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Loop&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #DD0000'>:&amp;nbsp;</span><span style='color: #0000BB'>$data</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'no&amp;nbsp;connection:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>db2_conn_errormsg</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Loop 0: THIS I Loop 1: S A CL Loop 2: OB TES Loop 3: T. THI Loop 4: S IS A Loop 5: CLOB Loop 6: TEST. Loop 0: THIS I Loop 1: S A BL Loop 2: OB TES Loop 3: T. THI Loop 4: S IS A Loop 5: BLOB Loop 6: TEST. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-lob-read.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-bind-param.php' class='function' rel='rdfs-seeAlso'>db2_bind_param()</a> - Binds a PHP variable to an SQL statement parameter</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function' rel='rdfs-seeAlso'>db2_exec()</a> - Executes an SQL statement directly</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function' rel='rdfs-seeAlso'>db2_execute()</a> - Executes a prepared SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_last_insert_id" value="<div id='function.db2-last-insert-id' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-last-insert-id.php'>db2_last_insert_id</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.7.1)</p><p class='refpurpose'><span class='refname'>db2_last_insert_id</span> &amp;mdash; <span class='dc-title'>Returns the auto generated ID of the last insert query that successfully executed on this connection</span></p> </div> <a name='function.db2-last-insert-id.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_last_insert_id</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$resource</tt></span> )</div> <p class='para rdfs-comment'> Returns the auto generated ID of the last insert query that successfully executed on this connection. </p> <p class='para'> The result of this function is not affected by any of the following: </p><ul class='itemizedlist'> <li class='listitem'> <p class='para'> A single row INSERT statement with a VALUES clause for a table without an identity column. </p> </li> <li class='listitem'> <p class='para'> A multiple row INSERT statement with a VALUES clause. </p> </li> <li class='listitem'> <p class='para'> An INSERT statement with a fullselect. </p> </li> <li class='listitem'> <p class='para'> A ROLLBACK TO SAVEPOINT statement. </p> </li> </ul><p> </p> </div> <a name='function.db2-last-insert-id.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>resource</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection resource as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. The value of this parameter cannot be a statement resource or result set resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-last-insert-id.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the auto generated ID of last insert query that successfully executed on this connection. </p> </div> <a name='function.db2-last-insert-id.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_last_insert_id()</b> example</b></p> <div class='example-contents para'><p> The following example shows how to return the auto generated ID of last insert query that successfully executed on this connection. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br />if(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$createTable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;lastInsertID&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;(id&amp;nbsp;integer&amp;nbsp;GENERATED&amp;nbsp;BY&amp;nbsp;DEFAULT&amp;nbsp;AS&amp;nbsp;IDENTITY,&amp;nbsp;name&amp;nbsp;varchar(20))'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$insertTable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;lastInsertID&amp;nbsp;(name)&amp;nbsp;VALUES&amp;nbsp;('Temp&amp;nbsp;Name')'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$createTable</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Checking&amp;nbsp;for&amp;nbsp;single&amp;nbsp;row&amp;nbsp;inserted.&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$insertTable</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$ret&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_last_insert_id</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if(</span><span style='color: #0000BB'>$ret</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Last&amp;nbsp;Insert&amp;nbsp;ID&amp;nbsp;is&amp;nbsp;:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$ret&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'No&amp;nbsp;Last&amp;nbsp;insert&amp;nbsp;ID.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Last Insert ID is : 1 </pre></div> </div> </div><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_get_option" value="<div id='function.db2-get-option' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-get-option.php'>db2_get_option</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.6.0)</p><p class='refpurpose'><span class='refname'>db2_get_option</span> &amp;mdash; <span class='dc-title'>Retrieves an option value for a statement resource or a connection resource</span></p> </div> <a name='function.db2-get-option.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_get_option</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$resource</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt></span> )</div> <p class='para rdfs-comment'> Retrieves the value of a specified option value for a statement resource or a connection resource. </p> </div> <a name='function.db2-get-option.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>resource</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> or a valid connection resource as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement or connection options. The following new options are available as of ibm_db2 version 1.6.0. They provide useful tracking information that can be set during execution with <b>db2_get_option()</b>. </p><blockquote><p><b class='note'>Nota</b>: Prior versions of ibm_db2 do not support these new options. <br /> When the value in each option is being set, some servers might not handle the entire length provided and might truncate the value. <br /> To ensure that the data specified in each option is converted correctly when transmitted to a host system, use only the characters A through Z, 0 through 9, and the underscore (_) or period (.). <br /> </p></blockquote><p> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>userid</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_USERID</i> - A pointer to a null-terminated character string used to identify the client user ID sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 16 characters. This user-id is not to be confused with the authentication user-id, it is for identification purposes only and is not used for any authorization. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>acctstr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_ACCTSTR</i> - A pointer to a null-terminated character string used to identify the client accounting string sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 200 characters. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>applname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_APPLNAME</i> - A pointer to a null-terminated character string used to identify the client application name sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 32 characters. <br /> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>wrkstnname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>SQL_ATTR_INFO_WRKSTNNAME</i> - A pointer to a null-terminated character string used to identify the client workstation name sent to the host database server when using DB2 Connect. </p><blockquote><p><b class='note'>Nota</b>: DB2 for z/OS and OS/390 servers support up to a length of 18 characters. <br /> </p></blockquote><p> </p> </dd> </dl> <p> </p> </dd> </dl> <p> </p> <p class='para'> The following table specifies which options are compatible with the available resource types: </p><table class='doctable table'> <caption><b>Resource-Parameter Matrix</b></caption> <col align='center' /> <col align='center' /> <col align='center' /> <col align='center' /> <col align='center' /> <thead valign='middle'> <tr valign='middle'> <th>Key</th> <th>Value</th> <th colspan='3'>Resource Type</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td class='empty'>&amp;nbsp;</td><td class='empty'>&amp;nbsp;</td><td align='center'>Connection</td> <td align='center'>Statement</td> <td align='center'>Result Set</td> </tr> <tr valign='middle'> <td align='left'>userid</td> <td align='left'><i>SQL_ATTR_INFO_USERID</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>acctstr</td> <td align='left'><i>SQL_ATTR_INFO_ACCTSTR</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>applname</td> <td align='left'><i>SQL_ATTR_INFO_APPLNAME</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> <tr valign='middle'> <td align='left'>wrkstnname</td> <td align='left'><i>SQL_ATTR_INFO_WRKSTNNAME</i></td> <td align='center'>X</td> <td align='center'>X</td> <td align='center'>-</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-get-option.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the current setting of the connection attribute provided on success or <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.db2-get-option.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Setting and retrieving parameters through a connection resource</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Database&amp;nbsp;Connection&amp;nbsp;Parameters&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$user&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Obtain&amp;nbsp;Connection&amp;nbsp;Resource&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Client&amp;nbsp;attributes&amp;nbsp;passed&amp;nbsp;through&amp;nbsp;connection&amp;nbsp;string:\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br />/*&amp;nbsp;Assign&amp;nbsp;the&amp;nbsp;attributes&amp;nbsp;through&amp;nbsp;connection&amp;nbsp;string&amp;nbsp;*/<br />/*&amp;nbsp;Access&amp;nbsp;the&amp;nbsp;options&amp;nbsp;specified&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'userid'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'userid'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$options2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'acctstr'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'account'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options2</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'acctstr'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$options3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'applname'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'myapp'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options3</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn3</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'applname'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$options4&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'wrkstnname'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'workstation'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn4&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options4</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'wrkstnname'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Client&amp;nbsp;attributes&amp;nbsp;passed&amp;nbsp;post-connection:\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;associative&amp;nbsp;options&amp;nbsp;array&amp;nbsp;with&amp;nbsp;valid&amp;nbsp;key-value&amp;nbsp;pairs&amp;nbsp;*/<br />/*&amp;nbsp;Assign&amp;nbsp;the&amp;nbsp;attributes&amp;nbsp;after&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;is&amp;nbsp;made&amp;nbsp;*/<br />/*&amp;nbsp;Access&amp;nbsp;the&amp;nbsp;options&amp;nbsp;specified&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$options5&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'userid'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn5&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'userid'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$options6&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'acctstr'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'account'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn6&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'acctstr'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$options7&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'applname'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'myapp'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn7&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn7</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options7</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn7</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'applname'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$options8&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'wrkstnname'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'workstation'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn8&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn8</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options8</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn8</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'wrkstnname'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Client attributes passed through connection string: db2inst1 account myapp workstation Client attributes passed post-connection: db2inst1 account myapp workstation</pre></div> </div> </div><p> </p> </div> <a name='function.db2-get-option.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-cursor-type.php' class='function' rel='rdfs-seeAlso'>db2_cursor_type()</a> - Returns the cursor type used by a statement resource</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function' rel='rdfs-seeAlso'>db2_exec()</a> - Executes an SQL statement directly</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-set-option.php' class='function' rel='rdfs-seeAlso'>db2_set_option()</a> - Set options for connection or statement resources</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function' rel='rdfs-seeAlso'>db2_pconnect()</a> - Returns a persistent connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_free_stmt" value="<div id='function.db2-free-stmt' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-free-stmt.php'>db2_free_stmt</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_free_stmt</span> &amp;mdash; <span class='dc-title'> Frees resources associated with the indicated statement resource </span></p> </div> <a name='function.db2-free-stmt.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_free_stmt</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Frees the system and database resources that are associated with a statement resource. These resources are freed implicitly when a script finishes, but you can call <b>db2_free_stmt()</b> to explicitly free the statement resources before the end of the script. </p> </div> <a name='function.db2-free-stmt.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-free-stmt.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-free-stmt.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-free-result.php' class='function' rel='rdfs-seeAlso'>db2_free_result()</a> - Frees resources associated with a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_free_result" value="<div id='function.db2-free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-free-result.php'>db2_free_result</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_free_result</span> &amp;mdash; <span class='dc-title'> Frees resources associated with a result set </span></p> </div> <a name='function.db2-free-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_free_result</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Frees the system and database resources that are associated with a result set. These resources are freed implicitly when a script finishes, but you can call <b>db2_free_result()</b> to explicitly free the result set resources before the end of the script. </p> </div> <a name='function.db2-free-result.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-free-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-free-result.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-free-stmt.php' class='function' rel='rdfs-seeAlso'>db2_free_stmt()</a> - Frees resources associated with the indicated statement resource</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_foreign_keys" value="<div id='function.db2-foreign-keys' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-foreign-keys.php'>db2_foreign_keys</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_foreign_keys</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the foreign keys for a table </span></p> </div> <a name='function.db2-foreign-keys.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_foreign_keys</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-name</tt></span> )</div> <p class='para rdfs-comment'> Returns a result set listing the foreign keys for a table. </p> </div> <a name='function.db2-foreign-keys.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. If <i><tt class='parameter'>schema</tt></i> is <b><tt class='constant'>NULL</tt></b>, <b>db2_foreign_keys()</b> matches the schema for the current connection. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-foreign-keys.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the foreign keys for the specified table. The result set is composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>PKTABLE_CAT</td> <td align='left'> Name of the catalog for the table containing the primary key. The value is NULL if this table does not have catalogs. </td> </tr> <tr valign='middle'> <td align='left'>PKTABLE_SCHEM</td> <td align='left'> Name of the schema for the table containing the primary key. </td> </tr> <tr valign='middle'> <td align='left'>PKTABLE_NAME</td> <td align='left'>Name of the table containing the primary key.</td> </tr> <tr valign='middle'> <td align='left'>PKCOLUMN_NAME</td> <td align='left'>Name of the column containing the primary key.</td> </tr> <tr valign='middle'> <td align='left'>FKTABLE_CAT</td> <td align='left'> Name of the catalog for the table containing the foreign key. The value is NULL if this table does not have catalogs. </td> </tr> <tr valign='middle'> <td align='left'>FKTABLE_SCHEM</td> <td align='left'> Name of the schema for the table containing the foreign key. </td> </tr> <tr valign='middle'> <td align='left'>FKTABLE_NAME</td> <td align='left'>Name of the table containing the foreign key.</td> </tr> <tr valign='middle'> <td align='left'>FKCOLUMN_NAME</td> <td align='left'>Name of the column containing the foreign key.</td> </tr> <tr valign='middle'> <td align='left'>KEY_SEQ</td> <td align='left'>1-indexed position of the column in the key.</td> </tr> <tr valign='middle'> <td align='left'>UPDATE_RULE</td> <td align='left'> Integer value representing the action applied to the foreign key when the SQL operation is UPDATE. </td> </tr> <tr valign='middle'> <td align='left'>DELETE_RULE</td> <td align='left'> Integer value representing the action applied to the foreign key when the SQL operation is DELETE. </td> </tr> <tr valign='middle'> <td align='left'>FK_NAME</td> <td align='left'>The name of the foreign key.</td> </tr> <tr valign='middle'> <td align='left'>PK_NAME</td> <td align='left'>The name of the primary key.</td> </tr> <tr valign='middle'> <td align='left'>DEFERRABILITY</td> <td align='left'> An integer value representing whether the foreign key deferrability is SQL_INITIALLY_DEFERRED, SQL_INITIALLY_IMMEDIATE, or SQL_NOT_DEFERRABLE. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-foreign-keys.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_width" value="<div id='function.db2-field-width' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-width.php'>db2_field_width</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_width</span> &amp;mdash; <span class='dc-title'> Returns the width of the current value of the indicated column in a result set </span></p> </div> <a name='function.db2-field-width.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_field_width</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the width of the current value of the indicated column in a result set. This is the maximum width of the column for a fixed-length data type, or the actual width of the column for a variable-length data type. </p> </div> <a name='function.db2-field-width.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-width.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer containing the width of the specified character or binary data type column in a result set. If the specified column does not exist in the result set, <b>db2_field_width()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-width.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_type" value="<div id='function.db2-field-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-type.php'>db2_field_type</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_type</span> &amp;mdash; <span class='dc-title'> Returns the data type of the indicated column in a result set </span></p> </div> <a name='function.db2-field-type.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_field_type</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the data type of the indicated column in a result set. </p> </div> <a name='function.db2-field-type.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-type.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing the defined data type of the specified column. If the specified column does not exist in the result set, <b>db2_field_type()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-type.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_scale" value="<div id='function.db2-field-scale' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-scale.php'>db2_field_scale</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_scale</span> &amp;mdash; <span class='dc-title'> Returns the scale of the indicated column in a result set </span></p> </div> <a name='function.db2-field-scale.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_field_scale</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the scale of the indicated column in a result set. </p> </div> <a name='function.db2-field-scale.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-scale.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer containing the scale of the specified column. If the specified column does not exist in the result set, <b>db2_field_scale()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-scale.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_precision" value="<div id='function.db2-field-precision' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-precision.php'>db2_field_precision</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_precision</span> &amp;mdash; <span class='dc-title'> Returns the precision of the indicated column in a result set </span></p> </div> <a name='function.db2-field-precision.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_field_precision</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the precision of the indicated column in a result set. </p> </div> <a name='function.db2-field-precision.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-precision.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer containing the precision of the specified column. If the specified column does not exist in the result set, <b>db2_field_precision()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-precision.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_num" value="<div id='function.db2-field-num' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-num.php'>db2_field_num</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_num</span> &amp;mdash; <span class='dc-title'> Returns the position of the named column in a result set </span></p> </div> <a name='function.db2-field-num.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_field_num</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the position of the named column in a result set. </p> </div> <a name='function.db2-field-num.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-num.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer containing the 0-indexed position of the named column in the result set. If the specified column does not exist in the result set, <b>db2_field_num()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-num.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_name" value="<div id='function.db2-field-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-name.php'>db2_field_name</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_name</span> &amp;mdash; <span class='dc-title'> Returns the name of the column in the result set </span></p> </div> <a name='function.db2-field-name.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_field_name</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the name of the specified column in the result set. </p> </div> <a name='function.db2-field-name.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-name.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing the name of the specified column. If the specified column does not exist in the result set, <b>db2_field_name()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-name.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-display-size.php' class='function' rel='rdfs-seeAlso'>db2_field_display_size()</a> - Returns the maximum number of bytes required to display a column</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_field_display_size" value="<div id='function.db2-field-display-size' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-field-display-size.php'>db2_field_display_size</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_field_display_size</span> &amp;mdash; <span class='dc-title'> Returns the maximum number of bytes required to display a column </span></p> </div> <a name='function.db2-field-display-size.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_field_display_size</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <tt class='parameter'>$column</tt></span> )</div> <p class='para rdfs-comment'> Returns the maximum number of bytes required to display a column in a result set. </p> </div> <a name='function.db2-field-display-size.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies a statement resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the column in the result set. This can either be an integer representing the 0-indexed position of the column, or a string containing the name of the column. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-field-display-size.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer value with the maximum number of bytes required to display the specified column. If the column does not exist in the result set, <b>db2_field_display_size()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-field-display-size.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-name.php' class='function' rel='rdfs-seeAlso'>db2_field_name()</a> - Returns the name of the column in the result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-num.php' class='function' rel='rdfs-seeAlso'>db2_field_num()</a> - Returns the position of the named column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-precision.php' class='function' rel='rdfs-seeAlso'>db2_field_precision()</a> - Returns the precision of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-scale.php' class='function' rel='rdfs-seeAlso'>db2_field_scale()</a> - Returns the scale of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-type.php' class='function' rel='rdfs-seeAlso'>db2_field_type()</a> - Returns the data type of the indicated column in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-field-width.php' class='function' rel='rdfs-seeAlso'>db2_field_width()</a> - Returns the width of the current value of the indicated column in a result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_fetch_row" value="<div id='function.db2-fetch-row' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-fetch-row.php'>db2_fetch_row</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_fetch_row</span> &amp;mdash; <span class='dc-title'> Sets the result set pointer to the next row or requested row </span></p> </div> <a name='function.db2-fetch-row.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_fetch_row</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt></span> ] )</div> <p class='para rdfs-comment'> Use <b>db2_fetch_row()</b> to iterate through a result set, or to point to a specific row in a result set if you requested a scrollable cursor. </p> <p class='para'> To retrieve individual fields from the result set, call the <a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a> function. </p> <p class='para'> Rather than calling <b>db2_fetch_row()</b> and <a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a>, most applications will call one of <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function'>db2_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function'>db2_fetch_both()</a>, or <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function'>db2_fetch_array()</a> to advance the result set pointer and return a complete row as an array. </p> </div> <a name='function.db2-fetch-row.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> With scrollable cursors, you can request a specific row number in the result set. Row numbering is 1-indexed. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-fetch-row.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns <b><tt class='constant'>TRUE</tt></b> if the requested row exists in the result set. Returns <b><tt class='constant'>FALSE</tt></b> if the requested row does not exist in the result set. </p> </div> <a name='function.db2-fetch-row.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Iterating through a result set</b></p> <div class='example-contents para'><p> The following example demonstrates how to iterate through a result set with <b>db2_fetch_row()</b> and retrieve columns from the result set with <a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;name,&amp;nbsp;breed&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;WHERE&amp;nbsp;weight&amp;nbsp;&amp;lt;&amp;nbsp;?'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>10</span><span style='color: #007700'>));<br />while&amp;nbsp;(</span><span style='color: #0000BB'>db2_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$breed&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$name</span><span style='color: #DD0000'>&amp;nbsp;</span><span style='color: #0000BB'>$breed</span><span style='color: #DD0000'>'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> cat Pook gold fish Bubbles budgerigar Gizmo goat Rickety Ride </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 i5/OS recommended alternatives to db2_fetch_row/db2_result</b></p> <div class='example-contents para'><p> On i5/OS it is recommended that you use <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function'>db2_fetch_both()</a>, <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function'>db2_fetch_array()</a>, or <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function'>db2_fetch_object()</a> over <b>db2_fetch_row()</b>/<a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a>. In general <b>db2_fetch_row()</b>/<a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a> have more issues with various column types in <i>EBCIDIC</i> to <i>ASCII</i> translation, including possible truncation in <i>DBCS</i> applications. You may also find the performance of <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function'>db2_fetch_both()</a>, <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function'>db2_fetch_array()</a>, and <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function'>db2_fetch_object()</a> to be superior to <b>db2_fetch_row()</b>/<a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;SPECIFIC_SCHEMA,&amp;nbsp;SPECIFIC_NAME,&amp;nbsp;ROUTINE_SCHEMA,&amp;nbsp;ROUTINE_NAME,&amp;nbsp;ROUTINE_TYPE,&amp;nbsp;ROUTINE_CREATED,&amp;nbsp;ROUTINE_BODY,&amp;nbsp;IN_PARMS,&amp;nbsp;OUT_PARMS,&amp;nbsp;INOUT_PARMS,&amp;nbsp;PARAMETER_STYLE,&amp;nbsp;EXTERNAL_NAME,&amp;nbsp;EXTERNAL_LANGUAGE&amp;nbsp;FROM&amp;nbsp;QSYS2.SYSROUTINES&amp;nbsp;FETCH&amp;nbsp;FIRST&amp;nbsp;2&amp;nbsp;ROWS&amp;nbsp;ONLY'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_both</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;gt;db2_fetch_both&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'SPECIFIC_NAME'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'ROUTINE_CREATED'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>5</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;gt;db2_fetch_array&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>5</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;gt;db2_fetch_object&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>SPECIFIC_NAME</span><span style='color: #007700'>}</span><span style='color: #DD0000'>&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>ROUTINE_CREATED</span><span style='color: #007700'>}</span><span style='color: #DD0000'>'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> db2_fetch_both MATCH_ANIMAL 2006-08-25-17.10.23.775000 2006-08-25-17.10.23.775000 db2_fetch_both MULTIRESULTS 2006-10-17-10.11.05.308000 2006-10-17-10.11.05.308000 db2_fetch_array MATCH_ANIMAL 2006-08-25-17.10.23.775000 db2_fetch_array MULTIRESULTS 2006-10-17-10.11.05.308000 db2_fetch_object MATCH_ANIMAL 2006-08-25-17.10.23.775000 db2_fetch_object MULTIRESULTS 2006-10-17-10.11.05.308000 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-fetch-row.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function' rel='rdfs-seeAlso'>db2_fetch_array()</a> - Returns an array, indexed by column position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>db2_fetch_assoc()</a> - Returns an array, indexed by column name, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function' rel='rdfs-seeAlso'>db2_fetch_both()</a> - Returns an array, indexed by both column name and position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function' rel='rdfs-seeAlso'>db2_fetch_object()</a> - Returns an object with properties representing columns in the fetched row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_fetch_object" value="<div id='function.db2-fetch-object' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-fetch-object.php'>db2_fetch_object</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_fetch_object</span> &amp;mdash; <span class='dc-title'> Returns an object with properties representing columns in the fetched row </span></p> </div> <a name='function.db2-fetch-object.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>db2_fetch_object</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt><span class='initializer'> = -1</span></span> ] )</div> <p class='para rdfs-comment'> Returns an object in which each property represents a column returned in the row fetched from a result set. </p> </div> <a name='function.db2-fetch-object.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Requests a specific 1-indexed row from the result set. Passing this parameter results in a PHP warning if the result set uses a forward-only cursor. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-fetch-object.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an object representing a single row in the result set. The properties of the object map to the names of the columns in the result set. </p> <p class='para'> The IBM DB2, Cloudscape, and Apache Derby database servers typically fold column names to upper-case, so the object properties will reflect that case. </p> <p class='para'> If your SELECT statement calls a scalar function to modify the value of a column, the database servers return the column number as the name of the column in the result set. If you prefer a more descriptive column name and object property, you can use the AS clause to assign a name to the column in the result set. </p> <p class='para'> Returns <b><tt class='constant'>FALSE</tt></b> if no row was retrieved. </p> </div> <a name='function.db2-fetch-object.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_fetch_object()</b> example</b></p> <div class='example-contents para'><p> The following example issues a SELECT statement with a scalar function, RTRIM, that removes whitespace from the end of the column. Rather than creating an object with the properties &amp;quot;BREED&amp;quot; and &amp;quot;2&amp;quot;, we use the AS clause in the SELECT statement to assign the name &amp;quot;name&amp;quot; to the modified column. The database server folds the column names to upper-case, resulting in an object with the properties &amp;quot;BREED&amp;quot; and &amp;quot;NAME&amp;quot;. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;breed,&amp;nbsp;RTRIM(name)&amp;nbsp;AS&amp;nbsp;name<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;FROM&amp;nbsp;animals<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;?'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>));<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$pet&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Come&amp;nbsp;here,&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$pet</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>NAME</span><span style='color: #007700'>}</span><span style='color: #DD0000'>,&amp;nbsp;my&amp;nbsp;little&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$pet</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>BREED</span><span style='color: #007700'>}</span><span style='color: #DD0000'>!'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Come here, Pook, my little cat! </pre></div> </div> </div><p> </p> </div> <a name='function.db2-fetch-object.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function' rel='rdfs-seeAlso'>db2_fetch_array()</a> - Returns an array, indexed by column position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>db2_fetch_assoc()</a> - Returns an array, indexed by column name, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function' rel='rdfs-seeAlso'>db2_fetch_both()</a> - Returns an array, indexed by both column name and position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_fetch_both" value="<div id='function.db2-fetch-both' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-fetch-both.php'>db2_fetch_both</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_fetch_both</span> &amp;mdash; <span class='dc-title'> Returns an array, indexed by both column name and position, representing a row in a result set </span></p> </div> <a name='function.db2-fetch-both.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>db2_fetch_both</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt><span class='initializer'> = -1</span></span> ] )</div> <p class='para rdfs-comment'> Returns an array, indexed by both column name and position, representing a row in a result set. Note that the row returned by <b>db2_fetch_both()</b> requires more memory than the single-indexed arrays returned by <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function'>db2_fetch_assoc()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function'>db2_fetch_array()</a>. </p> </div> <a name='function.db2-fetch-both.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Requests a specific 1-indexed row from the result set. Passing this parameter results in a PHP warning if the result set uses a forward-only cursor. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-fetch-both.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an associative array with column values indexed by both the column name and 0-indexed column number. The array represents the next or requested row in the result set. Returns <b><tt class='constant'>FALSE</tt></b> if there are no rows left in the result set, or if the row requested by <i><tt class='parameter'>row_number</tt></i> does not exist in the result set. </p> </div> <a name='function.db2-fetch-both.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Iterating through a forward-only cursor</b></p> <div class='example-contents para'><p> If you call <b>db2_fetch_both()</b> without a specific row number, it automatically retrieves the next row in the result set. The following example accesses columns in the returned array by both column name and by numeric index. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_both</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%-5d&amp;nbsp;%-16s&amp;nbsp;%-32s&amp;nbsp;%10s\n'</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'ID'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'BREED'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>3</span><span style='color: #007700'>]);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 Pook cat 3.20 5 Rickety Ride goat 9.70 2 Smarty horse 350.00 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Retrieving specific rows with <b>db2_fetch_both()</b> from a scrollable cursor</b></p> <div class='example-contents para'><p> If your result set uses a scrollable cursor, you can call <b>db2_fetch_both()</b> with a specific row number. The following example retrieves every other row in the result set, starting with the second row. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>$i</span><span style='color: #007700'>=</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_both</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%-5d&amp;nbsp;%-16s&amp;nbsp;%-32s&amp;nbsp;%10s\n'</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'NAME'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'WEIGHT'</span><span style='color: #007700'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 Pook cat 3.20 5 Rickety Ride goat 9.70 2 Smarty horse 350.00 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-fetch-both.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function' rel='rdfs-seeAlso'>db2_fetch_array()</a> - Returns an array, indexed by column position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>db2_fetch_assoc()</a> - Returns an array, indexed by column name, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function' rel='rdfs-seeAlso'>db2_fetch_object()</a> - Returns an object with properties representing columns in the fetched row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_fetch_assoc" value="<div id='function.db2-fetch-assoc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-fetch-assoc.php'>db2_fetch_assoc</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_fetch_assoc</span> &amp;mdash; <span class='dc-title'> Returns an array, indexed by column name, representing a row in a result set </span></p> </div> <a name='function.db2-fetch-assoc.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>db2_fetch_assoc</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt><span class='initializer'> = -1</span></span> ] )</div> <p class='para rdfs-comment'> Returns an array, indexed by column name, representing a row in a result set. </p> </div> <a name='function.db2-fetch-assoc.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Requests a specific 1-indexed row from the result set. Passing this parameter results in a PHP warning if the result set uses a forward-only cursor. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-fetch-assoc.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an associative array with column values indexed by the column name representing the next or requested row in the result set. Returns <b><tt class='constant'>FALSE</tt></b> if there are no rows left in the result set, or if the row requested by <i><tt class='parameter'>row_number</tt></i> does not exist in the result set. </p> </div> <a name='function.db2-fetch-assoc.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Iterating through a forward-only cursor</b></p> <div class='example-contents para'><p> If you call <b>db2_fetch_assoc()</b> without a specific row number, it automatically retrieves the next row in the result set. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%-5d&amp;nbsp;%-16s&amp;nbsp;%-32s&amp;nbsp;%10s\n'</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'ID'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'NAME'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'BREED'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'WEIGHT'</span><span style='color: #007700'>]);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 Pook cat 3.20 5 Rickety Ride goat 9.70 2 Smarty horse 350.00 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Retrieving specific rows with <b>db2_fetch_assoc()</b> from a scrollable cursor</b></p> <div class='example-contents para'><p> If your result set uses a scrollable cursor, you can call <b>db2_fetch_assoc()</b> with a specific row number. The following example retrieves every other row in the result set, starting with the second row. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>$i</span><span style='color: #007700'>=</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%-5d&amp;nbsp;%-16s&amp;nbsp;%-32s&amp;nbsp;%10s\n'</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'ID'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'NAME'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'BREED'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'WEIGHT'</span><span style='color: #007700'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 Pook cat 3.20 5 Rickety Ride goat 9.70 2 Smarty horse 350.00 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-fetch-assoc.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function' rel='rdfs-seeAlso'>db2_fetch_array()</a> - Returns an array, indexed by column position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function' rel='rdfs-seeAlso'>db2_fetch_both()</a> - Returns an array, indexed by both column name and position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function' rel='rdfs-seeAlso'>db2_fetch_object()</a> - Returns an object with properties representing columns in the fetched row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_fetch_array" value="<div id='function.db2-fetch-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-fetch-array.php'>db2_fetch_array</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.1)</p><p class='refpurpose'><span class='refname'>db2_fetch_array</span> &amp;mdash; <span class='dc-title'> Returns an array, indexed by column position, representing a row in a result set </span></p> </div> <a name='function.db2-fetch-array.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>db2_fetch_array</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$row_number</tt><span class='initializer'> = -1</span></span> ] )</div> <p class='para rdfs-comment'> Returns an array, indexed by column position, representing a row in a result set. The columns are 0-indexed. </p> </div> <a name='function.db2-fetch-array.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid <i>stmt</i> resource containing a result set. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Requests a specific 1-indexed row from the result set. Passing this parameter results in a PHP warning if the result set uses a forward-only cursor. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-fetch-array.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a 0-indexed array with column values indexed by the column position representing the next or requested row in the result set. Returns <b><tt class='constant'>FALSE</tt></b> if there are no rows left in the result set, or if the row requested by <i><tt class='parameter'>row_number</tt></i> does not exist in the result set. </p> </div> <a name='function.db2-fetch-array.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Iterating through a forward-only cursor</b></p> <div class='example-contents para'><p> If you call <b>db2_fetch_array()</b> without a specific row number, it automatically retrieves the next row in the result set. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%-5d&amp;nbsp;%-16s&amp;nbsp;%-32s&amp;nbsp;%10s\n'</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>3</span><span style='color: #007700'>]);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 Pook cat 3.20 5 Rickety Ride goat 9.70 2 Smarty horse 350.00 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Retrieving specific rows with <b>db2_fetch_array()</b> from a scrollable cursor</b></p> <div class='example-contents para'><p> If your result set uses a scrollable cursor, you can call <b>db2_fetch_array()</b> with a specific row number. The following example retrieves every other row in the result set, starting with the second row. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;breed'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>$i</span><span style='color: #007700'>=</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br />while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%-5d&amp;nbsp;%-16s&amp;nbsp;%-32s&amp;nbsp;%10s\n'</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>3</span><span style='color: #007700'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 Pook cat 3.20 5 Rickety Ride goat 9.70 2 Smarty horse 350.00 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-fetch-array.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>db2_fetch_assoc()</a> - Returns an array, indexed by column name, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function' rel='rdfs-seeAlso'>db2_fetch_both()</a> - Returns an array, indexed by both column name and position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-object.php' class='function' rel='rdfs-seeAlso'>db2_fetch_object()</a> - Returns an object with properties representing columns in the fetched row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_execute" value="<div id='function.db2-execute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-execute.php'>db2_execute</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_execute</span> &amp;mdash; <span class='dc-title'> Executes a prepared SQL statement </span></p> </div> <a name='function.db2-execute.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_execute</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$parameters</tt></span> ] )</div> <p class='para rdfs-comment'> <b>db2_execute()</b> executes an SQL statement that was prepared by <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a>. </p> <p class='para'> If the SQL statement returns a result set, for example, a SELECT statement or a CALL to a stored procedure that returns one or more result sets, you can retrieve a row as an array from the <i>stmt</i> resource using <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function'>db2_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function'>db2_fetch_both()</a>, or <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function'>db2_fetch_array()</a>. Alternatively, you can use <a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function'>db2_fetch_row()</a> to move the result set pointer to the next row and fetch a column at a time from that row with <a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function'>db2_result()</a>. </p> <p class='para'> Refer to <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> for a brief discussion of the advantages of using <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> and <b>db2_execute()</b> rather than <a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function'>db2_exec()</a>. </p> </div> <a name='function.db2-execute.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A prepared statement returned from <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>parameters</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of input parameters matching any parameter markers contained in the prepared statement. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-execute.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-execute.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Preparing and executing an SQL statement with parameter markers</b></p> <div class='example-contents para'><p> The following example prepares an INSERT statement that accepts four parameter markers, then iterates over an array of arrays containing the input values to be passed to <b>db2_execute()</b>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$pet&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cat'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Pook'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3.2</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$insert&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;animals&amp;nbsp;(id,&amp;nbsp;breed,&amp;nbsp;name,&amp;nbsp;weight)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;VALUES&amp;nbsp;(?,&amp;nbsp;?,&amp;nbsp;?,&amp;nbsp;?)'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$insert</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$pet</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Successfully&amp;nbsp;added&amp;nbsp;new&amp;nbsp;pet.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Successfully added new pet. </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Calling a stored procedure with an OUT parameter</b></p> <div class='example-contents para'><p> The following example prepares a CALL statement that accepts one parameter marker representing an OUT parameter, binds the PHP variable <i>$my_pets</i> to the parameter using <a href='http://www.php.net/manual/pt_BR/function.db2-bind-param.php' class='function'>db2_bind_param()</a>, then issues <b>db2_execute()</b> to execute the CALL statement. After the CALL to the stored procedure has been made, the value of <i>$num_pets</i> changes to reflect the value returned by the stored procedure for that OUT parameter. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$num_pets&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CALL&amp;nbsp;count_my_pets(?)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'num_pets'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_OUT</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$res</span><span style='color: #007700'>);<br />print&amp;nbsp;</span><span style='color: #DD0000'>'I&amp;nbsp;have&amp;nbsp;</span><span style='color: #0000BB'>$num_pets</span><span style='color: #DD0000'>&amp;nbsp;pets!'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> I have 7 pets! </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #3 Returning XML data as a SQL ResultSet</b></p> <div class='example-contents para'><p> The following example demonstrates how to work with documents stored in a XML column using the SAMPLE database. Using some pretty simple SQL/XML, this example returns some of the nodes in a XML document in a SQL ResultSet format that most users are familiar with. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;XMLTABLE(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;XMLNAMESPACES&amp;nbsp;(DEFAULT&amp;nbsp;\'http://posample.org\'),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;\'db2-fn:xmlcolumn('CUSTOMER.INFO')/customerinfo\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;COLUMNS<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'CID'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'@Cid\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'NAME'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'name\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'PHONE'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'phone&amp;nbsp;[&amp;nbsp;@type&amp;nbsp;=&amp;nbsp;'work']\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;)&amp;nbsp;AS&amp;nbsp;T<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;NAME&amp;nbsp;=&amp;nbsp;?<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Kathy&amp;nbsp;Smith'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'name'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CID</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>NAME</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PHONE</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 1000 Kathy Smith 416-555-1358 1001 Kathy Smith 905-555-7258 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #4 Performing a &amp;quot;JOIN&amp;quot; with XML data</b></p> <div class='example-contents para'><p> The following example works with documents stored in 2 different XML columns in the SAMPLE database. It creates 2 temporary tables from the XML documents from 2 different columns and returns a SQL ResultSet with information regarding shipping status for the customer. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'<br />SELECT&amp;nbsp;A.CID,&amp;nbsp;A.NAME,&amp;nbsp;A.PHONE,&amp;nbsp;C.PONUM,&amp;nbsp;C.STATUS<br />FROM<br />XMLTABLE(<br />XMLNAMESPACES&amp;nbsp;(DEFAULT&amp;nbsp;\'http://posample.org\'),<br />\'db2-fn:xmlcolumn('CUSTOMER.INFO')/customerinfo\'<br />COLUMNS<br />'CID'&amp;nbsp;BIGINT&amp;nbsp;PATH&amp;nbsp;\'@Cid\',<br />'NAME'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'name\',<br />'PHONE'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'phone&amp;nbsp;[&amp;nbsp;@type&amp;nbsp;=&amp;nbsp;'work']\'<br />)&amp;nbsp;as&amp;nbsp;A,<br />PURCHASEORDER&amp;nbsp;AS&amp;nbsp;B,<br />XMLTABLE&amp;nbsp;(<br />XMLNAMESPACES&amp;nbsp;(DEFAULT&amp;nbsp;\'http://posample.org\'),<br />\'db2-fn:xmlcolumn('PURCHASEORDER.PORDER')/PurchaseOrder\'<br />COLUMNS<br />'PONUM'&amp;nbsp;&amp;nbsp;BIGINT&amp;nbsp;PATH&amp;nbsp;\'@PoNum\',<br />'STATUS'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'@Status\'<br />)&amp;nbsp;as&amp;nbsp;C<br />WHERE&amp;nbsp;A.CID&amp;nbsp;=&amp;nbsp;B.CUSTID&amp;nbsp;AND<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;B.POID&amp;nbsp;=&amp;nbsp;C.PONUM&amp;nbsp;AND<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;A.NAME&amp;nbsp;=&amp;nbsp;?<br />'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Kathy&amp;nbsp;Smith'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'name'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CID</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>NAME</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PHONE</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PONUM</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>STATUS</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /><br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 1001 Kathy Smith 905-555-7258 5002 Shipped </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #5 Returning SQL data as part of a larger XML document</b></p> <div class='example-contents para'><p> The following example works with a portion of the PRODUCT.DESCRIPTION documents in the SAMPLE database. It creates a XML document containing product description (XML data) and pricing info (SQL data). </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'<br />SELECT<br />XMLSERIALIZE(<br />XMLQUERY(\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;declare&amp;nbsp;boundary-space&amp;nbsp;strip;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;declare&amp;nbsp;default&amp;nbsp;element&amp;nbsp;namespace&amp;nbsp;'http://posample.org';<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;promoList&amp;gt;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;for&amp;nbsp;$prod&amp;nbsp;in&amp;nbsp;$doc/product<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;where&amp;nbsp;$prod/description/price&amp;nbsp;&amp;lt;&amp;nbsp;10.00<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;order&amp;nbsp;by&amp;nbsp;$prod/description/price&amp;nbsp;ascending<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;promoitem&amp;gt;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$prod,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;startdate&amp;gt;&amp;nbsp;{$start}&amp;nbsp;&amp;lt;/startdate&amp;gt;,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;enddate&amp;gt;&amp;nbsp;{$end}&amp;nbsp;&amp;lt;/enddate&amp;gt;,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;promoprice&amp;gt;&amp;nbsp;{$promo}&amp;nbsp;&amp;lt;/promoprice&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;&amp;lt;/promoitem&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;&amp;lt;/promoList&amp;gt;<br />\'&amp;nbsp;passing&amp;nbsp;by&amp;nbsp;ref&amp;nbsp;DESCRIPTION&amp;nbsp;AS&amp;nbsp;'doc',<br />PROMOSTART&amp;nbsp;as&amp;nbsp;'start',<br />PROMOEND&amp;nbsp;as&amp;nbsp;'end',<br />PROMOPRICE&amp;nbsp;as&amp;nbsp;'promo'<br />RETURNING&amp;nbsp;SEQUENCE)<br />AS&amp;nbsp;CLOB&amp;nbsp;(32000))<br />AS&amp;nbsp;NEW_PRODUCT_INFO<br />FROM&amp;nbsp;PRODUCT<br />WHERE&amp;nbsp;PID&amp;nbsp;=&amp;nbsp;?<br />'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$pid&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'100-100-01'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'pid'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /><br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> &amp;lt;promoList xmlns=&amp;quot;http://posample.org&amp;quot;&amp;gt; &amp;lt;promoitem&amp;gt; &amp;lt;product pid=&amp;quot;100-100-01&amp;quot;&amp;gt; &amp;lt;description&amp;gt; &amp;lt;name&amp;gt;Snow Shovel, Basic 22 inch&amp;lt;/name&amp;gt; &amp;lt;details&amp;gt;Basic Snow Shovel, 22 inches wide, straight handle with D-Grip&amp;lt;/details&amp;gt; &amp;lt;price&amp;gt;9.99&amp;lt;/price&amp;gt; &amp;lt;weight&amp;gt;1 kg&amp;lt;/weight&amp;gt; &amp;lt;/description&amp;gt; &amp;lt;/product&amp;gt; &amp;lt;startdate&amp;gt;2004-11-19&amp;lt;/startdate&amp;gt; &amp;lt;enddate&amp;gt;2004-12-19&amp;lt;/enddate&amp;gt; &amp;lt;promoprice&amp;gt;7.25&amp;lt;/promoprice&amp;gt; &amp;lt;/promoitem&amp;gt; &amp;lt;/promoList&amp;gt; </pre></div> </div> </div><p> </p> </div> <a name='function.db2-execute.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-exec.php' class='function' rel='rdfs-seeAlso'>db2_exec()</a> - Executes an SQL statement directly</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-array.php' class='function' rel='rdfs-seeAlso'>db2_fetch_array()</a> - Returns an array, indexed by column position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>db2_fetch_assoc()</a> - Returns an array, indexed by column name, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-both.php' class='function' rel='rdfs-seeAlso'>db2_fetch_both()</a> - Returns an array, indexed by both column name and position, representing a row in a result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-fetch-row.php' class='function' rel='rdfs-seeAlso'>db2_fetch_row()</a> - Sets the result set pointer to the next row or requested row</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-result.php' class='function' rel='rdfs-seeAlso'>db2_result()</a> - Returns a single column from a row in the result set</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_exec" value="<div id='function.db2-exec' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-exec.php'>db2_exec</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_exec</span> &amp;mdash; <span class='dc-title'> Executes an SQL statement directly </span></p> </div> <a name='function.db2-exec.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_exec</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$statement</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> Executes an SQL statement directly. </p> <p class='para'> If you plan to interpolate PHP variables into the SQL statement, understand that this is one of the more common security exposures. Consider calling <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> to prepare an SQL statement with parameter markers for input values. Then you can call <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a> to pass in the input values and avoid SQL injection attacks. </p> <p class='para'> If you plan to repeatedly issue the same SQL statement with different parameters, consider calling <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a> and <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a> to enable the database server to reuse its access plan and increase the efficiency of your database access. </p> </div> <a name='function.db2-exec.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid database connection resource variable as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>statement</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An SQL statement. The statement cannot contain any parameter markers. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>options</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An associative array containing statement options. You can use this parameter to request a scrollable cursor on database servers that support this functionality. </p> <p class='para'> For a description of valid statement options, see <a href='http://www.php.net/manual/pt_BR/function.db2-set-option.php' class='function'>db2_set_option()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-exec.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource if the SQL statement was issued successfully, or <b><tt class='constant'>FALSE</tt></b> if the database failed to execute the SQL statement. </p> </div> <a name='function.db2-exec.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Creating a table with <b>db2_exec()</b></b></p> <div class='example-contents para'><p> The following example uses <b>db2_exec()</b> to issue a set of DDL statements in the process of creating a table. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;test&amp;nbsp;table<br /></span><span style='color: #0000BB'>$create&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;animals&amp;nbsp;(id&amp;nbsp;INTEGER,&amp;nbsp;breed&amp;nbsp;VARCHAR(32),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;name&amp;nbsp;CHAR(16),&amp;nbsp;weight&amp;nbsp;DECIMAL(7,2))'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$create</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Successfully&amp;nbsp;created&amp;nbsp;the&amp;nbsp;table.\n'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Populate&amp;nbsp;the&amp;nbsp;test&amp;nbsp;table<br /></span><span style='color: #0000BB'>$animals&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cat'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Pook'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3.2</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'dog'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Peaches'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12.3</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'horse'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Smarty'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>350.0</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'gold&amp;nbsp;fish'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Bubbles'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0.1</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'budgerigar'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Gizmo'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0.2</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'goat'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Rickety&amp;nbsp;Ride'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>9.7</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;array(</span><span style='color: #0000BB'>6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'llama'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Sweater'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>)<br />);<br /><br />foreach&amp;nbsp;(</span><span style='color: #0000BB'>$animals&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;animals&amp;nbsp;(id,&amp;nbsp;breed,&amp;nbsp;name,&amp;nbsp;weight)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;VALUES&amp;nbsp;(</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>,&amp;nbsp;'</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>',&amp;nbsp;'</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>',&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$animal</span><span style='color: #007700'>[</span><span style='color: #0000BB'>3</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>)'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$rc</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Insert...&amp;nbsp;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Successfully created the table. Insert... Insert... Insert... Insert... Insert... Insert... Insert... </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Executing a SELECT statement with a scrollable cursor</b></p> <div class='example-contents para'><p> The following example demonstrates how to request a scrollable cursor for an SQL statement issued by <b>db2_exec()</b>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;animals<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;weight&amp;nbsp;&amp;lt;&amp;nbsp;10.0<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;require_once(</span><span style='color: #DD0000'>'prepare.inc'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'cursor'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_SCROLLABLE</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}&amp;nbsp;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Bubbles Gizmo Pook Rickety Ride </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #3 Returning XML data as a SQL ResultSet</b></p> <div class='example-contents para'><p> The following example demonstrates how to work with documents stored in a XML column using the SAMPLE database. Using some pretty simple SQL/XML, this example returns some of the nodes in a XML document in a SQL ResultSet format that most users are familiar with. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;XMLTABLE(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;XMLNAMESPACES&amp;nbsp;(DEFAULT&amp;nbsp;\'http://posample.org\'),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;\'db2-fn:xmlcolumn('CUSTOMER.INFO')/customerinfo\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;COLUMNS<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'CID'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'@Cid\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'NAME'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'name\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'PHONE'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'phone&amp;nbsp;[&amp;nbsp;@type&amp;nbsp;=&amp;nbsp;'work']\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;)&amp;nbsp;AS&amp;nbsp;T<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;NAME&amp;nbsp;=&amp;nbsp;\'Kathy&amp;nbsp;Smith\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br />while(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CID</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>NAME</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PHONE</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 1000 Kathy Smith 416-555-1358 1001 Kathy Smith 905-555-7258 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #4 Performing a &amp;quot;JOIN&amp;quot; with XML data</b></p> <div class='example-contents para'><p> The following example works with documents stored in 2 different XML columns in the SAMPLE database. It creates 2 temporary tables from the XML documents from 2 different columns and returns a SQL ResultSet with information regarding shipping status for the customer. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;SELECT&amp;nbsp;A.CID,&amp;nbsp;A.NAME,&amp;nbsp;A.PHONE,&amp;nbsp;C.PONUM,&amp;nbsp;C.STATUS<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;FROM<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;XMLTABLE(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;XMLNAMESPACES&amp;nbsp;(DEFAULT&amp;nbsp;\'http://posample.org\'),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;\'db2-fn:xmlcolumn('CUSTOMER.INFO')/customerinfo\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;COLUMNS<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'CID'&amp;nbsp;BIGINT&amp;nbsp;PATH&amp;nbsp;\'@Cid\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'NAME'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'name\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'PHONE'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'phone&amp;nbsp;[&amp;nbsp;@type&amp;nbsp;=&amp;nbsp;'work']\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;)&amp;nbsp;as&amp;nbsp;A,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;PURCHASEORDER&amp;nbsp;AS&amp;nbsp;B,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;XMLTABLE&amp;nbsp;(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;XMLNAMESPACES&amp;nbsp;(DEFAULT&amp;nbsp;\'http://posample.org\'),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;\'db2-fn:xmlcolumn('PURCHASEORDER.PORDER')/PurchaseOrder\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;COLUMNS<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'PONUM'&amp;nbsp;&amp;nbsp;BIGINT&amp;nbsp;PATH&amp;nbsp;\'@PoNum\',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'STATUS'&amp;nbsp;VARCHAR&amp;nbsp;(50)&amp;nbsp;PATH&amp;nbsp;\'@Status\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;)&amp;nbsp;as&amp;nbsp;C<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;A.CID&amp;nbsp;=&amp;nbsp;B.CUSTID&amp;nbsp;AND<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;B.POID&amp;nbsp;=&amp;nbsp;C.PONUM&amp;nbsp;AND<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;A.NAME&amp;nbsp;=&amp;nbsp;\'Kathy&amp;nbsp;Smith\'<br />'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br />while(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CID</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>NAME</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PHONE</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>PONUM</span><span style='color: #DD0000'>&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>STATUS</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 1001 Kathy Smith 905-555-7258 5002 Shipped </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #5 Returning SQL data as part of a larger XML document</b></p> <div class='example-contents para'><p> The following example works with a portion of the PRODUCT.DESCRIPTION documents in the SAMPLE database. It creates a XML document containing product description (XML data) and pricing info (SQL data). </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'<br />SELECT<br />XMLSERIALIZE(<br />XMLQUERY(\'<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;declare&amp;nbsp;boundary-space&amp;nbsp;strip;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;declare&amp;nbsp;default&amp;nbsp;element&amp;nbsp;namespace&amp;nbsp;'http://posample.org';<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;promoList&amp;gt;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;for&amp;nbsp;$prod&amp;nbsp;in&amp;nbsp;$doc/product<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;where&amp;nbsp;$prod/description/price&amp;nbsp;&amp;lt;&amp;nbsp;10.00<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;order&amp;nbsp;by&amp;nbsp;$prod/description/price&amp;nbsp;ascending<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;promoitem&amp;gt;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$prod,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;startdate&amp;gt;&amp;nbsp;{$start}&amp;nbsp;&amp;lt;/startdate&amp;gt;,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;enddate&amp;gt;&amp;nbsp;{$end}&amp;nbsp;&amp;lt;/enddate&amp;gt;,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;lt;promoprice&amp;gt;&amp;nbsp;{$promo}&amp;nbsp;&amp;lt;/promoprice&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;&amp;lt;/promoitem&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;&amp;lt;/promoList&amp;gt;<br />\'&amp;nbsp;passing&amp;nbsp;by&amp;nbsp;ref&amp;nbsp;DESCRIPTION&amp;nbsp;AS&amp;nbsp;'doc',<br />PROMOSTART&amp;nbsp;as&amp;nbsp;'start',<br />PROMOEND&amp;nbsp;as&amp;nbsp;'end',<br />PROMOPRICE&amp;nbsp;as&amp;nbsp;'promo'<br />RETURNING&amp;nbsp;SEQUENCE)<br />AS&amp;nbsp;CLOB&amp;nbsp;(32000))<br />AS&amp;nbsp;NEW_PRODUCT_INFO<br />FROM&amp;nbsp;PRODUCT<br />WHERE&amp;nbsp;PID&amp;nbsp;=&amp;nbsp;\'100-100-01\'<br />'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br />while(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>)){<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> &amp;lt;promoList xmlns=&amp;quot;http://posample.org&amp;quot;&amp;gt; &amp;lt;promoitem&amp;gt; &amp;lt;product pid=&amp;quot;100-100-01&amp;quot;&amp;gt; &amp;lt;description&amp;gt; &amp;lt;name&amp;gt;Snow Shovel, Basic 22 inch&amp;lt;/name&amp;gt; &amp;lt;details&amp;gt;Basic Snow Shovel, 22 inches wide, straight handle with D-Grip&amp;lt;/details&amp;gt; &amp;lt;price&amp;gt;9.99&amp;lt;/price&amp;gt; &amp;lt;weight&amp;gt;1 kg&amp;lt;/weight&amp;gt; &amp;lt;/description&amp;gt; &amp;lt;/product&amp;gt; &amp;lt;startdate&amp;gt;2004-11-19&amp;lt;/startdate&amp;gt; &amp;lt;enddate&amp;gt;2004-12-19&amp;lt;/enddate&amp;gt; &amp;lt;promoprice&amp;gt;7.25&amp;lt;/promoprice&amp;gt; &amp;lt;/promoitem&amp;gt; &amp;lt;/promoList&amp;gt; </pre></div> </div> </div><p> </p> </div> <a name='function.db2-exec.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function' rel='rdfs-seeAlso'>db2_execute()</a> - Executes a prepared SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_escape_string" value="<div id='function.db2-escape-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-escape-string.php'>db2_escape_string</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.6.0)</p><p class='refpurpose'><span class='refname'>db2_escape_string</span> &amp;mdash; <span class='dc-title'> Used to escape certain characters </span></p> </div> <a name='function.db2-escape-string.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_escape_string</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string_literal</tt></span> )</div> <p class='para rdfs-comment'> Prepends backslashes to special characters in the string argument. </p> </div> <a name='function.db2-escape-string.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string_literal</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string that contains special characters that need to be modified. Characters that are prepended with a backslash are <i>\x00</i>, <i>\n</i>, <i>\r</i>, <i>\</i>, <i>&amp;#039;</i>, <i>&amp;quot;</i> and <i>\x1a</i>. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-escape-string.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns <i><tt class='parameter'>string_literal</tt></i> with the special characters noted above prepended with backslashes. </p> </div> <a name='function.db2-escape-string.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_escape_string()</b> example</b></p> <div class='example-contents para'><p> Result of using the <b>db2_escape_string()</b> function </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'All&amp;nbsp;characters:&amp;nbsp;\x00&amp;nbsp;,&amp;nbsp;\n&amp;nbsp;,&amp;nbsp;\r&amp;nbsp;,&amp;nbsp;\&amp;nbsp;,&amp;nbsp;'&amp;nbsp;,&amp;nbsp;\'&amp;nbsp;,&amp;nbsp;\x1a&amp;nbsp;.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'Backslash&amp;nbsp;(\).&amp;nbsp;Single&amp;nbsp;quote&amp;nbsp;(').&amp;nbsp;Double&amp;nbsp;quote&amp;nbsp;(\')'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'The&amp;nbsp;NULL&amp;nbsp;character&amp;nbsp;\0&amp;nbsp;must&amp;nbsp;be&amp;nbsp;quoted&amp;nbsp;as&amp;nbsp;well'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>3</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'Intersting&amp;nbsp;characters:&amp;nbsp;\x1a&amp;nbsp;,&amp;nbsp;\x00&amp;nbsp;.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>4</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'Nothing&amp;nbsp;to&amp;nbsp;quote'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>5</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>200676</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>[</span><span style='color: #0000BB'>6</span><span style='color: #007700'>]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;foreach(&amp;nbsp;</span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$string&amp;nbsp;</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'db2_escape_string:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>db2_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$string</span><span style='color: #007700'>).&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> db2_escape_string: All characters: \0 , \n , \r , \\ , \&amp;#039; , \&amp;quot; , \Z . db2_escape_string: Backslash (\\). Single quote (\&amp;#039;). Double quote (\&amp;quot;) db2_escape_string: The NULL character \0 must be quoted as well db2_escape_string: Intersting characters: \Z , \0 . db2_escape_string: Nothing to quote db2_escape_string: 200676 db2_escape_string: </pre></div> </div> </div><p> </p> </div> <a name='function.db2-escape-string.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_cursor_type" value="<div id='function.db2-cursor-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-cursor-type.php'>db2_cursor_type</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_cursor_type</span> &amp;mdash; <span class='dc-title'> Returns the cursor type used by a statement resource </span></p> </div> <a name='function.db2-cursor-type.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>db2_cursor_type</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the cursor type used by a statement resource. Use this to determine if you are working with a forward-only cursor or scrollable cursor. </p> </div> <a name='function.db2-cursor-type.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid statement resource. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-cursor-type.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns either <i>DB2_FORWARD_ONLY</i> if the statement resource uses a forward-only cursor or <i>DB2_SCROLLABLE</i> if the statement resource uses a scrollable cursor. </p> </div> <a name='function.db2-cursor-type.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_conn_errormsg" value="<div id='function.db2-conn-errormsg' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-conn-errormsg.php'>db2_conn_errormsg</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_conn_errormsg</span> &amp;mdash; <span class='dc-title'> Returns the last connection error message and SQLCODE value </span></p> </div> <a name='function.db2-conn-errormsg.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_conn_errormsg</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> <b>db2_conn_errormsg()</b> returns an error message and SQLCODE value representing the reason the last database connection attempt failed. As <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> returns <b><tt class='constant'>FALSE</tt></b> in the event of a failed connection attempt, do not pass any parameters to <b>db2_conn_errormsg()</b> to retrieve the associated error message and SQLCODE value. </p> <p class='para'> If, however, the connection was successful but becomes invalid over time, you can pass the <i><tt class='parameter'>connection</tt></i> parameter to retrieve the associated error message and SQLCODE value for a specific connection. </p> </div> <a name='function.db2-conn-errormsg.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A connection resource associated with a connection that initially succeeded, but which over time became invalid. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-conn-errormsg.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing the error message and SQLCODE value resulting from a failed connection attempt. If there is no error associated with the last connection attempt, <b>db2_conn_errormsg()</b> returns an empty string. </p> </div> <a name='function.db2-conn-errormsg.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retrieving the error message returned by a failed connection attempt</b></p> <div class='example-contents para'><p> The following example demonstrates how to return an error message and SQLCODE value after deliberately passing invalid parameters to <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'badname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'baduser'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'badpassword'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #0000BB'>db2_conn_errormsg</span><span style='color: #007700'>();<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> [IBM][CLI Driver] SQL1013N The database alias name or database name &amp;quot;BADNAME&amp;quot; could not be found. SQLSTATE=42705 SQLCODE=-1013 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-conn-errormsg.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-conn-error.php' class='function' rel='rdfs-seeAlso'>db2_conn_error()</a> - Returns a string containing the SQLSTATE returned by the last connection attempt</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-error.php' class='function' rel='rdfs-seeAlso'>db2_stmt_error()</a> - Returns a string containing the SQLSTATE returned by an SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_stmt_errormsg()</a> - Returns a string containing the last SQL statement error message</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_conn_error" value="<div id='function.db2-conn-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-conn-error.php'>db2_conn_error</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_conn_error</span> &amp;mdash; <span class='dc-title'> Returns a string containing the SQLSTATE returned by the last connection attempt </span></p> </div> <a name='function.db2-conn-error.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>db2_conn_error</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> ] )</div> <p class='para rdfs-comment'> <b>db2_conn_error()</b> returns an SQLSTATE value representing the reason the last attempt to connect to a database failed. As <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> returns <b><tt class='constant'>FALSE</tt></b> in the event of a failed connection attempt, you do not pass any parameters to <b>db2_conn_error()</b> to retrieve the SQLSTATE value. </p> <p class='para'> If, however, the connection was successful but becomes invalid over time, you can pass the <i><tt class='parameter'>connection</tt></i> parameter to retrieve the SQLSTATE value for a specific connection. </p> <p class='para'> To learn what the SQLSTATE value means, you can issue the following command at a DB2 Command Line Processor prompt: <strong class='userinput'><code>db2 &amp;#039;? <i><tt class='parameter'>sqlstate-value</tt></i> &amp;#039;</code></strong> . You can also call <a href='http://www.php.net/manual/pt_BR/function.db2-conn-errormsg.php' class='function'>db2_conn_errormsg()</a> to retrieve an explicit error message and the associated SQLCODE value. </p> </div> <a name='function.db2-conn-error.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A connection resource associated with a connection that initially succeeded, but which over time became invalid. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-conn-error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the SQLSTATE value resulting from a failed connection attempt. Returns an empty string if there is no error associated with the last connection attempt. </p> </div> <a name='function.db2-conn-error.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retrieving an SQLSTATE value for a failed connection attempt</b></p> <div class='example-contents para'><p> The following example demonstrates how to return an SQLSTATE value after deliberately passing invalid parameters to <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'badname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'baduser'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'badpassword'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'SQLSTATE&amp;nbsp;value:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>db2_conn_error</span><span style='color: #007700'>();<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> SQLSTATE value: 08001 </pre></div> </div> </div><p> </p> </div> <a name='function.db2-conn-error.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-conn-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_conn_errormsg()</a> - Returns the last connection error message and SQLCODE value</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-error.php' class='function' rel='rdfs-seeAlso'>db2_stmt_error()</a> - Returns a string containing the SQLSTATE returned by an SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-stmt-errormsg.php' class='function' rel='rdfs-seeAlso'>db2_stmt_errormsg()</a> - Returns a string containing the last SQL statement error message</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_connect" value="<div id='function.db2-connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-connect.php'>db2_connect</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_connect</span> &amp;mdash; <span class='dc-title'> Returns a connection to a database </span></p> </div> <a name='function.db2-connect.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_connect</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$database</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$username</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$password</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$options</tt></span> ] )</div> <p class='para rdfs-comment'> Creates a new connection to an IBM DB2 Universal Database, IBM Cloudscape, or Apache Derby database. </p> </div> <a name='function.db2-connect.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>database</tt></i> </span> </dt><dd class='listitem'> <p class='para'> For a cataloged connection to a database, <i><tt class='parameter'>database</tt></i> represents the database alias in the DB2 client catalog. </p> <p class='para'> For an uncataloged connection to a database, <i><tt class='parameter'>database</tt></i> represents a complete connection string in the following format: <pre class='literallayout'>DATABASE=<i><tt class='parameter'>database</tt></i> ;HOSTNAME=<i><tt class='parameter'>hostname</tt></i> ;PORT=<i><tt class='parameter'>port</tt></i> ;PROTOCOL=TCPIP;UID=<i><tt class='parameter'>username</tt></i> ;PWD=<i><tt class='parameter'>password</tt></i> ;</pre> where the parameters represent the following values: </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>database</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>hostname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The hostname or IP address of the database server. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>port</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The TCP/IP port on which the database is listening for requests. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>username</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The username with which you are connecting to the database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The password with which you are connecting to the database. </p> </dd> </dl> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>username</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The username with which you are connecting to the database. </p> <p class='para'> For uncataloged connections, you must pass a <b><tt class='constant'>NULL</tt></b> value or empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The password with which you are connecting to the database. </p> <p class='para'> For uncataloged connections, you must pass a <b><tt class='constant'>NULL</tt></b> value or empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>options</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An associative array of connection options that affect the behavior of the connection, where valid array keys include: </p><dl> <dt class='varlistentry'> <br /><span class='term'><i><tt class='parameter'>autocommit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the <i>DB2_AUTOCOMMIT_ON</i> value turns autocommit on for this connection handle. </p> <p class='para'> Passing the <i>DB2_AUTOCOMMIT_OFF</i> value turns autocommit off for this connection handle. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>DB2_ATTR_CASE</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the <i>DB2_CASE_NATURAL</i> value specifies that column names are returned in natural case. </p> <p class='para'> Passing the <i>DB2_CASE_LOWER</i> value specifies that column names are returned in lower case. </p> <p class='para'> Passing the <i>DB2_CASE_UPPER</i> value specifies that column names are returned in upper case. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>CURSOR</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the <i>DB2_FORWARD_ONLY</i> value specifies a forward-only cursor for a statement resource. This is the default cursor type and is supported on all database servers. </p> <p class='para'> Passing the <i>DB2_SCROLLABLE</i> value specifies a scrollable cursor for a statement resource. This mode enables random access to rows in a result set, but currently is supported only by IBM DB2 Universal Database. </p> </dd> </dl> <p> </p> <p class='para'> The following new option is available in ibm_db2 version 1.7.0 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>trustedcontext</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Passing the DB2_TRUSTED_CONTEXT_ENABLE value turns trusted context on for this connection handle. This parameter cannot be set using <a href='http://www.php.net/manual/pt_BR/function.db2-set-option.php' class='function'>db2_set_option()</a>. </p> <p class='para'> This key works only if the database is cataloged (even if the database is local), or if you specify the full DSN when you create the connection. </p> <p class='para'> To catalog the database, use following commands: </p> <p class='para'> <pre class='literallayout'>db2 catalog tcpip node loopback remote &amp;lt;SERVERNAME&amp;gt; server &amp;lt;SERVICENAME&amp;gt; db2 catalog database &amp;lt;LOCALDBNAME&amp;gt; as &amp;lt;REMOTEDBNAME&amp;gt; at node loopback db2 &amp;quot;update dbm cfg using svcename &amp;lt;SERVICENAME&amp;gt;&amp;quot; db2set DB2COMM=TCPIP</pre> </p> </dd> </dl> <p> </p> <p class='para'> The following new i5/OS options are available in ibm_db2 version 1.5.1 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_lib</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A character value that indicates the default library that will be used for resolving unqualified file references. This is not valid if the connection is using system naming mode. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_naming</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_NAMING_ON</i> value turns on DB2 UDB CLI iSeries system naming mode. Files are qualified using the slash (/) delimiter. Unqualified files are resolved using the library list for the job. </p> <p class='para'> <i>DB2_I5_NAMING_OFF</i> value turns off DB2 UDB CLI default naming mode, which is SQL naming. Files are qualified using the period (.) delimiter. Unqualified files are resolved using either the default library or the current user ID. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_commit</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <i><tt class='parameter'>i5_commit</tt></i> attribute should be set before the <b>db2_connect()</b>. If the value is changed after the connection has been established, and the connection is to a remote data source, the change does not take effect until the next successful <b>db2_connect()</b> for the connection handle. </p><blockquote><p><b class='note'>Nota</b>: The php.ini setting <i><tt class='parameter'>ibm_db2.i5_allow_commit</tt></i> ==0 or <i>DB2_I5_TXN_NO_COMMIT</i> is the default, but may be overridden with the <i><tt class='parameter'>i5_commit</tt></i> option. <br /> </p></blockquote><p> </p> <p class='para'> <i>DB2_I5_TXN_NO_COMMIT</i> - Commitment control is not used. </p> <p class='para'> <i>DB2_I5_TXN_READ_UNCOMMITTED</i> - Dirty reads, nonrepeatable reads, and phantoms are possible. </p> <p class='para'> <i>DB2_I5_TXN_READ_COMMITTED</i> - Dirty reads are not possible. Nonrepeatable reads, and phantoms are possible. </p> <p class='para'> <i>DB2_I5_TXN_REPEATABLE_READ</i> - Dirty reads and nonrepeatable reads are not possible. Phantoms are possible. </p> <p class='para'> <i>DB2_I5_TXN_SERIALIZABLE</i> - Transactions are serializable. Dirty reads, non-repeatable reads, and phantoms are not possible </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_query_optimize</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_FIRST_IO</i> All queries are optimized with the goal of returning the first page of output as fast as possible. This goal works well when the output is controlled by a user who is most likely to cancel the query after viewing the first page of output data. Queries coded with an OPTIMIZE FOR nnn ROWS clause honor the goal specified by the clause. </p> <p class='para'> <i>DB2_ALL_IO</i> All queries are optimized with the goal of running the entire query to completion in the shortest amount of elapsed time. This is a good option when the output of a query is being written to a file or report, or the interface is queuing the output data. Queries coded with an OPTIMIZE FOR nnn ROWS clause honor the goal specified by the clause. This is the default. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_dbcs_alloc</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_DBCS_ALLOC_ON</i> value turns on DB2 6X allocation scheme for DBCS translation column size growth. </p> <p class='para'> <i>DB2_I5_DBCS_ALLOC_OFF</i> value turns off DB2 6X allocation scheme for DBCS translation column size growth. </p> <p class='para'> Note: php.ini setting <i><tt class='parameter'>ibm_db2.i5_dbcs_alloc</tt></i> ==0 or <i>DB2_I5_DBCS_ALLOC_OFF</i> is the default, but may be overridden with the <i><tt class='parameter'>i5_dbcs_alloc</tt></i> option. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_date_fmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_FMT_ISO</i> - The International Organization for Standardization (ISO) date format yyyy-mm-dd is used. This is the default. </p> <p class='para'> <i>DB2_I5_FMT_USA</i> - The United States date format mm/dd/yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_EUR</i> - The European date format dd.mm.yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_JIS</i> - The Japanese Industrial Standard date format yyyy-mm-dd is used. </p> <p class='para'> <i>DB2_I5_FMT_MDY</i> - The date format mm/dd/yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_DMY</i> - The date format dd/mm/yyyy is used. </p> <p class='para'> <i>DB2_I5_FMT_YMD</i> - The date format yy/mm/dd is used. </p> <p class='para'> <i>DB2_I5_FMT_JUL</i> - The Julian date format yy/ddd is used. </p> <p class='para'> <i>DB2_I5_FMT_JOB</i> - The job default is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_date_sep</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_SEP_SLASH</i> - A slash ( / ) is used as the date separator. This is the default. </p> <p class='para'> <i>DB2_I5_SEP_DASH</i> - A dash ( - ) is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_PERIOD</i> - A period ( . ) is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_COMMA</i> - A comma ( , ) is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_BLANK</i> - A blank is used as the date separator. </p> <p class='para'> <i>DB2_I5_SEP_JOB</i> - The job default is used </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_time_fmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_FMT_ISO</i> - The International Organization for Standardization (ISO) time format hh.mm.ss is used. This is the default. </p> <p class='para'> <i>DB2_I5_FMT_USA</i> - The United States time format hh:mmxx is used, where xx is AM or PM. </p> <p class='para'> <i>DB2_I5_FMT_EUR</i> - The European time format hh.mm.ss is used. </p> <p class='para'> <i>DB2_I5_FMT_JIS</i> - The Japanese Industrial Standard time format hh:mm:ss is used. </p> <p class='para'> <i>DB2_I5_FMT_HMS</i> - The hh:mm:ss format is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_time_sep</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_SEP_COLON</i> - A colon ( : ) is used as the time separator. This is the default. </p> <p class='para'> <i>DB2_I5_SEP_PERIOD</i> - A period ( . ) is used as the time separator. </p> <p class='para'> <i>DB2_I5_SEP_COMMA</i> - A comma ( , ) is used as the time separator. </p> <p class='para'> <i>DB2_I5_SEP_BLANK</i> - A blank is used as the time separator. </p> <p class='para'> <i>DB2_I5_SEP_JOB</i> - The job default is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_decimal_sep</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i>DB2_I5_SEP_PERIOD</i> - A period ( . ) is used as the decimal separator. This is the default. </p> <p class='para'> <i>DB2_I5_SEP_COMMA</i> - A comma ( , ) is used as the decimal separator. </p> <p class='para'> <i>DB2_I5_SEP_JOB</i> - The job default is used. </p> </dd> </dl> <p> </p> <p class='para'> The following new i5/OS option is available in ibm_db2 version 1.8.0 and later. </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>i5_libl</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A character value that indicates the library list that will be used for resolving unqualified file references. Specify the library list elements separated by blanks &amp;#039;i5_libl&amp;#039;=&amp;gt;&amp;quot;MYLIB YOURLIB ANYLIB&amp;quot;. </p> <blockquote><p><b class='note'>Nota</b>: <i><tt class='parameter'>i5_libl</tt></i> calls qsys2/qcmdexc(&amp;#039;cmd&amp;#039;,cmdlen), which is only available in i5/OS V5R4 and later. <br /> </p></blockquote> </dd> </dl> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.db2-connect.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a connection handle resource if the connection attempt is successful. If the connection attempt fails, <b>db2_connect()</b> returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.db2-connect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Creating a cataloged connection</b></p> <div class='example-contents para'><p> Cataloged connections require you to have previously cataloged the target database through the DB2 Command Line Processor (CLP) or DB2 Configuration Assistant. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;succeeded.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Connection succeeded. </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Creating an uncataloged connection</b></p> <div class='example-contents para'><p> An uncataloged connection enables you to dynamically connect to a database. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$conn_string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER={IBM&amp;nbsp;DB2&amp;nbsp;ODBC&amp;nbsp;DRIVER};DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;'&amp;nbsp;</span><span style='color: #007700'>.<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;PROTOCOL=TCPIP;UID=</span><span style='color: #0000BB'>$user</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$password</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn_string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;succeeded.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Connection succeeded. </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #3 Creating a connection with autocommit off by default</b></p> <div class='example-contents para'><p> Passing an array of options to <b>db2_connect()</b> enables you to modify the default behavior of the connection handle. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$password&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;succeeded.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>db2_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Autocommit&amp;nbsp;is&amp;nbsp;on.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Autocommit&amp;nbsp;is&amp;nbsp;off.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Connection succeeded. Autocommit is off. </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #4 i5/OS best performance</b></p> <div class='example-contents para'><p> To achieve best performance for your i5/OS ibm_db2 1.5.1 PHP application use the default host, userid, and password for your <b>db2_connect()</b>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;$library&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ADC'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i5&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #DD0000'>'i5_lib'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'qsys2'</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_exec</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$i5</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;systables&amp;nbsp;where&amp;nbsp;table_schema&amp;nbsp;=&amp;nbsp;'</span><span style='color: #0000BB'>$library</span><span style='color: #DD0000'>''</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_both</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>))&amp;nbsp;{&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'TABLE_NAME'</span><span style='color: #007700'>].</span><span style='color: #DD0000'>'&amp;lt;/br&amp;gt;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;}&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$i5</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> ANIMALS NAMES PICTURES </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #5 Using trusted context</b></p> <div class='example-contents para'><p> The following example shows how to enable trusted context, switch users, and get the current user ID. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$database&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hostname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$port&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50000</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$authID&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$auth_pass&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$tc_user&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'tcuser'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$tc_pass&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'tcpassword'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$dsn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DATABASE=</span><span style='color: #0000BB'>$database</span><span style='color: #DD0000'>;HOSTNAME=</span><span style='color: #0000BB'>$hostname</span><span style='color: #DD0000'>;PORT=</span><span style='color: #0000BB'>$port</span><span style='color: #DD0000'>;<br />&amp;nbsp;&amp;nbsp;PROTOCOL=TCPIP;UID=</span><span style='color: #0000BB'>$authID</span><span style='color: #DD0000'>;PWD=</span><span style='color: #0000BB'>$auth_pass</span><span style='color: #DD0000'>;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array&amp;nbsp;(</span><span style='color: #DD0000'>'trustedcontext'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_TRUSTED_CONTEXT_ENABLE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$tc_conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dsn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>);<br />if(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Explicit&amp;nbsp;trusted&amp;nbsp;connection&amp;nbsp;succeeded.\n'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if(</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'trustedcontext'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$userBefore&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'trusted_user'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//Do&amp;nbsp;some&amp;nbsp;work&amp;nbsp;as&amp;nbsp;user&amp;nbsp;1.<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;//Switching&amp;nbsp;to&amp;nbsp;trusted&amp;nbsp;user.<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$parameters&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'trusted_user'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$tc_user</span><span style='color: #007700'>,&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'trusted_password'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$tcuser_pass</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$res&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_set_option&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$parameters</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$userAfter&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_get_option</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'trusted_user'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//Do&amp;nbsp;more&amp;nbsp;work&amp;nbsp;as&amp;nbsp;trusted&amp;nbsp;user.<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$userBefore&amp;nbsp;</span><span style='color: #007700'>!=&amp;nbsp;</span><span style='color: #0000BB'>$userAfter</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'User&amp;nbsp;has&amp;nbsp;been&amp;nbsp;switched.'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$tc_conn</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Explicit&amp;nbsp;trusted&amp;nbsp;connection&amp;nbsp;failed.\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Explicit trusted connection succeeded. User has been switched. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-connect.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-close.php' class='function' rel='rdfs-seeAlso'>db2_close()</a> - Closes a database connection</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function' rel='rdfs-seeAlso'>db2_pconnect()</a> - Returns a persistent connection to a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_commit" value="<div id='function.db2-commit' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-commit.php'>db2_commit</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_commit</span> &amp;mdash; <span class='dc-title'> Commits a transaction </span></p> </div> <a name='function.db2-commit.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_commit</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> Commits an in-progress transaction on the specified connection resource and begins a new transaction. PHP applications normally default to AUTOCOMMIT mode, so <b>db2_commit()</b> is not necessary unless AUTOCOMMIT has been turned off for the connection resource. </p> <blockquote><p><b class='note'>Nota</b>: If the specified connection resource is a persistent connection, all transactions in progress for all applications using that persistent connection will be committed. For this reason, persistent connections are not recommended for use in applications that require transactions. <br /> </p></blockquote> </div> <a name='function.db2-commit.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid database connection resource variable as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-commit.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-commit.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-autocommit.php' class='function' rel='rdfs-seeAlso'>db2_autocommit()</a> - Returns or sets the AUTOCOMMIT state for a database connection</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-rollback.php' class='function' rel='rdfs-seeAlso'>db2_rollback()</a> - Rolls back a transaction</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_column_privileges" value="<div id='function.db2-column-privileges' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-column-privileges.php'>db2_column_privileges</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_column_privileges</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the columns and associated privileges for a table </span></p> </div> <a name='function.db2-column-privileges.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_column_privileges</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-name</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$column-name</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Returns a result set listing the columns and associated privileges for a table. </p> </div> <a name='function.db2-column-privileges.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. To match all schemas, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table or view. To match all tables in the database, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the column. To match all columns in the table, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-column-privileges.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the column privileges for columns matching the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>TABLE_CAT</td> <td align='left'>Name of the catalog. The value is NULL if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_SCHEM</td> <td align='left'>Name of the schema.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_NAME</td> <td align='left'>Name of the table or view.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_NAME</td> <td align='left'>Name of the column.</td> </tr> <tr valign='middle'> <td align='left'>GRANTOR</td> <td align='left'>Authorization ID of the user who granted the privilege.</td> </tr> <tr valign='middle'> <td align='left'>GRANTEE</td> <td align='left'>Authorization ID of the user to whom the privilege was granted.</td> </tr> <tr valign='middle'> <td align='left'>PRIVILEGE</td> <td align='left'>The privilege for the column.</td> </tr> <tr valign='middle'> <td align='left'>IS_GRANTABLE</td> <td align='left'>Whether the GRANTEE is permitted to grant this privilege to other users.</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-column-privileges.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-columns.php' class='function' rel='rdfs-seeAlso'>db2_columns()</a> - Returns a result set listing the columns and associated metadata for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_columns" value="<div id='function.db2-columns' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-columns.php'>db2_columns</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_columns</span> &amp;mdash; <span class='dc-title'> Returns a result set listing the columns and associated metadata for a table </span></p> </div> <a name='function.db2-columns.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>resource</span> <span class='methodname'><b>db2_columns</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$qualifier</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$schema</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table-name</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$column-name</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Returns a result set listing the columns and associated metadata for a table. </p> </div> <a name='function.db2-columns.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid connection to an IBM DB2, Cloudscape, or Apache Derby database. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>qualifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>schema</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The schema which contains the tables. To match all schemas, pass <i>&amp;#039;%&amp;#039;</i>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>table-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the table or view. To match all tables in the database, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>column-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the column. To match all columns in the table, pass <b><tt class='constant'>NULL</tt></b> or an empty string. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-columns.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a statement resource with a result set containing rows describing the columns matching the specified parameters. The rows are composed of the following columns: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Column name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>TABLE_CAT</td> <td align='left'>Name of the catalog. The value is NULL if this table does not have catalogs.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_SCHEM</td> <td align='left'>Name of the schema.</td> </tr> <tr valign='middle'> <td align='left'>TABLE_NAME</td> <td align='left'>Name of the table or view.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_NAME</td> <td align='left'>Name of the column.</td> </tr> <tr valign='middle'> <td align='left'>DATA_TYPE</td> <td align='left'>The SQL data type for the column represented as an integer value.</td> </tr> <tr valign='middle'> <td align='left'>TYPE_NAME</td> <td align='left'>A string representing the data type for the column.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_SIZE</td> <td align='left'>An integer value representing the size of the column.</td> </tr> <tr valign='middle'> <td align='left'>BUFFER_LENGTH</td> <td align='left'> Maximum number of bytes necessary to store data from this column. </td> </tr> <tr valign='middle'> <td align='left'>DECIMAL_DIGITS</td> <td align='left'> The scale of the column, or <b><tt class='constant'>NULL</tt></b> where scale is not applicable. </td> </tr> <tr valign='middle'> <td align='left'>NUM_PREC_RADIX</td> <td align='left'> An integer value of either <i>10</i> (representing an exact numeric data type), <i>2</i> (representing an approximate numeric data type), or <b><tt class='constant'>NULL</tt></b> (representing a data type for which radix is not applicable). </td> </tr> <tr valign='middle'> <td align='left'>NULLABLE</td> <td align='left'>An integer value representing whether the column is nullable or not.</td> </tr> <tr valign='middle'> <td align='left'>REMARKS</td> <td align='left'>Description of the column.</td> </tr> <tr valign='middle'> <td align='left'>COLUMN_DEF</td> <td align='left'>Default value for the column.</td> </tr> <tr valign='middle'> <td align='left'>SQL_DATA_TYPE</td> <td align='left'>An integer value representing the size of the column.</td> </tr> <tr valign='middle'> <td align='left'>SQL_DATETIME_SUB</td> <td align='left'> Returns an integer value representing a datetime subtype code, or <b><tt class='constant'>NULL</tt></b> for SQL data types to which this does not apply. </td> </tr> <tr valign='middle'> <td align='left'>CHAR_OCTET_LENGTH</td> <td align='left'> Maximum length in octets for a character data type column, which matches COLUMN_SIZE for single-byte character set data, or <b><tt class='constant'>NULL</tt></b> for non-character data types. </td> </tr> <tr valign='middle'> <td align='left'>ORDINAL_POSITION</td> <td align='left'>The 1-indexed position of the column in the table.</td> </tr> <tr valign='middle'> <td align='left'>IS_NULLABLE</td> <td align='left'> A string value where &amp;#039;YES&amp;#039; means that the column is nullable and &amp;#039;NO&amp;#039; means that the column is not nullable. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-columns.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-column-privileges.php' class='function' rel='rdfs-seeAlso'>db2_column_privileges()</a> - Returns a result set listing the columns and associated privileges for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-foreign-keys.php' class='function' rel='rdfs-seeAlso'>db2_foreign_keys()</a> - Returns a result set listing the foreign keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-primary-keys.php' class='function' rel='rdfs-seeAlso'>db2_primary_keys()</a> - Returns a result set listing primary keys for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedure-columns.php' class='function' rel='rdfs-seeAlso'>db2_procedure_columns()</a> - Returns a result set listing stored procedure parameters</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-procedures.php' class='function' rel='rdfs-seeAlso'>db2_procedures()</a> - Returns a result set listing the stored procedures registered in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-special-columns.php' class='function' rel='rdfs-seeAlso'>db2_special_columns()</a> - Returns a result set listing the unique row identifier columns for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-statistics.php' class='function' rel='rdfs-seeAlso'>db2_statistics()</a> - Returns a result set listing the index and statistics for a table</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-table-privileges.php' class='function' rel='rdfs-seeAlso'>db2_table_privileges()</a> - Returns a result set listing the tables and associated privileges in a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-tables.php' class='function' rel='rdfs-seeAlso'>db2_tables()</a> - Returns a result set listing the tables and associated metadata in a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_close" value="<div id='function.db2-close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-close.php'>db2_close</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_close</span> &amp;mdash; <span class='dc-title'> Closes a database connection </span></p> </div> <a name='function.db2-close.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_close</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> This function closes a DB2 client connection created with <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> and returns the corresponding resources to the database server. </p> <p class='para'> If you attempt to close a persistent DB2 client connection created with <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>, the close request is ignored and the persistent DB2 client connection remains available for the next caller. </p> </div> <a name='function.db2-close.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies an active DB2 client connection. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-close.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-close.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Closing a connection</b></p> <div class='example-contents para'><p> The following example demonstrates a successful attempt to close a connection to an IBM DB2, Cloudscape, or Apache Derby database. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$rc</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Connection&amp;nbsp;was&amp;nbsp;successfully&amp;nbsp;closed.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Connection was successfully closed. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-close.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pclose.php' class='function' rel='rdfs-seeAlso'>db2_pclose()</a> - Closes a persistent database connection</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function' rel='rdfs-seeAlso'>db2_pconnect()</a> - Returns a persistent connection to a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_client_info" value="<div id='function.db2-client-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-client-info.php'>db2_client_info</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.1.1)</p><p class='refpurpose'><span class='refname'>db2_client_info</span> &amp;mdash; <span class='dc-title'>Returns an object with properties that describe the DB2 database client</span></p> </div> <a name='function.db2-client-info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>db2_client_info</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> )</div> <p class='para rdfs-comment'> This function returns an object with read-only properties that return information about the DB2 database client. The following table lists the DB2 client properties: </p><table class='doctable table'> <caption><b>DB2 client properties</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Property name</th> <th>Return type</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>APPL_CODEPAGE</td> <td align='left'>int</td> <td align='left'>The application code page.</td> </tr> <tr valign='middle'> <td align='left'>CONN_CODEPAGE</td> <td align='left'>int</td> <td align='left'>The code page for the current connection.</td> </tr> <tr valign='middle'> <td align='left'>DATA_SOURCE_NAME</td> <td align='left'>string</td> <td align='left'>The data source name (DSN) used to create the current connection to the database.</td> </tr> <tr valign='middle'> <td align='left'>DRIVER_NAME</td> <td align='left'>string</td> <td align='left'>The name of the library that implements the DB2 Call Level Interface (CLI) specification.</td> </tr> <tr valign='middle'> <td align='left'>DRIVER_ODBC_VER</td> <td align='left'>string</td> <td align='left'>The version of ODBC that the DB2 client supports. This returns a string &amp;quot;MM.mm&amp;quot; where <var class='varname'>MM</var> is the major version and <var class='varname'>mm</var> is the minor version. The DB2 client always returns &amp;quot;03.51&amp;quot;. </td> </tr> <tr valign='middle'> <td align='left'>DRIVER_VER</td> <td align='left'>string</td> <td align='left'>The version of the client, in the form of a string &amp;quot;MM.mm.uuuu&amp;quot; where <var class='varname'>MM</var> is the major version, <var class='varname'>mm</var> is the minor version, and <var class='varname'>uuuu</var> is the update. For example, &amp;quot;08.02.0001&amp;quot; represents major version 8, minor version 2, update 1. </td> </tr> <tr valign='middle'> <td align='left'>ODBC_SQL_CONFORMANCE</td> <td align='left'>string</td> <td align='left'> <p class='para'>The level of ODBC SQL grammar supported by the client: </p><dl> <dt class='varlistentry'> <span class='term'>MINIMUM</span> </dt><dd class='listitem'> <p class='para'> Supports the minimum ODBC SQL grammar. </p> </dd> <dt class='varlistentry'> <span class='term'>CORE</span> </dt><dd class='listitem'> <p class='para'> Supports the core ODBC SQL grammar. </p> </dd> <dt class='varlistentry'> <span class='term'>EXTENDED</span> </dt><dd class='listitem'> <p class='para'> Supports extended ODBC SQL grammar. </p> </dd> </dl> <p> </p> </td> </tr> <tr valign='middle'> <td align='left'>ODBC_VER</td> <td align='left'>string</td> <td align='left'>The version of ODBC that the ODBC driver manager supports. This returns a string &amp;quot;MM.mm.rrrr&amp;quot; where <var class='varname'>MM</var> is the major version, <var class='varname'>mm</var> is the minor version, and <var class='varname'>rrrr</var> is the release. The DB2 client always returns &amp;quot;03.01.0000&amp;quot;. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.db2-client-info.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies an active DB2 client connection. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-client-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an object on a successful call. Returns <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.db2-client-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 A <b>db2_client_info()</b> example</b></p> <div class='example-contents para'><p> To retrieve information about the client, you must pass a valid database connection resource to <b>db2_client_info()</b>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #DD0000'>'SAMPLE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'db2inst1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ibmdb2'&amp;nbsp;</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$client&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_client_info</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER_NAME:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DRIVER_NAME&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER_VER:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DRIVER_VER&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DATA_SOURCE_NAME:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DATA_SOURCE_NAME&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'DRIVER_ODBC_VER:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>DRIVER_ODBC_VER&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'ODBC_VER:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>ODBC_VER&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'ODBC_SQL_CONFORMANCE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>ODBC_SQL_CONFORMANCE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'APPL_CODEPAGE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>APPL_CODEPAGE&amp;nbsp;</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'CONN_CODEPAGE:&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$client</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CONN_CODEPAGE&amp;nbsp;</span><span style='color: #007700'>);<br />}<br />else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Error&amp;nbsp;retrieving&amp;nbsp;client&amp;nbsp;information.<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;Perhaps&amp;nbsp;your&amp;nbsp;database&amp;nbsp;connection&amp;nbsp;was&amp;nbsp;invalid.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>db2_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> DRIVER_NAME: string(8) &amp;quot;libdb2.a&amp;quot; DRIVER_VER: string(10) &amp;quot;08.02.0001&amp;quot; DATA_SOURCE_NAME: string(6) &amp;quot;SAMPLE&amp;quot; DRIVER_ODBC_VER: string(5) &amp;quot;03.51&amp;quot; ODBC_VER: string(10) &amp;quot;03.01.0000&amp;quot; ODBC_SQL_CONFORMANCE: string(8) &amp;quot;EXTENDED&amp;quot; APPL_CODEPAGE: int(819) CONN_CODEPAGE: int(819) </pre></div> </div> </div><p> </p> </div> <a name='function.db2-client-info.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-server-info.php' class='function' rel='rdfs-seeAlso'>db2_server_info()</a> - Returns an object with properties that describe the DB2 database server</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_bind_param" value="<div id='function.db2-bind-param' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-bind-param.php'>db2_bind_param</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_bind_param</span> &amp;mdash; <span class='dc-title'> Binds a PHP variable to an SQL statement parameter </span></p> </div> <a name='function.db2-bind-param.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>db2_bind_param</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$parameter-number</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$variable-name</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$parameter-type</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$data-type</tt><span class='initializer'> = 0</span></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$precision</tt><span class='initializer'> = -1</span></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$scale</tt><span class='initializer'> = 0</span></span> ]]]] )</div> <p class='para rdfs-comment'> Binds a PHP variable to an SQL statement parameter in a statement resource returned by <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a>. This function gives you more control over the parameter type, data type, precision, and scale for the parameter than simply passing the variable as part of the optional input array to <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a>. </p> </div> <a name='function.db2-bind-param.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A prepared statement returned from <a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function'>db2_prepare()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>parameter-number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the 1-indexed position of the parameter in the prepared statement. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>variable-name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string specifying the name of the PHP variable to bind to the parameter specified by <i><tt class='parameter'>parameter-number</tt></i> . </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>parameter-type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A constant specifying whether the PHP variable should be bound to the SQL parameter as an input parameter (<i>DB2_PARAM_IN</i>), an output parameter (<i>DB2_PARAM_OUT</i>), or as a parameter that accepts input and returns output (<i>DB2_PARAM_INOUT</i>). To avoid memory overhead, you can also specify <i>DB2_PARAM_FILE</i> to bind the PHP variable to the name of a file that contains large object (BLOB, CLOB, or DBCLOB) data. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>data-type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A constant specifying the SQL data type that the PHP variable should be bound as: one of <i>DB2_BINARY</i>, <i>DB2_CHAR</i>, <i>DB2_DOUBLE</i>, or <i>DB2_LONG</i> . </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>precision</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the precision with which the variable should be bound to the database. This parameter can also be used for retrieving XML output values from stored procedures. A non-negative value specifies the maximum size of the XML data that will be retrieved from the database. If this parameter is not used, a default of 1MB will be assumed for retrieving the XML output value from the stored procedure. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>scale</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the scale with which the variable should be bound to the database. </p> </dd> </dl> <p> </p> </div> <a name='function.db2-bind-param.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-bind-param.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Binding PHP variables to a prepared statement</b></p> <div class='example-contents para'><p> The SQL statement in the following example uses two input parameters in the WHERE clause. We call <b>db2_bind_param()</b> to bind two PHP variables to the corresponding SQL parameters. Notice that the PHP variables do not have to be declared or assigned before the call to <b>db2_bind_param()</b>; in the example, <i>$lower_limit</i> is assigned a value before the call to <b>db2_bind_param()</b>, but <i>$upper_limit</i> is assigned a value after the call to <b>db2_bind_param()</b>. The variables must be bound and, for parameters that accept input, must have any value assigned, before calling <a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function'>db2_execute()</a>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;name,&amp;nbsp;breed,&amp;nbsp;weight&amp;nbsp;FROM&amp;nbsp;animals<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;weight&amp;nbsp;&amp;gt;&amp;nbsp;?&amp;nbsp;AND&amp;nbsp;weight&amp;nbsp;&amp;lt;&amp;nbsp;?'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;We&amp;nbsp;can&amp;nbsp;declare&amp;nbsp;the&amp;nbsp;variable&amp;nbsp;before&amp;nbsp;calling&amp;nbsp;db2_bind_param()<br /></span><span style='color: #0000BB'>$lower_limit&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'lower_limit'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'upper_limit'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;We&amp;nbsp;can&amp;nbsp;also&amp;nbsp;declare&amp;nbsp;the&amp;nbsp;variable&amp;nbsp;after&amp;nbsp;calling&amp;nbsp;db2_bind_param()<br /></span><span style='color: #0000BB'>$upper_limit&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>15.0</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>,&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>,&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Pook, cat, 3.2 Rickety Ride, goat, 9.7 Peaches, dog, 12.3 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Calling stored procedures with IN and OUT parameters</b></p> <div class='example-contents para'><p> The stored procedure match_animal in the following example accepts three different parameters: </p><ol type='1'> <li class='listitem'> <p class='para'> an input (IN) parameter that accepts the name of the first animal as input </p> </li> <li class='listitem'> <p class='para'> an input-output (INOUT) parameter that accepts the name of the second animal as input and returns the string <i>TRUE</i> if an animal in the database matches that name </p> </li> <li class='listitem'> <p class='para'> an output (OUT) parameter that returns the sum of the weight of the two identified animals </p> </li> </ol><p> In addition, the stored procedure returns a result set consisting of the animals listed in alphabetic order starting at the animal corresponding to the input value of the first parameter and ending at the animal corresponding to the input value of the second parameter. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'CALL&amp;nbsp;match_animal(?,&amp;nbsp;?,&amp;nbsp;?)'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Peaches'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$second_name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Rickety&amp;nbsp;Ride'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$weight&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'name'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_IN</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'second_name'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_INOUT</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'weight'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_OUT</span><span style='color: #007700'>);<br /><br />print&amp;nbsp;</span><span style='color: #DD0000'>'Values&amp;nbsp;of&amp;nbsp;bound&amp;nbsp;parameters&amp;nbsp;_before_&amp;nbsp;CALL:\n'</span><span style='color: #007700'>;<br />print&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;nbsp;1:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>}</span><span style='color: #DD0000'>&amp;nbsp;2:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$second_name</span><span style='color: #007700'>}</span><span style='color: #DD0000'>&amp;nbsp;3:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$weight</span><span style='color: #007700'>}</span><span style='color: #DD0000'>\n\n'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Values&amp;nbsp;of&amp;nbsp;bound&amp;nbsp;parameters&amp;nbsp;_after_&amp;nbsp;CALL:\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;nbsp;1:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>}</span><span style='color: #DD0000'>&amp;nbsp;2:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$second_name</span><span style='color: #007700'>}</span><span style='color: #DD0000'>&amp;nbsp;3:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$weight</span><span style='color: #007700'>}</span><span style='color: #DD0000'>\n\n'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Results:\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>,&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>,&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Values of bound parameters _before_ CALL: 1: Peaches 2: Rickety Ride 3: 0 Values of bound parameters _after_ CALL: 1: Peaches 2: TRUE 3: 22 Results: Peaches, dog, 12.3 Pook, cat, 3.2 Rickety Ride, goat, 9.7 </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #3 Inserting a binary large object (BLOB) directly from a file</b></p> <div class='example-contents para'><p> The data for large objects are typically stored in files, such as XML documents or audio files. Rather than reading an entire file into a PHP variable, and then binding that PHP variable into an SQL statement, you can avoid some memory overhead by binding the file directly to the input parameter of your SQL statement. The following example demonstrates how to bind a file directly into a BLOB column. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;animal_pictures(picture)&amp;nbsp;VALUES&amp;nbsp;(?)'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$picture&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'/opt/albums/spook/grooming.jpg'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'picture'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_PARAM_FILE</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.db2-bind-param.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-execute.php' class='function' rel='rdfs-seeAlso'>db2_execute()</a> - Executes a prepared SQL statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-prepare.php' class='function' rel='rdfs-seeAlso'>db2_prepare()</a> - Prepares an SQL statement to be executed</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
<string id="db2_autocommit" value="<div id='function.db2-autocommit' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.db2-autocommit.php'>db2_autocommit</a></h1> <p class='verinfo'>(PECL ibm_db2 &amp;gt;= 1.0.0)</p><p class='refpurpose'><span class='refname'>db2_autocommit</span> &amp;mdash; <span class='dc-title'> Returns or sets the AUTOCOMMIT state for a database connection </span></p> </div> <a name='function.db2-autocommit.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.mixed' class='type mixed'>mixed</a></span> <span class='methodname'><b>db2_autocommit</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$connection</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$value</tt></span> ] )</div> <p class='para rdfs-comment'> Sets or gets the AUTOCOMMIT behavior of the specified connection resource. </p> </div> <a name='function.db2-autocommit.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'> </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>connection</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid database connection resource variable as returned from <a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function'>db2_connect()</a> or <a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function'>db2_pconnect()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>value</tt></i> </span> </dt><dd class='listitem'> <p class='para'> One of the following constants: </p><dl> <dt class='varlistentry'> <br /><span class='term'><i>DB2_AUTOCOMMIT_OFF</i></span> </dt><dd class='listitem'> <p class='para'> Turns AUTOCOMMIT off. </p> </dd> <dt class='varlistentry'> <span class='term'><i>DB2_AUTOCOMMIT_ON</i></span> </dt><dd class='listitem'> <p class='para'> Turns AUTOCOMMIT on. </p> </dd> </dl> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.db2-autocommit.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> When <b>db2_autocommit()</b> receives only the <i><tt class='parameter'>connection</tt></i> parameter, it returns the current state of AUTOCOMMIT for the requested connection as an integer value. A value of 0 indicates that AUTOCOMMIT is off, while a value of 1 indicates that AUTOCOMMIT is on. </p> <p class='para'> When <b>db2_autocommit()</b> receives both the <i><tt class='parameter'>connection</tt></i> parameter and <i><tt class='parameter'>autocommit</tt></i> parameter, it attempts to set the AUTOCOMMIT state of the requested connection to the corresponding state. Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='function.db2-autocommit.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Retrieving the AUTOCOMMIT value for a connection</b></p> <div class='example-contents para'><p> In the following example, a connection which has been created with AUTOCOMMIT turned off is tested with the <b>db2_autocommit()</b> function. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$ac&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$ac&amp;nbsp;</span><span style='color: #007700'>==&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$ac</span><span style='color: #DD0000'>&amp;nbsp;--&amp;nbsp;AUTOCOMMIT&amp;nbsp;is&amp;nbsp;off.'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$ac</span><span style='color: #DD0000'>&amp;nbsp;--&amp;nbsp;AUTOCOMMIT&amp;nbsp;is&amp;nbsp;on.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 0 -- AUTOCOMMIT is off. </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Setting the AUTOCOMMIT value for a connection</b></p> <div class='example-contents para'><p> In the following example, a connection which was initially created with AUTOCOMMIT turned off has its behavior changed to turn AUTOCOMMIT on. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$options&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'autocommit'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_OFF</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$conn&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$database</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$user</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$password</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$options</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Turn&amp;nbsp;AUTOCOMMIT&amp;nbsp;on<br /></span><span style='color: #0000BB'>$rc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>DB2_AUTOCOMMIT_ON</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$rc</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'Turning&amp;nbsp;AUTOCOMMIT&amp;nbsp;on&amp;nbsp;succeeded.\n'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Check&amp;nbsp;AUTOCOMMIT&amp;nbsp;state<br /></span><span style='color: #0000BB'>$ac&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>db2_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$conn</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$ac&amp;nbsp;</span><span style='color: #007700'>==&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$ac</span><span style='color: #DD0000'>&amp;nbsp;--&amp;nbsp;AUTOCOMMIT&amp;nbsp;is&amp;nbsp;off.'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;print&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$ac</span><span style='color: #DD0000'>&amp;nbsp;--&amp;nbsp;AUTOCOMMIT&amp;nbsp;is&amp;nbsp;on.'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Turning AUTOCOMMIT on succeeded. 1 -- AUTOCOMMIT is on. </pre></div> </div> </div><p> </p> </div> <a name='function.db2-autocommit.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> </p><ul class='simplelist'> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-connect.php' class='function' rel='rdfs-seeAlso'>db2_connect()</a> - Returns a connection to a database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.db2-pconnect.php' class='function' rel='rdfs-seeAlso'>db2_pconnect()</a> - Returns a persistent connection to a database</li> </ul><p> </p> </div> </div><div class='copyright-info'>PHP Documentation is licensed under the <a class='copyright-url' href='http://creativecommons.org/licenses/by/3.0/legalcode'>Creative Commons  Attribution 3.0 License</a>. &copy; 2001-2009 the PHP  Documentation Group.</div> " />
</strings>

