<strings>
<string id="mysql_unbuffered_query" value="<div id='function.mysql-unbuffered-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-unbuffered-query.php'>mysql_unbuffered_query</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_unbuffered_query</span> &amp;mdash; <span class='dc-title'> Envia uma query para o MySQL, sem retornar e colocar em buffer as linhas do resultado </span></p> </div> <a name='function.mysql-unbuffered-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>mysql_unbuffered_query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> <b>mysql_unbuffered_query()</b> envia uma <i><tt class='parameter'>query</tt></i> SQL para MySQL, sem retornar e colocar em buffer as linhas do resultado automaticamente, como <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> faz. por um lado, isto salva uma quantidade consider&amp;aacute;vel de mem&amp;oacute;ria em query que produzem um resultado grandes. por outro lado, voc&amp;ecirc; pode come&amp;ccedil;&amp;atilde;r a trbalhar com o resultado imediatamente ap&amp;oacute;s a primeira linha ser retornada: voc&amp;ecirc; n&amp;atilde;o tem que esperar que toda a query SQL seja realizada. Quando usar multiplas conex&amp;otilde;es com o banco de dados, voc&amp;ecirc; deve especificar o parametro opcional <i><tt class='parameter'>link_identifier</tt></i> . </p> <blockquote><p><b class='note'>Nota</b>: Os beneficios de <b>mysql_unbuffered_query()</b> vem com um custo: voc&amp;ecirc; n&amp;atilde;o pode usar <a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function'>mysql_num_rows()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-data-seek.php' class='function'>mysql_data_seek()</a> no resultado retornado por <b>mysql_unbuffered_query()</b>. Voc&amp;ecirc; tamb&amp;eacute;m tem que pegar todas as linhas de uma query SQL sem buffer antes de poder enviar uma nova query SQL para o MySQL. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_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="mysql_thread_id" value="<div id='function.mysql-thread-id' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-thread-id.php'>mysql_thread_id</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_thread_id</span> &amp;mdash; <span class='dc-title'>Returna o ID da thread atual</span></p> </div> <a name='function.mysql-thread-id.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>mysql_thread_id</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> <b>mysql_thread_id()</b> retorna o ID da thread atual. Se a conex&amp;atilde;o for perdida e voc&amp;ecirc; reconectar com <a href='http://www.php.net/manual/pt_BR/function.mysql-ping.php' class='function'>mysql_ping()</a>, o ID da thread ir&amp;aacute; muda. Isto indica que voc&amp;ecirc; n&amp;atilde;o deve guardar o pegar ID e guarda-lo para depois. Voc&amp;ecirc; deve pega-lo quando voc&amp;ecirc; precisar dele. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_thread_id()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$thread_id&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_thread_id</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$thread_id</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'>'current&amp;nbsp;thread&amp;nbsp;id&amp;nbsp;is&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$thread_id</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 deve produzir a seguinte sa&amp;iacute;da: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> current thread id is 73 </pre></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.mysql-ping.php' class='function'>mysql_ping()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-list-processes.php' class='function'>mysql_list_processes()</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="mysql_tablename" value="<div id='function.mysql-tablename' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-tablename.php'>mysql_tablename</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_tablename</span> &amp;mdash; <span class='dc-title'>Retorna o nome da tabela do campo</span></p> </div> <a name='function.mysql-tablename.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>mysql_tablename</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'>$i</tt></span> )</div> <p class='para rdfs-comment'> <b>mysql_tablename()</b> usa um ponteiro de resultado retornado por <a href='http://www.php.net/manual/pt_BR/function.mysql-list-tables.php' class='function'>mysql_list_tables()</a> ou um &amp;iacute;ndice inteiro e retorna o nome da tabela A fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function'>mysql_num_rows()</a> pode ser usada para determinar o n&amp;uacute;mero de tabelas no ponteiro do resultado. Use a fun&amp;ccedil;&amp;atilde;o <b>mysql_tablename()</b> para transpor o resultado, ou qualquer fun&amp;ccedil;&amp;atilde;o para pegar o resultado como <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>. </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_tablename()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</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'>mysql_list_tables</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br />for&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'>;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_rows</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;echo&amp;nbsp;</span><span style='color: #DD0000'>'Table:&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_tablename</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;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</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> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.mysql-list-tables.php' class='function'>mysql_list_tables()</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="mysql_stat" value="<div id='function.mysql-stat' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-stat.php'>mysql_stat</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_stat</span> &amp;mdash; <span class='dc-title'>Retorna o status atual do sistema</span></p> </div> <a name='function.mysql-stat.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>mysql_stat</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> <b>mysql_stat()</b> returna o status atual do servidor. </p> <blockquote><p><b class='note'>Nota</b>: <b>mysql_stat()</b> atualmente retorna somente o satus para uptime, threads, queries, open tables, flush tables e queries por segundos. Para uma lista completa de outras vari&amp;aacute;veis de staus voc&amp;ecirc; tem que usar o comando SQL SHOW STATUS. <br /> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_stat()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$status&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>explode</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'&amp;nbsp;&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_stat</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$status</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 produzir a seguinte sa&amp;iacute;da: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> Array ( [0] =&amp;gt; Uptime: 5380 [1] =&amp;gt; Threads: 2 [2] =&amp;gt; Questions: 1321299 [3] =&amp;gt; Slow queries: 0 [4] =&amp;gt; Opens: 26 [5] =&amp;gt; Flush tables: 1 [6] =&amp;gt; Open tables: 17 [7] =&amp;gt; Queries per second avg: 245.595 ) </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="mysql_set_charset" value="<div id='function.mysql-set-charset' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-set-charset.php'>mysql_set_charset</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.3)</p><p class='refpurpose'><span class='refname'>mysql_set_charset</span> &amp;mdash; <span class='dc-title'>Sets the client character set</span></p> </div> <a name='function.mysql-set-charset.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>mysql_set_charset</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Sets the default character set for the current connection. </p> </div> <a name='function.mysql-set-charset.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'>charset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A valid character set name. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-set-charset.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.mysql-set-charset.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function requires MySQL 5.0.7 or later. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: This is the preferred way to change the charset. Using <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> to execute <i>SET NAMES ..</i> is not recommended. <br /> </p></blockquote> </div> <a name='function.mysql-set-charset.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.mysql-client-encoding.php' class='function' rel='rdfs-seeAlso'>mysql_client_encoding()</a> - Retorna o nome do conjunto de caracteres</li> <li class='member'><a href='http://dev.mysql.com/doc/refman/5.1/en/charset-charsets.html' class='link external'>&amp;raquo; List of character sets that MySQL supports</a></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="mysql_select_db" value="<div id='function.mysql-select-db' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-select-db.php'>mysql_select_db</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_select_db</span> &amp;mdash; <span class='dc-title'>Seleciona um banco de dados MySQL</span></p> </div> <a name='function.mysql-select-db.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>mysql_select_db</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$database_name</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$ link_identifier </tt></span> ] )</div> <p class='para rdfs-comment'> 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'> <b>mysql_select_db()</b> define o banco de dados ativo no servidor que &amp;eacute; associado ao identificador de conex&amp;atilde;o(link_identifier) especificado. Se nenhum identificador de conex&amp;atilde;o &amp;eacute; especificado, a ultima conex&amp;atilde;o aberta &amp;eacute; assumida. Se nenhuma conex&amp;atilde;o esta aberta, a fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; tentar abrir uma conex&amp;atilde;o como se <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos e usa-la. </p> <p class='para'> Todas as pr&amp;oacute;ximas chamadas a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> ser&amp;atilde;o feitas no banco de dados ativo. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_select_db()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Not&amp;nbsp;connected&amp;nbsp;:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;make&amp;nbsp;foo&amp;nbsp;the&amp;nbsp;current&amp;nbsp;db<br /></span><span style='color: #0000BB'>$db_selected&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'foo'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$db_selected</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die&amp;nbsp;(</span><span style='color: #DD0000'>'Can\'t&amp;nbsp;use&amp;nbsp;foo&amp;nbsp;:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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.mysql-connect.php' class='function'>mysql_connect()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-pconnect.php' class='function'>mysql_pconnect()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>. </p> <p class='para'> Para compatibilidade com vers&amp;otilde;es anteriores <b>mysql_selectdb()</b> tamb&amp;eacute;m pode ser usada. Esta fun&amp;ccedil;&amp;atilde;o esta obsoleta. </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="mysql_result" value="<div id='function.mysql-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-result.php'>mysql_result</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_result</span> &amp;mdash; <span class='dc-title'>Retorna dados do resultado</span></p> </div> <a name='function.mysql-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>mysql_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>mysql_result()</b> retorna o conte&amp;uacute;do de uma c&amp;eacute;lula do resultado MySQL. O argumento field(campo) pode ser o &amp;iacute;ndice do campo, o nome do campo, o a tabela ponto o nome do campo(tabela.campo). Se o nome da coluna usa apelido (&amp;#039;select foo as bar from...&amp;#039;), use o apelido ao inv&amp;eacute;s do nome da coluna. </p> <p class='para'> Quando trabalhando com um grande conjunto de resultado, voc&amp;ecirc; deve considerar o uso de uma das fun&amp;ccedil;&amp;otilde;es que retornam toda a linha(especificadas abaixo). Estas fun&amp;ccedil;&amp;otilde;es retornam o conte&amp;uacute;do de multiplas c&amp;eacute;lulas em uma chamada de fun&amp;ccedil;&amp;atilde;o, elas s&amp;atilde;o MUITO mais rapidas do que <b>mysql_result()</b>. Tamb&amp;eacute;m note que especificar um &amp;iacute;ndice do campo &amp;eacute; muito mais rapido do que especificar o nome do campo ou tabela.campo. </p> <p class='para'> Chamadas a <b>mysql_result()</b> n&amp;atilde;o devem ser misturadas com chamadas a outras fun&amp;ccedil;&amp;otilde;es que lidam com o conjunto de resultados. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_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 />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;work.employee'</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;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;query:'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_result</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: #FF8000'>//&amp;nbsp;outputs&amp;nbsp;third&amp;nbsp;employee's&amp;nbsp;name<br /><br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Alternativas de alta performance recomendadas: <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function'>mysql_fetch_assoc()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-object.php' class='function'>mysql_fetch_object()</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="mysql_real_escape_string" value="<div id='function.mysql-real-escape-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-real-escape-string.php'>mysql_real_escape_string</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_real_escape_string</span> &amp;mdash; <span class='dc-title'> Escapa os caracteres especiais numa string para usar em um comando SQL, levando em conta o conjunto atual de caracteres. </span></p> </div> <a name='function.mysql-real-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>mysql_real_escape_string</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$unescaped_string</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; escapar os caracteres especiais em <i><tt class='parameter'>unescaped_string</tt></i> , levando em conta o atual conjunto de caracteres da conex&amp;atilde;o, assim &amp;eacute; seguro coloca-la em <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'> <b>mysql_real_escape_string()</b> n&amp;atilde;o escapa <i>%</i> e <i>_</i>. </span> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_real_escape_string()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>$item&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Zak's&amp;nbsp;and&amp;nbsp;Derick's&amp;nbsp;Laptop'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$escaped_item&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_real_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$item</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Escaped&amp;nbsp;string:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$escaped_item</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 produzir a seguinte sa&amp;iacute;da: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> Escaped string: Zak\&amp;#039;s and Derick\&amp;#039;s Laptop </pre></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.mysql-escape-string.php' class='function'>mysql_escape_string()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-client-encoding.php' class='function'>mysql_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="mysql_query" value="<div id='function.mysql-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-query.php'>mysql_query</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_query</span> &amp;mdash; <span class='dc-title'>Envia uma consulta MySQL</span></p> </div> <a name='function.mysql-query.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>mysql_query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> <b>mysql_query()</b> envia uma consulta (para o banco de dados atualmente ativo no servidor associado ao <i><tt class='parameter'>link_identifier</tt></i> especificado). </p> </div> <a name='function.mysql-query.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'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A consulta SQL. </p> <p class='para'> A consulta n&amp;atilde;o deve terminar com um ponto e v&amp;iacute;rgula. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-query.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Para comandos SELECT, SHOW, DESCRIBE ou EXPLAIN, <b>mysql_query()</b> retorna um <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> Para outros tipos de consultas SQL, UPDATE, DELETE, DROP, etc, <b>mysql_query()</b> retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em caso de erro. </p> <p class='para'> O recurso de resultado retornado pode ser passado para <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>, e outras fun&amp;ccedil;&amp;otilde;es para manipular tabelas de resultados, para acessar os dados retornados. </p> <p class='para'> Use <a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function'>mysql_num_rows()</a> para obter quantas linhas foram retornadas para um comando SELECT ou <a href='http://www.php.net/manual/pt_BR/function.mysql-affected-rows.php' class='function'>mysql_affected_rows()</a> para obter quantas linhas foram afetadas por um comando DELETE, INSERT, REPLACE, ou UPDATE. </p> <p class='para'> <b>mysql_query()</b> ir&amp;aacute; tamb&amp;eacute;m falhar e retornar <b><tt class='constant'>FALSE</tt></b> se o usu&amp;aacute;rio n&amp;atilde;o tiver permiss&amp;otilde;es para acessar a tabela(s) referenciadas pela consulta. </p> </div> <a name='function.mysql-query.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Consulta Inv&amp;aacute;lida</b></p> <div class='example-contents para'><p> A seguinte consulta &amp;eacute; sintaticamente inv&amp;aacute;lida, assim <b>mysql_query()</b> falha e retorna <b><tt class='constant'>FALSE</tt></b>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;WHERE&amp;nbsp;1=1'</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;die(</span><span style='color: #DD0000'>'Invalid&amp;nbsp;query:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'> </p><div class='example'> <p><b>Exemplo #2 Consulta v&amp;aacute;lida</b></p> <div class='example-contents para'><p> A seguinte consulta &amp;eacute; v&amp;aacute;lida, assim <b>mysql_query()</b> retorna um <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a>. </p></div> <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;could&amp;nbsp;be&amp;nbsp;supplied&amp;nbsp;by&amp;nbsp;a&amp;nbsp;user,&amp;nbsp;for&amp;nbsp;example<br /></span><span style='color: #0000BB'>$firstname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'fred'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$lastname&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'fox'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Formulate&amp;nbsp;Query<br />//&amp;nbsp;This&amp;nbsp;is&amp;nbsp;the&amp;nbsp;best&amp;nbsp;way&amp;nbsp;to&amp;nbsp;perform&amp;nbsp;a&amp;nbsp;SQL&amp;nbsp;query<br />//&amp;nbsp;For&amp;nbsp;more&amp;nbsp;examples,&amp;nbsp;see&amp;nbsp;mysql_real_escape_string()<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>sprintf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;firstname,&amp;nbsp;lastname,&amp;nbsp;address,&amp;nbsp;age&amp;nbsp;FROM&amp;nbsp;friends&amp;nbsp;WHERE&amp;nbsp;firstname='%s'&amp;nbsp;AND&amp;nbsp;lastname='%s''</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysql_real_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$firstname</span><span style='color: #007700'>),<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysql_real_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$lastname</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Perform&amp;nbsp;Query<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Check&amp;nbsp;result<br />//&amp;nbsp;This&amp;nbsp;shows&amp;nbsp;the&amp;nbsp;actual&amp;nbsp;query&amp;nbsp;sent&amp;nbsp;to&amp;nbsp;MySQL,&amp;nbsp;and&amp;nbsp;the&amp;nbsp;error.&amp;nbsp;Useful&amp;nbsp;for&amp;nbsp;debugging.<br /></span><span style='color: #007700'>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;</span><span style='color: #0000BB'>$message&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Invalid&amp;nbsp;query:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'>$message&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'Whole&amp;nbsp;query:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #0000BB'>$message</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Use&amp;nbsp;result<br />//&amp;nbsp;Attempting&amp;nbsp;to&amp;nbsp;print&amp;nbsp;$result&amp;nbsp;won't&amp;nbsp;allow&amp;nbsp;access&amp;nbsp;to&amp;nbsp;information&amp;nbsp;in&amp;nbsp;the&amp;nbsp;resource<br />//&amp;nbsp;One&amp;nbsp;of&amp;nbsp;the&amp;nbsp;mysql&amp;nbsp;result&amp;nbsp;functions&amp;nbsp;must&amp;nbsp;be&amp;nbsp;used<br />//&amp;nbsp;See&amp;nbsp;also&amp;nbsp;mysql_result(),&amp;nbsp;mysql_fetch_array(),&amp;nbsp;mysql_fetch_row(),&amp;nbsp;etc.<br /></span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_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;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'firstname'</span><span style='color: #007700'>];<br />&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'>'lastname'</span><span style='color: #007700'>];<br />&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'>'address'</span><span style='color: #007700'>];<br />&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'>'age'</span><span style='color: #007700'>];<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Free&amp;nbsp;the&amp;nbsp;resources&amp;nbsp;associated&amp;nbsp;with&amp;nbsp;the&amp;nbsp;result&amp;nbsp;set<br />//&amp;nbsp;This&amp;nbsp;is&amp;nbsp;done&amp;nbsp;automatically&amp;nbsp;at&amp;nbsp;the&amp;nbsp;end&amp;nbsp;of&amp;nbsp;the&amp;nbsp;script<br /></span><span style='color: #0000BB'>mysql_free_result</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> <a name='function.mysql-query.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.mysql-connect.php' class='function' rel='rdfs-seeAlso'>mysql_connect()</a> - Abre uma conex&amp;atilde;o com um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-error.php' class='function' rel='rdfs-seeAlso'>mysql_error()</a> - Retorna o texto da mensagem de erro da opera&amp;ccedil;&amp;atilde;o MySQL anterior</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-real-escape-string.php' class='function' rel='rdfs-seeAlso'>mysql_real_escape_string()</a> - Escapa os caracteres especiais numa string para usar em um comando SQL, levando em conta o conjunto atual de caracteres.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-result.php' class='function' rel='rdfs-seeAlso'>mysql_result()</a> - Retorna dados do resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_assoc()</a> - Obt&amp;eacute;m um linha do resultado como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-unbuffered-query.php' class='function' rel='rdfs-seeAlso'>mysql_unbuffered_query()</a> - Envia uma query para o MySQL, sem retornar e colocar em buffer as linhas do 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="mysql_ping" value="<div id='function.mysql-ping' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-ping.php'>mysql_ping</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_ping</span> &amp;mdash; <span class='dc-title'>pinga uma conex&amp;atilde;o com o servidor ou reconecta se n&amp;atilde;o houver conex&amp;atilde;o</span></p> </div> <a name='function.mysql-ping.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>mysql_ping</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Confere se uma conex&amp;atilde;o com um servidor esta funcionando ou n&amp;atilde;o. Se ela tiver ca&amp;iacute;do, tenta realizar uma conex&amp;atilde;o automatica. Esta fun&amp;ccedil;&amp;atilde;o pode ser usada em scripts que permanecem inativos por um longo tempo, para conferir se o servidor fechou ou n&amp;atilde;o a conex&amp;atilde;o e reconectar se necess&amp;aacute;rio. </p> <blockquote><p><b class='note'>Nota</b>: Desde o MySQL 5.0.13, o recurso de autom&amp;aacute;tica reconex&amp;atilde;o est&amp;aacute; desabilitada. <br /> </p></blockquote> </div> <a name='function.mysql-ping.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'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-ping.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se a conex&amp;atilde;o com o servidor MySQL esta funcionando, se n&amp;atilde;o retorna <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mysql-ping.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_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 />set_time_limit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</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'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysqluser'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mypass'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$db&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Assuming&amp;nbsp;this&amp;nbsp;query&amp;nbsp;will&amp;nbsp;take&amp;nbsp;a&amp;nbsp;long&amp;nbsp;time&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$sql</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'>'Query&amp;nbsp;#1&amp;nbsp;failed,&amp;nbsp;exiting.'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Make&amp;nbsp;sure&amp;nbsp;the&amp;nbsp;connection&amp;nbsp;is&amp;nbsp;still&amp;nbsp;alive,&amp;nbsp;if&amp;nbsp;not,&amp;nbsp;try&amp;nbsp;to&amp;nbsp;reconnect&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysql_ping</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;echo&amp;nbsp;</span><span style='color: #DD0000'>'Lost&amp;nbsp;connection,&amp;nbsp;exiting&amp;nbsp;after&amp;nbsp;query&amp;nbsp;#1'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /></span><span style='color: #0000BB'>mysql_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;So&amp;nbsp;the&amp;nbsp;connection&amp;nbsp;is&amp;nbsp;still&amp;nbsp;alive,&amp;nbsp;let's&amp;nbsp;run&amp;nbsp;another&amp;nbsp;query&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$sql2</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.mysql-ping.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.mysql-thread-id.php' class='function' rel='rdfs-seeAlso'>mysql_thread_id()</a> - Returna o ID da thread atual</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-list-processes.php' class='function' rel='rdfs-seeAlso'>mysql_list_processes()</a> - Lista os processos MySQL</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="mysql_pconnect" value="<div id='function.mysql-pconnect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-pconnect.php'>mysql_pconnect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_pconnect</span> &amp;mdash; <span class='dc-title'>Abre uma conex&amp;atilde;o persistente com um servidor MySQL</span></p> </div> <a name='function.mysql-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>mysql_pconnect</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$server</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'>int</span> <tt class='parameter'>$client_flags</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Estabelece uma conex&amp;atilde;o persistente com o servidor MySQL. </p> <p class='para'> <b>mysql_pconnect()</b> funciona muito parecido com <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> com duas maiores diferen&amp;ccedil;as. </p> <p class='para'> Primeiro, ao conectar,a fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; primeiro tentar encontrar uma conex&amp;atilde;o(persistente) que j&amp;aacute; esteja aberta com o mesmo servidor, nome de usu&amp;aacute;rio e senha. Se uma for encontrada, um identificador para ela ser&amp;aacute; retornado ao inv&amp;eacute;s de abrir uma nova conex&amp;atilde;o. </p> <p class='para'> Segundo, a conex&amp;atilde;o ao servidor SQL n&amp;atilde;o ser&amp;aacute; fechada quando a execu&amp;ccedil;&amp;atilde;o do script terminar. Ao inv&amp;eacute;s, a conex&amp;atilde;o permanecer&amp;aacute; aberta para uso futuro (<a href='http://www.php.net/manual/pt_BR/function.mysql-close.php' class='function'>mysql_close()</a> n&amp;atilde;o ir&amp;aacute; fechar conex&amp;otilde;es estabelecidas por <b>mysql_pconnect()</b>). </p> <p class='para'> Este tipo de conex&amp;atilde;o portanto &amp;eacute; chamada &amp;#039;persistente&amp;#039;. </p> </div> <a name='function.mysql-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'>server</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O servidor MySQL. Tamb&amp;eacute;m pode incluir um numero de porta. exemplo &amp;quot;hostname:port&amp;quot; ou um caminho para um socket local exemplo &amp;quot;:/path/to/socket&amp;quot; para o servidor local. </p> <p class='para'> Se a diretiva do PHP <a href='http://www.php.net/manual/pt_BR/mysql.configuration.php#ini.mysql.default-host' class='link'> mysql.default_host</a> n&amp;atilde;o estiver definida (padr&amp;atilde;o), ent&amp;atilde;o o valor padr&amp;atilde;o &amp;eacute; &amp;#039;localhost:3306&amp;#039; </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>username</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome de usu&amp;aacute;rio. O Valor padr&amp;atilde;o &amp;eacute; o nome do usu&amp;aacute;rio que &amp;eacute; o propriet&amp;aacute;rio do processo do servidor. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A senha. O valor padr&amp;atilde;o &amp;eacute; uma senha vazia. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>client_flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O par&amp;acirc;metro <i><tt class='parameter'>client_flags</tt></i> pode ser uma combina&amp;ccedil;&amp;atilde;o das seguintes constantes: 128 (habilita manuseador <i>LOAD DATA LOCAL</i>), <b><tt class='constant'>MYSQL_CLIENT_SSL</tt></b>, <b><tt class='constant'>MYSQL_CLIENT_COMPRESS</tt></b>, <b><tt class='constant'>MYSQL_CLIENT_IGNORE_SPACE</tt></b> ou <b><tt class='constant'>MYSQL_CLIENT_INTERACTIVE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-pconnect.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de conex&amp;atilde;o persistente MySQL em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-pconnect.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.0</td> <td align='left'> Adicionado o par&amp;acirc;metro <i><tt class='parameter'>client_flags</tt></i> . </td> </tr> <tr valign='middle'> <td align='left'>3.0.10</td> <td align='left'> Adicionado o suporte a &amp;quot;:/path/to/socket&amp;quot; com <i><tt class='parameter'>server</tt></i> . </td> </tr> <tr valign='middle'> <td align='left'>3.0.0</td> <td align='left'> Adicionado o suporte a &amp;quot;:port&amp;quot; com <i><tt class='parameter'>server</tt></i> . </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mysql-pconnect.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Note que este tipo de conex&amp;atilde;o funciona somente se voc&amp;ecirc; estiver usando uma vers&amp;atilde;o do PHP como m&amp;oacute;dulo. Veja a sess&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/features.persistent-connections.php' class='link'>Conex&amp;otilde;es Persistentes com Banco de Dados</a> para maiores informa&amp;ccedil;&amp;otilde;es. <br /> </p></blockquote> <div class='warning'><b class='warning'>Aviso</b> <p class='para'> Usar conex&amp;otilde;es persistentes podem requerer alguns ajustes na suas configura&amp;ccedil;&amp;otilde;es do Apache e do MySQL para ter certeza que voc&amp;ecirc; n&amp;atilde;o exceda o limite de conex&amp;otilde;es permitidas pelo MySQL. </p> </div> <blockquote><p><b class='note'>Nota</b>: Voc&amp;ecirc; pode suprimir a mensagem de erro em caso de falha adicionando <a href='http://www.php.net/manual/pt_BR/language.operators.errorcontrol.php' class='link'>@</a> ao nome da fun&amp;ccedil;&amp;atilde;o. <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-connect.php' class='function' rel='rdfs-seeAlso'>mysql_connect()</a> - Abre uma conex&amp;atilde;o com um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/features.persistent-connections.php' class='link'>Conex&amp;otilde;es Persistentes com Banco de Dados</a></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="mysql_num_rows" value="<div id='function.mysql-num-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-num-rows.php'>mysql_num_rows</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_num_rows</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o n&amp;uacute;mero de linhas em um resultado</span></p> </div> <a name='function.mysql-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>mysql_num_rows</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o numero de linhas de um conjunto de resultados. Este comando &amp;eacute; valido apenas para comandos como SELECT ou SHOW que atualmente retornam um conjunto de resultados. Para obter o numero de linhas afetadas por uma consulta INSERT, UPDATE, REPLACE ou DELETE, use <a href='http://www.php.net/manual/pt_BR/function.mysql-affected-rows.php' class='function'>mysql_affected_rows()</a>. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-num-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O numero de linhas em um conjunto de resultados em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-num-rows.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_num_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 /><br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'database'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;table1'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$num_rows&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$num_rows</span><span style='color: #DD0000'>&amp;nbsp;Rows\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.mysql-num-rows.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Se voc&amp;ecirc; usar <a href='http://www.php.net/manual/pt_BR/function.mysql-unbuffered-query.php' class='function'>mysql_unbuffered_query()</a>, <b>mysql_num_rows()</b> n&amp;atilde;o ir&amp;aacute; retornar o valor correto at&amp;eacute; que todas as linhas no conjunto de resultado tenham sido obtidas. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_numrows()</b> <br /> </p></blockquote> </div> <a name='function.mysql-num-rows.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.mysql-affected-rows.php' class='function' rel='rdfs-seeAlso'>mysql_affected_rows()</a> - Obt&amp;eacute;m o n&amp;uacute;mero de linhas atingidas na opera&amp;ccedil;&amp;atilde;o anterior do MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function' rel='rdfs-seeAlso'>mysql_connect()</a> - Abre uma conex&amp;atilde;o com um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-data-seek.php' class='function' rel='rdfs-seeAlso'>mysql_data_seek()</a> - Move o ponteiro interno do resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-select-db.php' class='function' rel='rdfs-seeAlso'>mysql_select_db()</a> - Seleciona um banco de dados MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</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="mysql_num_fields" value="<div id='function.mysql-num-fields' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-num-fields.php'>mysql_num_fields</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_num_fields</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o numero de campos em um resultado</span></p> </div> <a name='function.mysql-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>mysql_num_fields</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o numero de campos de uma consulta. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-num-fields.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o numero de capos em um conjunto de resultados <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-num-fields.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_num_fields()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,email&amp;nbsp;FROM&amp;nbsp;people&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;'42''</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'>'Could&amp;nbsp;not&amp;nbsp;run&amp;nbsp;query:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;returns&amp;nbsp;2&amp;nbsp;because&amp;nbsp;id,email&amp;nbsp;===&amp;nbsp;two&amp;nbsp;fields&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_fields</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> <a name='function.mysql-num-fields.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_numfields()</b> <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-select-db.php' class='function' rel='rdfs-seeAlso'>mysql_select_db()</a> - Seleciona um banco de dados MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-field.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_field()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre uma coluna de um resultado e retorna como um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function' rel='rdfs-seeAlso'>mysql_num_rows()</a> - Obt&amp;eacute;m o 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="mysql_list_tables" value="<div id='function.mysql-list-tables' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-list-tables.php'>mysql_list_tables</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_list_tables</span> &amp;mdash; <span class='dc-title'>Lista as tabelas em um banco de dados MySQL</span></p> </div> <a name='function.mysql-list-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>mysql_list_tables</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$database</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m uma lista dos nomes das tabelas de um banco de dados MySQL. </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o esta obsoleta. &amp;Eacute; preferr&amp;iacute;vel usar <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> para fazer uma consulta SQL <i>SHOW TABLES [FROM db_name] [LIKE &amp;#039;pattern&amp;#039;]</i> ao inv&amp;eacute;s. </p> </div> <a name='function.mysql-list-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'>database</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do banco de dados </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-list-tables.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um ponteiro do tipo resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> Use a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-tablename.php' class='function'>mysql_tablename()</a> para lidar com este ponteiro de resultado, ou qualquer fun&amp;ccedil;&amp;atilde;o para tabelas de resultado, como <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>. </p> </div> <a name='function.mysql-list-tables.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo alternativo de <b>mysql_list_tables()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$dbname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'mysql_dbname'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mysql_host'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;mysql'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$sql&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SHOW&amp;nbsp;TABLES&amp;nbsp;FROM&amp;nbsp;</span><span style='color: #0000BB'>$dbname</span><span style='color: #DD0000'>'</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /><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'>'DB&amp;nbsp;Error,&amp;nbsp;could&amp;nbsp;not&amp;nbsp;list&amp;nbsp;tables\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'MySQL&amp;nbsp;Error:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'>mysql_fetch_row</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;echo&amp;nbsp;</span><span style='color: #DD0000'>'Table:&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'>\n'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</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> <a name='function.mysql-list-tables.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_listtables()</b> <br /> </p></blockquote> </div> <a name='function.mysql-list-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.mysql-list-dbs.php' class='function' rel='rdfs-seeAlso'>mysql_list_dbs()</a> - Lista os bancos de dados dispon&amp;iacute;veis em um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-tablename.php' class='function' rel='rdfs-seeAlso'>mysql_tablename()</a> - Retorna o nome da tabela do 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="mysql_list_processes" value="<div id='function.mysql-list-processes' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-list-processes.php'>mysql_list_processes</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_list_processes</span> &amp;mdash; <span class='dc-title'>Lista os processos MySQL</span></p> </div> <a name='function.mysql-list-processes.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>mysql_list_processes</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m as threads atuais do servidor MySQL. </p> </div> <a name='function.mysql-list-processes.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'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-list-processes.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um ponteiro de resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-list-processes.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_list_processes()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_list_processes</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>mysql_fetch_assoc</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;%s&amp;nbsp;%s&amp;nbsp;%s&amp;nbsp;%s\n'</span><span style='color: #007700'>,&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'>'Host'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'db'</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'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'Command'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'Time'</span><span style='color: #007700'>]);<br />}<br /></span><span style='color: #0000BB'>mysql_free_result</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 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> 1 localhost test Processlist 0 4 localhost mysql sleep 5 </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-list-processes.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.mysql-thread-id.php' class='function' rel='rdfs-seeAlso'>mysql_thread_id()</a> - Returna o ID da thread atual</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-stat.php' class='function' rel='rdfs-seeAlso'>mysql_stat()</a> - Retorna o status atual do sistema</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="mysql_list_fields" value="<div id='function.mysql-list-fields' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-list-fields.php'>mysql_list_fields</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_list_fields</span> &amp;mdash; <span class='dc-title'>Lista os campos de uma tabela MySQL</span></p> </div> <a name='function.mysql-list-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'>resource</span> <span class='methodname'><b>mysql_list_fields</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$database_name</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$table_name</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre o nome de tabela dado. </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o esta obsoleta. &amp;Eacute; preferr&amp;iacute;vel usar <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> para realizar uma consulta SQL <i>SHOW COLUMNS FROM table [LIKE &amp;#039;name&amp;#039;]</i> ao inv&amp;eacute;s. </p> </div> <a name='function.mysql-list-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'>database_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do banco de dados que esta sendo consultado. </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 que esta sendo consultada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-list-fields.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um ponteiro de recurso <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> O ponteiro de resultado pode ser usado com <a href='http://www.php.net/manual/pt_BR/function.mysql-field-flags.php' class='function'>mysql_field_flags()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-field-len.php' class='function'>mysql_field_len()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-field-name.php' class='function'>mysql_field_name()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-field-type.php' class='function'>mysql_field_type()</a>. </p> </div> <a name='function.mysql-list-fields.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Alternativa para o obsoleto <b>mysql_list_fields()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SHOW&amp;nbsp;COLUMNS&amp;nbsp;FROM&amp;nbsp;sometable'</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'>'Could&amp;nbsp;not&amp;nbsp;run&amp;nbsp;query:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysql_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>0</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'>mysql_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;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>print_r</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 />}<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> Array ( [Field] =&amp;gt; id [Type] =&amp;gt; int(7) [Null] =&amp;gt; [Key] =&amp;gt; PRI [Default] =&amp;gt; [Extra] =&amp;gt; auto_increment ) Array ( [Field] =&amp;gt; email [Type] =&amp;gt; varchar(100) [Null] =&amp;gt; [Key] =&amp;gt; [Default] =&amp;gt; [Extra] =&amp;gt; ) </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-list-fields.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_listfields()</b> <br /> </p></blockquote> </div> <a name='function.mysql-list-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.mysql-field-flags.php' class='function' rel='rdfs-seeAlso'>mysql_field_flags()</a> - Obt&amp;eacute;m as flags associadas ao campo especificado em um resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-info.php' class='function' rel='rdfs-seeAlso'>mysql_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre a consulta mais recente</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="mysql_list_dbs" value="<div id='function.mysql-list-dbs' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-list-dbs.php'>mysql_list_dbs</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_list_dbs</span> &amp;mdash; <span class='dc-title'>Lista os bancos de dados dispon&amp;iacute;veis em um servidor MySQL</span></p> </div> <a name='function.mysql-list-dbs.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>mysql_list_dbs</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna um ponteiro de resultado contendo od banco de dados dispon&amp;iacute;veis atualmente no servidor MySQL. </p> </div> <a name='function.mysql-list-dbs.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'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-list-dbs.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um ponteiro de resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. Use a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-tablename.php' class='function'>mysql_tablename()</a> para lidar com este ponteiro de resultado, ou qualquer fun&amp;ccedil;&amp;atilde;o para tabelas com resultados, como <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>. </p> </div> <a name='function.mysql-list-dbs.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_list_dbs()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$db_list&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_list_dbs</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>mysql_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db_list</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'>-&amp;gt;</span><span style='color: #0000BB'>Database&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'>?&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> database1 database2 database3 </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-list-dbs.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_listdbs()</b> <br /> </p></blockquote> </div> <a name='function.mysql-list-dbs.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.mysql-db-name.php' class='function' rel='rdfs-seeAlso'>mysql_db_name()</a> - Obt&amp;eacute;m dados do resultado(nome de banco de dados)</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-select-db.php' class='function' rel='rdfs-seeAlso'>mysql_select_db()</a> - Seleciona um banco de dados MySQL</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="mysql_insert_id" value="<div id='function.mysql-insert-id' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-insert-id.php'>mysql_insert_id</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_insert_id</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o ID gerado pela opera&amp;ccedil;&amp;atilde;o INSERT anterior</span></p> </div> <a name='function.mysql-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>mysql_insert_id</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o ID gerado para uma coluna AUTO_INCREMENT pela consulta INSERT anterior. </p> </div> <a name='function.mysql-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-insert-id.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O ID gerado para uma coluna AUTO_INCREMENT pela consulta INSERT anterior em caso de sucesso, <i>0</i> se a consulta anterior n&amp;atilde;o gerou um valor AUTO_INCREMENT, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o foi estabelecida a conex&amp;atilde;o com o MySQL. </p> </div> <a name='function.mysql-insert-id.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_insert_id()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;mytable&amp;nbsp;(product)&amp;nbsp;values&amp;nbsp;('kossu')'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Last&amp;nbsp;inserted&amp;nbsp;record&amp;nbsp;has&amp;nbsp;id&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_insert_id</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.mysql-insert-id.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> <b>mysql_insert_id()</b> converte o tipo de retorno nativo da API em C do MySQL <i>mysql_insert_id()</i> para um tipo <i>long</i> (chamado <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type int'>int</a> no PHP). Se a sua coluna AUTO_INCREMENT for uma coluna do tipo BIGINT, o valor retornado por <b>mysql_insert_id()</b> ser&amp;aacute; incorreto. Ao inv&amp;eacute;s, use a fun&amp;ccedil;&amp;atilde;o SQL interna do MySQL <i>LAST_INSERT_ID()</i> em uma consulta SQL. </p> </div> <blockquote><p><b class='note'>Nota</b>: Devido a <b>mysql_insert_id()</b> agir sobre a &amp;uacute;ltima consulta realizada, tenha certesa de chamar <b>mysql_insert_id()</b> imediatamente ap&amp;oacute;s a consulta que gerou o valor. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: O valor da fun&amp;ccedil;&amp;atilde;o SQL do MySQL <i>LAST_INSERT_ID()</i> sempre cont&amp;eacute;m o valor AUTO_INCREMENT mais recentemente gerado, e n&amp;atilde;o &amp;eacute; reiniciado entre as consultas. <br /> </p></blockquote> </div> <a name='function.mysql-insert-id.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.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-info.php' class='function' rel='rdfs-seeAlso'>mysql_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre a consulta mais recente</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="mysql_info" value="<div id='function.mysql-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-info.php'>mysql_info</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_info</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre a consulta mais recente</span></p> </div> <a name='function.mysql-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'>string</span> <span class='methodname'><b>mysql_info</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna informa&amp;ccedil;&amp;atilde;o detalhada sobre a &amp;uacute;ltima consulta. </p> </div> <a name='function.mysql-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna informa&amp;ccedil;&amp;atilde;o sobre o comando em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. Veja o exemplo abaixo para quais comandos prov&amp;ecirc;m informa&amp;ccedil;&amp;atilde;o, e como o valor retornado se parecer&amp;aacute;. Comandos n&amp;atilde;o listados ir&amp;atilde;o retornar <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mysql-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Comandos MySQL relevantes</b></p> <div class='example-contents para'><p> Comandos que retornam valores de string. Os n&amp;uacute;meros s&amp;atilde;o apenas para proposito de ilustra&amp;ccedil;&amp;atilde;o, os seus valores ir&amp;atilde;o corresponder a consulta. </p></div> <div class='example-contents programlisting'> <div class='mysqlcode'><pre class='mysqlcode'>INSERT INTO ... SELECT ... String format: Records: 23 Duplicates: 0 Warnings: 0 INSERT INTO ... VALUES (...),(...),(...)... String format: Records: 37 Duplicates: 0 Warnings: 0 LOAD DATA INFILE ... String format: Records: 42 Deleted: 0 Skipped: 0 Warnings: 0 ALTER TABLE String format: Records: 60 Duplicates: 0 Warnings: 0 UPDATE String format: Rows matched: 65 Changed: 65 Warnings: 0</pre> </div> </div> </div><p> </p> </div> <a name='function.mysql-info.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>mysql_info()</b> retornar&amp;aacute; um valor diferente de <b><tt class='constant'>FALSE</tt></b> para comandos INSERT ... VALUES apenas se multiplas listas de valores forem especificadas no comando. <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-affected-rows.php' class='function' rel='rdfs-seeAlso'>mysql_affected_rows()</a> - Obt&amp;eacute;m o n&amp;uacute;mero de linhas atingidas na opera&amp;ccedil;&amp;atilde;o anterior do MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-insert-id.php' class='function' rel='rdfs-seeAlso'>mysql_insert_id()</a> - Obt&amp;eacute;m o ID gerado pela opera&amp;ccedil;&amp;atilde;o INSERT anterior</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-stat.php' class='function' rel='rdfs-seeAlso'>mysql_stat()</a> - Retorna o status atual do sistema</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="mysql_get_server_info" value="<div id='function.mysql-get-server-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-get-server-info.php'>mysql_get_server_info</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_get_server_info</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</span></p> </div> <a name='function.mysql-get-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'>string</span> <span class='methodname'><b>mysql_get_server_info</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m a vers&amp;atilde;o do servidor MySQL. </p> </div> <a name='function.mysql-get-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-get-server-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a vers&amp;atilde;o do servidor MySQL em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-get-server-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_get_server_info()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'MySQL&amp;nbsp;server&amp;nbsp;version:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_get_server_info</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> MySQL server version: 4.0.1-alpha </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-get-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.mysql-get-client-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_client_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do cliente MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-host-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_host_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-proto-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_proto_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do protocolo MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.phpversion.php' class='function' rel='rdfs-seeAlso'>phpversion()</a> - Obt&amp;eacute;m a vers&amp;atilde;o atual do PHP</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="mysql_get_proto_info" value="<div id='function.mysql-get-proto-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-get-proto-info.php'>mysql_get_proto_info</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_get_proto_info</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do protocolo MySQL</span></p> </div> <a name='function.mysql-get-proto-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'>int</span> <span class='methodname'><b>mysql_get_proto_info</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o protocolo MySQL. </p> </div> <a name='function.mysql-get-proto-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-get-proto-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o protocolo MySQL em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-get-proto-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_get_proto_info()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'MySQL&amp;nbsp;protocol&amp;nbsp;version:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_get_proto_info</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> MySQL protocol version: 10 </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-get-proto-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.mysql-get-client-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_client_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do cliente MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-host-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_host_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-server-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_server_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</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="mysql_get_host_info" value="<div id='function.mysql-get-host-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-get-host-info.php'>mysql_get_host_info</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_get_host_info</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</span></p> </div> <a name='function.mysql-get-host-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'>string</span> <span class='methodname'><b>mysql_get_host_info</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Descreve o tipo de conex&amp;atilde;o em uso para a conex&amp;atilde;o, incluindo o nome do servidor. </p> </div> <a name='function.mysql-get-host-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-get-host-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma string descrevendo o tipo da conex&amp;atilde;o MySQL em uso para a conex&amp;atilde;o, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-get-host-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_get_host_info()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Could&amp;nbsp;not&amp;nbsp;connect:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'MySQL&amp;nbsp;host&amp;nbsp;info:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_get_host_info</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> MySQL host info: Localhost via UNIX socket </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-get-host-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.mysql-get-client-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_client_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do cliente MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-proto-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_proto_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do protocolo MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-server-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_server_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</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="mysql_get_client_info" value="<div id='function.mysql-get-client-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-get-client-info.php'>mysql_get_client_info</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_get_client_info</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do cliente MySQL</span></p> </div> <a name='function.mysql-get-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'>string</span> <span class='methodname'><b>mysql_get_client_info</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> <b>mysql_get_client_info()</b> retorna uma string que representa a vers&amp;atilde;o da biblioteca de cliente. </p> </div> <a name='function.mysql-get-client-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A vers&amp;atilde;o do cliente MySQL. </p> </div> <a name='function.mysql-get-client-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_get_client_info()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'MySQL&amp;nbsp;client&amp;nbsp;info:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_get_client_info</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> MySQL client info: 3.23.39 </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-get-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.mysql-get-host-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_host_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-proto-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_proto_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do protocolo MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-get-server-info.php' class='function' rel='rdfs-seeAlso'>mysql_get_server_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es do servidor MySQL</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="mysql_free_result" value="<div id='function.mysql-free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-free-result.php'>mysql_free_result</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_free_result</span> &amp;mdash; <span class='dc-title'>Libera um resultado da mem&amp;oacute;ria</span></p> </div> <a name='function.mysql-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>mysql_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>mysql_free_result()</b> ir&amp;aacute; liberar toda a mem&amp;oacute;ria associada ao identificador de resultado <i><tt class='parameter'>result</tt></i> . </p> <p class='para'> <b>mysql_free_result()</b> apenas precisa ser chamada se voc&amp;ecirc; esta preocupado sobre quanta mem&amp;oacute;ria esta sendo usada em consultas que retornam grandes conjuntos de resultados. Toda a mem&amp;oacute;ria associada a um resultado &amp;eacute; automaticamente liberada ao final da execu&amp;ccedil;&amp;atilde;o do script. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-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> <p class='para'> Se n&amp;atilde;o for usado um recurso para <i><tt class='parameter'>result</tt></i> , um erro de n&amp;iacute;vel E_WARNING ser&amp;aacute; emitido. &amp;Eacute; importante notar que <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> apena retorna um <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> para consultas SELECT, SHOW, EXPLAIN, e DESCRIBE. </p> </div> <a name='function.mysql-free-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo <b>mysql_free_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 />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,email&amp;nbsp;FROM&amp;nbsp;people&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;'42''</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'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;executar&amp;nbsp;a&amp;nbsp;consulta:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Use&amp;nbsp;the&amp;nbsp;result,&amp;nbsp;assuming&amp;nbsp;we're&amp;nbsp;done&amp;nbsp;with&amp;nbsp;it&amp;nbsp;afterwords&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Now&amp;nbsp;we&amp;nbsp;free&amp;nbsp;up&amp;nbsp;the&amp;nbsp;result&amp;nbsp;and&amp;nbsp;continue&amp;nbsp;on&amp;nbsp;with&amp;nbsp;our&amp;nbsp;script&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysql_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br />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 />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 /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mysql-free-result.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_freeresult()</b> <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-resource.php' class='function' rel='rdfs-seeAlso'>is_resource()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um 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="mysql_field_type" value="<div id='function.mysql-field-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-field-type.php'>mysql_field_type</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_field_type</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o tipo do campo especificado em um resultado</span></p> </div> <a name='function.mysql-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>mysql_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_offset</tt></span> )</div> <p class='para rdfs-comment'> <b>mysql_field_type()</b> &amp;eacute; similar a <a href='http://www.php.net/manual/pt_BR/function.mysql-field-name.php' class='function'>mysql_field_name()</a>. Os argumentos s&amp;atilde;o identicos, mas ao inv&amp;eacute;s &amp;eacute; retornado o tipo do campo. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O indice nu&amp;eacute;rico do campo. O <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. Se <i><tt class='parameter'>field_offset</tt></i> n&amp;atilde;o existir, um erro de n&amp;iacute;vel <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; emitido.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-field-type.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O tipo de campo retornado ser&amp;aacute; um de <i>&amp;quot;int&amp;quot;</i>, <i>&amp;quot;real&amp;quot;</i>, <i>&amp;quot;string&amp;quot;</i>, <i>&amp;quot;blob&amp;quot;</i>, e outros como detalhado na <a href='http://dev.mysql.com/doc/' class='link external'>&amp;raquo; documenta&amp;ccedil;&amp;atilde;o do MySQL</a>. </p> </div> <a name='function.mysql-field-type.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_field_type()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_username'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mysql'</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;func'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$fields&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_fields</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rows&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$table&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_table</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'>);<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Your&amp;nbsp;''&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$table&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>''&amp;nbsp;table&amp;nbsp;has&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$fields&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;fields&amp;nbsp;and&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$rows&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;record(s)\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'The&amp;nbsp;table&amp;nbsp;has&amp;nbsp;the&amp;nbsp;following&amp;nbsp;fields:\n'</span><span style='color: #007700'>;<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'>$fields</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'>$type&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_type</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'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$name&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_name</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'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$len&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_len</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'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$flags&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_flags</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'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$type&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$name&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$len&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$flags&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'>mysql_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysql_close</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> Your &amp;#039;func&amp;#039; table has 4 fields and 1 record(s) The table has the following fields: string name 64 not_null primary_key binary int ret 1 not_null string dl 128 not_null string type 9 not_null enum </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-field-type.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_fieldtype()</b> <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-field-name.php' class='function' rel='rdfs-seeAlso'>mysql_field_name()</a> - Obt&amp;eacute;m o nome do campo especificado em um resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-field-len.php' class='function' rel='rdfs-seeAlso'>mysql_field_len()</a> - Retorna o tamanho do campo especificado</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="mysql_field_table" value="<div id='function.mysql-field-table' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-field-table.php'>mysql_field_table</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_field_table</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o nome da tabela na qual o campo especificado esta</span></p> </div> <a name='function.mysql-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'>string</span> <span class='methodname'><b>mysql_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_offset</tt></span> )</div> <p class='para rdfs-comment'> Retorna o nome da tabela na qual o campo especificado esta. </p> </div> <a name='function.mysql-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'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O indice nu&amp;eacute;rico do campo. O <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. Se <i><tt class='parameter'>field_offset</tt></i> n&amp;atilde;o existir, um erro de n&amp;iacute;vel <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; emitido.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-field-table.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O nome da tabela em caso de sucesso. </p> </div> <a name='function.mysql-field-table.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo <b>mysql_field_table()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;account.*,&amp;nbsp;country.*&amp;nbsp;FROM&amp;nbsp;account,&amp;nbsp;country&amp;nbsp;WHERE&amp;nbsp;country.name&amp;nbsp;=&amp;nbsp;'Portugal'&amp;nbsp;AND&amp;nbsp;account.country_id&amp;nbsp;=&amp;nbsp;country.id'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;get&amp;nbsp;the&amp;nbsp;result&amp;nbsp;from&amp;nbsp;the&amp;nbsp;DB<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Lists&amp;nbsp;the&amp;nbsp;table&amp;nbsp;name&amp;nbsp;and&amp;nbsp;then&amp;nbsp;the&amp;nbsp;field&amp;nbsp;name<br /></span><span style='color: #007700'>for&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'>;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_fields</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'>$table&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_table</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'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$field&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_name</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'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$table</span><span style='color: #DD0000'>:&amp;nbsp;</span><span style='color: #0000BB'>$field</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mysql-field-table.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_fieldtable()</b> <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-list-tables.php' class='function' rel='rdfs-seeAlso'>mysql_list_tables()</a> - Lista as tabelas em um banco de dados MySQL</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="mysql_field_seek" value="<div id='function.mysql-field-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-field-seek.php'>mysql_field_seek</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_field_seek</span> &amp;mdash; <span class='dc-title'>Define o ponteiro do resultado para o &amp;iacute;ndice de campo especificado</span></p> </div> <a name='function.mysql-field-seek.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>mysql_field_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'>$field_offset</tt></span> )</div> <p class='para rdfs-comment'> Move para o &amp;iacute;ndice do campo especificado. Se a pr&amp;oacute;xima chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-field.php' class='function'>mysql_fetch_field()</a> n&amp;atilde;o incluir um &amp;iacute;ndice, o &amp;iacute;ndice de campo especificado em <b>mysql_field_seek()</b> ser&amp;aacute; retornado. </p> </div> <a name='function.mysql-field-seek.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 resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O indice nu&amp;eacute;rico do campo. O <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. Se <i><tt class='parameter'>field_offset</tt></i> n&amp;atilde;o existir, um erro de n&amp;iacute;vel <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; emitido.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-field-seek.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.mysql-field-seek.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.mysql-fetch-field.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_field()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre uma coluna de um resultado e retorna como um objeto</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="mysql_field_name" value="<div id='function.mysql-field-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-field-name.php'>mysql_field_name</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_field_name</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o nome do campo especificado em um resultado</span></p> </div> <a name='function.mysql-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>mysql_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_offset</tt></span> )</div> <p class='para rdfs-comment'> <b>mysql_field_name()</b> retorna o nome do campo do &amp;iacute;ndice especificado. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O indice nu&amp;eacute;rico do campo. O <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. Se <i><tt class='parameter'>field_offset</tt></i> n&amp;atilde;o existir, um erro de n&amp;iacute;vel <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; emitido.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-field-name.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O nome do campo do &amp;iacute;ndice especificado emj caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-field-name.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_field_name()</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;A&amp;nbsp;tabela&amp;nbsp;users&amp;nbsp;consiste&amp;nbsp;em&amp;nbsp;tr&amp;ecirc;s&amp;nbsp;campos:<br />*&amp;nbsp;&amp;nbsp;&amp;nbsp;user_id<br />*&amp;nbsp;&amp;nbsp;&amp;nbsp;username<br />*&amp;nbsp;&amp;nbsp;&amp;nbsp;password.<br />*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar&amp;nbsp;ao&amp;nbsp;servidor&amp;nbsp;MySQL:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>$dbname&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$db_selected&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dbname</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$db_selected</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;selecionar&amp;nbsp;</span><span style='color: #0000BB'>$dbname</span><span style='color: #DD0000'>:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;users'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_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'>0</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_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'>2</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> user_id password </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-field-name.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_fieldname()</b> <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-field-type.php' class='function' rel='rdfs-seeAlso'>mysql_field_type()</a> - Obt&amp;eacute;m o tipo do campo especificado em um resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-field-len.php' class='function' rel='rdfs-seeAlso'>mysql_field_len()</a> - Retorna o tamanho do campo especificado</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="mysql_field_len" value="<div id='function.mysql-field-len' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-field-len.php'>mysql_field_len</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_field_len</span> &amp;mdash; <span class='dc-title'>Retorna o tamanho do campo especificado</span></p> </div> <a name='function.mysql-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>mysql_field_len</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_offset</tt></span> )</div> <p class='para rdfs-comment'> <b>mysql_field_len()</b> retorna o tamanho do campo especificado. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O indice nu&amp;eacute;rico do campo. O <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. Se <i><tt class='parameter'>field_offset</tt></i> n&amp;atilde;o existir, um erro de n&amp;iacute;vel <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; emitido.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-field-len.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O tamanho do campo especificado em sucesso, ou <b><tt class='constant'>FALSE</tt></b> em falha. </p> </div> <a name='function.mysql-field-len.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mysql_field_len()</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 />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,email&amp;nbsp;FROM&amp;nbsp;people&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;'42''</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'>'Could&amp;nbsp;not&amp;nbsp;run&amp;nbsp;query:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Will&amp;nbsp;get&amp;nbsp;the&amp;nbsp;length&amp;nbsp;of&amp;nbsp;the&amp;nbsp;id&amp;nbsp;field&amp;nbsp;as&amp;nbsp;specified&amp;nbsp;in&amp;nbsp;the&amp;nbsp;database<br />//&amp;nbsp;schema.<br /></span><span style='color: #0000BB'>$length&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_len</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'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$length</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.mysql-field-len.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_fieldlen()</b> <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-fetch-lengths.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_lengths()</a> - Obt&amp;eacute;m o tamanho de cada sa&amp;iacute;da no resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strlen.php' class='function' rel='rdfs-seeAlso'>strlen()</a> - Retorna o tamanho de uma string</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="mysql_field_flags" value="<div id='function.mysql-field-flags' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-field-flags.php'>mysql_field_flags</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_field_flags</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m as flags associadas ao campo especificado em um resultado</span></p> </div> <a name='function.mysql-field-flags.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>mysql_field_flags</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_offset</tt></span> )</div> <p class='para rdfs-comment'> <b>mysql_field_flags()</b> retorna as flags do campo especificado. As flags s&amp;atilde;o mostradas como uma &amp;uacute;nica palavra por flag separada por um &amp;uacute;nico espa&amp;ccedil;o, assim voc&amp;ecirc; pode dividir o valor retornado usando <a href='http://www.php.net/manual/pt_BR/function.explode.php' class='function'>explode()</a>. </p> </div> <a name='function.mysql-field-flags.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 resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O indice nu&amp;eacute;rico do campo. O <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. Se <i><tt class='parameter'>field_offset</tt></i> n&amp;atilde;o existir, um erro de n&amp;iacute;vel <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; emitido.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-field-flags.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma string com as flags associadas ao resultado, ou false em caso de falha. </p> <p class='para'> As seguintes flags s&amp;atilde;o reportadas, se a sua vers&amp;atilde;o do MySQL for atual o suficiente para suporta-las: <i>&amp;quot;not_null&amp;quot;</i>, <i>&amp;quot;primary_key&amp;quot;</i>, <i>&amp;quot;unique_key&amp;quot;</i>, <i>&amp;quot;multiple_key&amp;quot;</i>, <i>&amp;quot;blob&amp;quot;</i>, <i>&amp;quot;unsigned&amp;quot;</i>, <i>&amp;quot;zerofill&amp;quot;</i>, <i>&amp;quot;binary&amp;quot;</i>, <i>&amp;quot;enum&amp;quot;</i>, <i>&amp;quot;auto_increment&amp;quot;</i> e <i>&amp;quot;timestamp&amp;quot;</i>. </p> </div> <a name='function.mysql-field-flags.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo de <b>mysql_field_flags()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,email&amp;nbsp;FROM&amp;nbsp;people&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;'42''</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'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;executar&amp;nbsp;a&amp;nbsp;consulta:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /></span><span style='color: #0000BB'>$flags&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_field_flags</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'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$flags</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>explode</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$flags</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> not_null primary_key auto_increment Array ( [0] =&amp;gt; not_null [1] =&amp;gt; primary_key [2] =&amp;gt; auto_increment ) </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-field-flags.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_fieldflags()</b> <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="mysql_fetch_row" value="<div id='function.mysql-fetch-row' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-fetch-row.php'>mysql_fetch_row</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_fetch_row</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma linha como uma array num&amp;eacute;rica</span></p> </div> <a name='function.mysql-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'>array</span> <span class='methodname'><b>mysql_fetch_row</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma array num&amp;eacute;rica que corresponde a linha obtida e move o ponteiro interno dos dados adiante. </p> </div> <a name='function.mysql-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-fetch-row.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma array num&amp;eacute;rica de strings que corresponde linha obtida, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houverem mais linhas. </p> <p class='para'> <b>mysql_fetch_row()</b> obt&amp;eacute;m uma linha de dados do resultado associado ao identificador de resultado dado. A linha &amp;eacute; retornada como um array. Cada coluna do resultado &amp;eacute; salva em um &amp;iacute;ndice da matriz, come&amp;ccedil;ando no &amp;iacute;ndice 0. </p> </div> <a name='function.mysql-fetch-row.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Obtendo uma linha com <b>mysql_fetch_row()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,email&amp;nbsp;FROM&amp;nbsp;people&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;'42''</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'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;executar&amp;nbsp;a&amp;nbsp;consulta:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br />echo&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: #FF8000'>//&amp;nbsp;42<br /></span><span style='color: #007700'>echo&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: #FF8000'>//&amp;nbsp;o&amp;nbsp;valor&amp;nbsp;do&amp;nbsp;email<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mysql-fetch-row.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 assimila campos NULL para o o <b><tt class='constant'>NULL</tt></b> do PHP.</span></p></blockquote> </div> <a name='function.mysql-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.mysql-fetch-array.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_array()</a> - Obt&amp;eacute;m uma linha como uma matriz associativa, uma matriz num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_assoc()</a> - Obt&amp;eacute;m um linha do resultado como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-object.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_object()</a> - Obt&amp;eacute;m o resultado de uma linha como um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-data-seek.php' class='function' rel='rdfs-seeAlso'>mysql_data_seek()</a> - Move o ponteiro interno do resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-lengths.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_lengths()</a> - Obt&amp;eacute;m o tamanho de cada sa&amp;iacute;da no resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-result.php' class='function' rel='rdfs-seeAlso'>mysql_result()</a> - Retorna dados do 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="mysql_fetch_object" value="<div id='function.mysql-fetch-object' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-fetch-object.php'>mysql_fetch_object</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_fetch_object</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o resultado de uma linha como um objeto</span></p> </div> <a name='function.mysql-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>mysql_fetch_object</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'>$class_name</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$params</tt></span> ]] )</div> <p class='para rdfs-comment'> Retorna um objeto com propriedades que correspondem a linha obtida e move o ponteiro interno dos dados adiante. </p> </div> <a name='function.mysql-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 resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>class_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome de classe para instanciar, definir as propriedades e retornar. Se n&amp;atilde;o for especificado, um objeto <b class='classname'>stdClass</b> &amp;eacute; retornado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>params</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Uma <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> opcional de par&amp;acirc;metros para passar para o construtor do objeto <i><tt class='parameter'>class_name</tt></i> . </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-fetch-object.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a> com propriedades strings que correspondem a linha obtida, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houverem mais linhas. </p> <p class='para'> <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a> obt&amp;eacute;m uma linha de dados do resultado associado ao identificador de resultados dado. A linha &amp;eacute; retornada como um array. Cada coluna do resultado &amp;eacute; guardada em um &amp;iacute;ndice da matriz, come&amp;ccedil;ando no &amp;iacute;ndice 0. </p> </div> <a name='function.mysql-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'>5.0.0</td> <td align='left'> Adiciona a abilidade de retornar como um objeto diferente. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mysql-fetch-object.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_fetch_object()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'hostname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;mytable'</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'>mysql_fetch_object</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;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>user_id</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fullname</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>mysql_free_result</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> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 Exemplo <b>mysql_fetch_object()</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: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>foo&amp;nbsp;</span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'hostname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'select&amp;nbsp;name&amp;nbsp;from&amp;nbsp;mytable&amp;nbsp;limit&amp;nbsp;1'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$obj&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_fetch_object</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'foo'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$obj</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.mysql-fetch-object.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>Performance</b><br /> Em termos de velocidade, a fun&amp;ccedil;&amp;atilde;o &amp;eacute; identica a <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>, e quase t&amp;atilde;o r&amp;aacute;pida quanto <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a> (a diferen&amp;ccedil;a &amp;eacute; insignificante). <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <b>mysql_fetch_object()</b> &amp;eacute; similar a <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_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 apenas pelo nome dos campos, e n&amp;atilde;o por seus &amp;iacute;ndices (numeros s&amp;atilde;o ilegais como nomes de propriedades). <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <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.mysql-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.mysql-fetch-array.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_array()</a> - Obt&amp;eacute;m uma linha como uma matriz associativa, uma matriz num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_assoc()</a> - Obt&amp;eacute;m um linha do resultado como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_row()</a> - Obt&amp;eacute;m uma linha como uma array num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-data-seek.php' class='function' rel='rdfs-seeAlso'>mysql_data_seek()</a> - Move o ponteiro interno do resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</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="mysql_fetch_lengths" value="<div id='function.mysql-fetch-lengths' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-fetch-lengths.php'>mysql_fetch_lengths</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_fetch_lengths</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o tamanho de cada sa&amp;iacute;da no resultado </span></p> </div> <a name='function.mysql-fetch-lengths.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>mysql_fetch_lengths</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma matriz que corresponde aos tamanhos de cada campo na ultima linha obtida pelo MySQL. </p> <p class='para'> <b>mysql_fetch_lengths()</b> guarda o tamanho de cada coluna do resultado na ultima linha retornada por <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function'>mysql_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a>, e <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-object.php' class='function'>mysql_fetch_object()</a> em uma matriz, come&amp;ccedil;ando no &amp;iacute;ndice 0. </p> </div> <a name='function.mysql-fetch-lengths.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 resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-fetch-lengths.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> de tamanhos em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-fetch-lengths.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo <b>mysql_fetch_lengths()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,email&amp;nbsp;FROM&amp;nbsp;people&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;'42''</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'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;executar&amp;nbsp;a&amp;nbsp;consulta:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /></span><span style='color: #0000BB'>$row&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_fetch_assoc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$lengths&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_fetch_lengths</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$lengths</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> Array ( [id] =&amp;gt; 42 [email] =&amp;gt; user@example.com ) Array ( [0] =&amp;gt; 2 [1] =&amp;gt; 16 ) </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-fetch-lengths.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.mysql-field-len.php' class='function' rel='rdfs-seeAlso'>mysql_field_len()</a> - Retorna o tamanho do campo especificado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_row()</a> - Obt&amp;eacute;m uma linha como uma array num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strlen.php' class='function' rel='rdfs-seeAlso'>strlen()</a> - Retorna o tamanho de uma string</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="mysql_fetch_field" value="<div id='function.mysql-fetch-field' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-fetch-field.php'>mysql_fetch_field</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_fetch_field</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre uma coluna de um resultado e retorna como um objeto</span></p> </div> <a name='function.mysql-fetch-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'>object</span> <span class='methodname'><b>mysql_fetch_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'>$field_offset</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna um objeto contendo informa&amp;ccedil;&amp;otilde;es sobre o campo. Esta fun&amp;ccedil;&amp;atilde;o pode ser usada para obter informa&amp;ccedil;&amp;otilde;es sobre os campos de um resultado de uma consulta. </p> </div> <a name='function.mysql-fetch-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'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field_offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O &amp;iacute;ndice num&amp;eacute;rico do campo. Se o &amp;iacute;ndice n&amp;atilde;o for especificado, o pr&amp;oacute;ximo campo que n&amp;atilde;o tenha sido obtido por esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; retornado. O par&amp;acirc;metro <i><tt class='parameter'>field_offset</tt></i> come&amp;ccedil;a em <i>0</i>. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-fetch-field.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a> contendo a informa&amp;ccedil;&amp;atilde;o sobre o campo. As propriedades do objeto s&amp;atilde;o: </p> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> name - nome da coluna </span> </li> <li class='listitem'> <span class='simpara'> table - a tabela a qual o objeto pertence </span> </li> <li class='listitem'> <span class='simpara'> def - o valor padr&amp;atilde;o da coluna </span> </li> <li class='listitem'> <span class='simpara'> max_length - o limite de tamanho da coluna </span> </li> <li class='listitem'> <span class='simpara'> not_null - 1 se a coluna n&amp;atilde;o puder ser <b><tt class='constant'>NULL</tt></b> </span> </li> <li class='listitem'> <span class='simpara'> primary_key - 1 se a coluna &amp;eacute; a chave prim&amp;aacute;ria </span> </li> <li class='listitem'> <span class='simpara'> unique_key - 1 se a coluna &amp;eacute; a chave &amp;uacute;nica </span> </li> <li class='listitem'> <span class='simpara'> multiple_key - 1 se a coluna &amp;eacute; uma chave n&amp;atilde;o-&amp;uacute;nica </span> </li> <li class='listitem'> <span class='simpara'> numeric - 1 se a coluna &amp;eacute; num&amp;eacute;rica </span> </li> <li class='listitem'> <span class='simpara'> blob - 1 se a coluna &amp;eacute; um BLOB </span> </li> <li class='listitem'> <span class='simpara'> type - o tipo da coluna </span> </li> <li class='listitem'> <span class='simpara'> unsigned - 1 se a coluna &amp;eacute; sem sinal </span> </li> <li class='listitem'> <span class='simpara'> zerofill - 1 se a coluna &amp;eacute; prenchida com zero </span> </li> </ul><p> </p> </div> <a name='function.mysql-fetch-field.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_fetch_field()</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'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</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;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'database'</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'select&amp;nbsp;*&amp;nbsp;from&amp;nbsp;table'</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;die(</span><span style='color: #DD0000'>'A&amp;nbsp;consulta&amp;nbsp;falhou:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #FF8000'>/*&amp;nbsp;obt&amp;eacute;m&amp;nbsp;as&amp;nbsp;informa&amp;ccedil;&amp;otilde;es&amp;nbsp;da&amp;nbsp;coluna&amp;nbsp;*/<br /></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 />while&amp;nbsp;(</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_fields</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;echo&amp;nbsp;</span><span style='color: #DD0000'>'Informa&amp;ccedil;&amp;atilde;o&amp;nbsp;para&amp;nbsp;a&amp;nbsp;coluna&amp;nbsp;</span><span style='color: #0000BB'>$i</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;</span><span style='color: #0000BB'>$meta&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_fetch_field</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'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</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'>'Sem&amp;nbsp;informa&amp;ccedil;&amp;atilde;o&amp;nbsp;dispon&amp;iacute;vel&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;pre&amp;gt;<br />blob:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>blob</span><span style='color: #DD0000'><br />max_length:&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</span><span style='color: #DD0000'><br />multiple_key:&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>multiple_key</span><span style='color: #DD0000'><br />name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</span><span style='color: #DD0000'><br />not_null:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>not_null</span><span style='color: #DD0000'><br />numeric:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>numeric</span><span style='color: #DD0000'><br />primary_key:&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>primary_key</span><span style='color: #DD0000'><br />table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</span><span style='color: #DD0000'><br />type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</span><span style='color: #DD0000'><br />default:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>def</span><span style='color: #DD0000'><br />unique_key:&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>unique_key</span><span style='color: #DD0000'><br />unsigned:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>unsigned</span><span style='color: #DD0000'><br />zerofill:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$meta</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>zerofill</span><span style='color: #DD0000'><br />&amp;lt;/pre&amp;gt;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>++;<br />}<br /></span><span style='color: #0000BB'>mysql_free_result</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> <a name='function.mysql-fetch-field.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> </div> <a name='function.mysql-fetch-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.mysql-field-seek.php' class='function' rel='rdfs-seeAlso'>mysql_field_seek()</a> - Define o ponteiro do resultado para o &amp;iacute;ndice de campo especificado</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="mysql_fetch_assoc" value="<div id='function.mysql-fetch-assoc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-fetch-assoc.php'>mysql_fetch_assoc</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_fetch_assoc</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m um linha do resultado como uma matriz associativa</span></p> </div> <a name='function.mysql-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>mysql_fetch_assoc</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma matriz associativa que corresponde a linha obtida e move o ponteiro interno dos dados adiante. <b>mysql_fetch_assoc()</b> &amp;eacute; equivalente a utilizar <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a> com MYSQL_ASSOC para o segunto par&amp;acirc;metro, que &amp;eacute; opcional. Ela apenas retorna a matriz associativa. </p> </div> <a name='function.mysql-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'> result</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-fetch-assoc.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma matriz associativa de strings que corresponde a linha obtida, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houverem mais linhas. </p> <p class='para'> Se duas ou mais colunas do resultado tiverem o mesmo nome de campo, a ultima coluna ter&amp;aacute; precedencia. Para acessar as outras coluna(s) com o mesmo nome, voc&amp;ecirc; precisa acessar os outros resultados usando &amp;iacute;ndices num&amp;eacute;ricos usando <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a> ou adicionar nomes alias. Veja o exemplo em <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function'>mysql_fetch_array()</a> para uma descri&amp;ccedil;&amp;atilde;o sobre alias. </p> </div> <a name='function.mysql-fetch-assoc.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo expandido de <b>mysql_fetch_assoc()</b></b></p> <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'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_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'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar&amp;nbsp;ao&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydbname'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;selecionar&amp;nbsp;mydbname:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<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;id&amp;nbsp;as&amp;nbsp;userid,&amp;nbsp;fullname,&amp;nbsp;userstatus<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;FROM&amp;nbsp;&amp;nbsp;&amp;nbsp;sometable<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;WHERE&amp;nbsp;&amp;nbsp;userstatus&amp;nbsp;=&amp;nbsp;1'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>);<br /><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'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;executar&amp;nbsp;a&amp;nbsp;consulta&amp;nbsp;(</span><span style='color: #0000BB'>$sql</span><span style='color: #DD0000'>)&amp;nbsp;no&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'>mysql_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</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;echo&amp;nbsp;</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foram&amp;nbsp;encontradas&amp;nbsp;linhas,&amp;nbsp;nada&amp;nbsp;para&amp;nbsp;mostrar,&amp;nbsp;assim&amp;nbsp;eu&amp;nbsp;estou&amp;nbsp;saindo'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Enquanto&amp;nbsp;uma&amp;nbsp;linha&amp;nbsp;de&amp;nbsp;dados&amp;nbsp;existir,&amp;nbsp;coloca&amp;nbsp;esta&amp;nbsp;linha&amp;nbsp;em&amp;nbsp;$row&amp;nbsp;como&amp;nbsp;uma&amp;nbsp;matriz&amp;nbsp;associativa<br />//&amp;nbsp;Nota:&amp;nbsp;se&amp;nbsp;voc&amp;ecirc;&amp;nbsp;esta&amp;nbsp;esperando&amp;nbsp;apenas&amp;nbsp;uma&amp;nbsp;linha,&amp;nbsp;n&amp;atilde;o&amp;nbsp;&amp;eacute;&amp;nbsp;necess&amp;aacute;rio&amp;nbsp;usar&amp;nbsp;um&amp;nbsp;loop<br />//&amp;nbsp;Nota:&amp;nbsp;se&amp;nbsp;voc&amp;ecirc;&amp;nbsp;colocar&amp;nbsp;extract($row);&amp;nbsp;dentro&amp;nbsp;do&amp;nbsp;loop,&amp;nbsp;voc&amp;ecirc;&amp;nbsp;ent&amp;atilde;o<br />//&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;ir&amp;aacute;&amp;nbsp;criar&amp;nbsp;$userid,&amp;nbsp;$fullname,&amp;nbsp;e&amp;nbsp;$userstatus<br /></span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_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;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'userid'</span><span style='color: #007700'>];<br />&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'>'fullname'</span><span style='color: #007700'>];<br />&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'>'userstatus'</span><span style='color: #007700'>];<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</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.mysql-fetch-assoc.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>Performance</b><br /> Uma coisa importante para notar &amp;eacute; que usar <b>mysql_fetch_assoc()</b> <em class='emphasis'>n&amp;atilde;o &amp;eacute; significativamente</em> mais lento do que usar <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a>, enquanto prov&amp;ecirc; um valor agregado significante. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <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.mysql-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.mysql-fetch-row.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_row()</a> - Obt&amp;eacute;m uma linha como uma array num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_array()</a> - Obt&amp;eacute;m uma linha como uma matriz associativa, uma matriz num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-data-seek.php' class='function' rel='rdfs-seeAlso'>mysql_data_seek()</a> - Move o ponteiro interno do resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-error.php' class='function' rel='rdfs-seeAlso'>mysql_error()</a> - Retorna o texto da mensagem de erro da opera&amp;ccedil;&amp;atilde;o MySQL anterior</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="mysql_fetch_array" value="<div id='function.mysql-fetch-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-fetch-array.php'>mysql_fetch_array</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_fetch_array</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma linha como uma matriz associativa, uma matriz num&amp;eacute;rica, ou ambas</span></p> </div> <a name='function.mysql-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>mysql_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'>$result_type</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna uma matriz que corresponde a linha obtida e move o ponteiro interno dos dados adiante. </p> </div> <a name='function.mysql-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 resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result_type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O tipo de array que deve ser obtida. &amp;eacute; uma constante e pode ter os seguintes valores: <b><tt class='constant'>MYSQL_ASSOC</tt></b>, <b><tt class='constant'>MYSQL_NUM</tt></b>, e o valor padr&amp;atilde;o de <b><tt class='constant'>MYSQL_BOTH</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-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 houver mais linhas. O tipo da array retornada depende de como <i><tt class='parameter'>result_type</tt></i> esta definido. Usando <b><tt class='constant'>MYSQL_BOTH</tt></b> (padr&amp;atilde;o), voc&amp;ecirc; ter&amp;aacute; um array com ambos os &amp;iacute;ndices, num&amp;eacute;rico e associativo. Usando <b><tt class='constant'>MYSQL_ASSOC</tt></b>, voc&amp;ecirc; tem apenas os &amp;iacute;ndices associativos (como <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function'>mysql_fetch_assoc()</a> funciona), usando <b><tt class='constant'>MYSQL_NUM</tt></b>, voc&amp;ecirc; tem apenas os &amp;iacute;ndices num&amp;eacute;ricos (como <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a> funciona). </p> <p class='para'> Se duas ou mais colunas do resultado tiverem os mesmos nomes de campos, a ultima coluna ter&amp;aacute; precedencia. Para acessar a(s) outra(s) coluna(s) com o mesmo nome, voc&amp;ecirc; dever&amp;aacute; usar o &amp;iacute;ndice num&amp;eacute;rico da coluna ou fazer um alias para a coluna. Para colunas com alias, voc&amp;ecirc; n&amp;atilde;o pode acessar os conte&amp;uacute;dos com o nome original da coluna. </p> </div> <a name='function.mysql-fetch-array.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Consulta com nomes de campos duplicados usando alias</b></p> <div class='example-contents programlisting'> <div class='sqlcode'><pre class='sqlcode'>SELECT table1.field AS foo, table2.field AS bar FROM table1, table2</pre> </div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 <b>mysql_fetch_array()</b> com <b><tt class='constant'>MYSQL_NUM</tt></b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>)&amp;nbsp;or<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;mytable'</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'>mysql_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'>MYSQL_NUM</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'>'ID:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Name:&amp;nbsp;%s'</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: #0000BB'>1</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</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> <p class='para'> </p><div class='example'> <p><b>Exemplo #3 <b>mysql_fetch_array()</b> com <b><tt class='constant'>MYSQL_ASSOC</tt></b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>)&amp;nbsp;or<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;mytable'</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'>mysql_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'>MYSQL_ASSOC</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'>'ID:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Name:&amp;nbsp;%s'</span><span style='color: #007700'>,&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'>]);<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</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> <p class='para'> </p><div class='example'> <p><b>Exemplo #4 <b>mysql_fetch_array()</b> com <b><tt class='constant'>MYSQL_BOTH</tt></b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>)&amp;nbsp;or<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;mytable'</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'>mysql_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'>MYSQL_BOTH</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'>'ID:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Name:&amp;nbsp;%s'</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'>'name'</span><span style='color: #007700'>]);<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</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> <a name='function.mysql-fetch-array.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>Performance</b><br /> Uma coisa importante para notar que usar <b>mysql_fetch_array()</b> <em class='emphasis'>n&amp;atilde;o &amp;eacute; significativamente</em> mais lento do que usar <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function'>mysql_fetch_row()</a>, enquanto prov&amp;ecirc; um valor agregado significante. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <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.mysql-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.mysql-fetch-row.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_row()</a> - Obt&amp;eacute;m uma linha como uma array num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_assoc()</a> - Obt&amp;eacute;m um linha do resultado como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-data-seek.php' class='function' rel='rdfs-seeAlso'>mysql_data_seek()</a> - Move o ponteiro interno do resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</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="mysql_escape_string" value="<div id='function.mysql-escape-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-escape-string.php'>mysql_escape_string</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_escape_string</span> &amp;mdash; <span class='dc-title'>Escapa uma string para usar em uma consulta MySQL</span></p> </div> <a name='function.mysql-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>mysql_escape_string</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$unescaped_string</tt></span> )</div> <p class='para rdfs-comment'> This function will escape the <i><tt class='parameter'>unescaped_string</tt></i> , so that it is safe to place it in a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>. This function is deprecated. </p> <p class='para'> This function is identical to <a href='http://www.php.net/manual/pt_BR/function.mysql-real-escape-string.php' class='function'>mysql_real_escape_string()</a> except that <a href='http://www.php.net/manual/pt_BR/function.mysql-real-escape-string.php' class='function'>mysql_real_escape_string()</a> takes a connection handler and escapes the string according to the current character set. <b>mysql_escape_string()</b> does not take a connection argument and does not respect the current charset setting. </p> </div> <a name='function.mysql-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'>unescaped_string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string that is to be escaped. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-escape-string.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the escaped string. </p> </div> <a name='function.mysql-escape-string.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.0</td> <td align='left'> This function became deprecated, do not use this function. Instead, use <a href='http://www.php.net/manual/pt_BR/function.mysql-real-escape-string.php' class='function'>mysql_real_escape_string()</a>. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mysql-escape-string.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mysql_escape_string()</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 />$item&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Zak's&amp;nbsp;Laptop'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$escaped_item&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$item</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Escaped&amp;nbsp;string:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$escaped_item</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> Escaped string: Zak\&amp;#039;s Laptop </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-escape-string.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>mysql_escape_string()</b> does not escape <i>%</i> and <i>_</i>. <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-real-escape-string.php' class='function' rel='rdfs-seeAlso'>mysql_real_escape_string()</a> - Escapa os caracteres especiais numa string para usar em um comando SQL, levando em conta o conjunto atual de caracteres.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.addslashes.php' class='function' rel='rdfs-seeAlso'>addslashes()</a> - Adiciona barras invertidas a uma string</li> <li class='member'>The <a href='http://www.php.net/manual/pt_BR/info.configuration.php#ini.magic-quotes-gpc' class='link'>magic_quotes_gpc</a> directive.</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="mysql_error" value="<div id='function.mysql-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-error.php'>mysql_error</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_error</span> &amp;mdash; <span class='dc-title'>Retorna o texto da mensagem de erro da opera&amp;ccedil;&amp;atilde;o MySQL anterior</span></p> </div> <a name='function.mysql-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>mysql_error</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna o texto do erro da ultima fun&amp;ccedil;&amp;atilde;o MySQL. Erros vindos do banco de dados MySQL n&amp;atilde;o geram mais avisos. Ao inv&amp;eacute;s, use <b>mysql_error()</b> para obter o texto do erro. Note que esta fun&amp;ccedil;&amp;atilde;o apenas retorna o texto do erro da fun&amp;ccedil;&amp;atilde;o MySQL mais recentemente executada (n&amp;atilde;o incluindo <b>mysql_error()</b> e <a href='http://www.php.net/manual/pt_BR/function.mysql-errno.php' class='function'>mysql_errno()</a>), assim se voc&amp;ecirc; quiser usa-la, tenha certesa de usar o valor antes de utilizar outra fun&amp;ccedil;&amp;atilde;o MySQL. </p> </div> <a name='function.mysql-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'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o texto do erro da ultima fun&amp;ccedil;&amp;atilde;o MySQL, ou <i>&amp;#039;&amp;#039;</i> (uma string vazia) se n&amp;atilde;o houve erro. </p> </div> <a name='function.mysql-error.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_error()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'nonexistentdb'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_errno</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>':&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'kossu'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;nonexistenttable'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_errno</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>':&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 1049: Unknown database &amp;#039;nonexistentdb&amp;#039; 1146: Table &amp;#039;kossu.nonexistenttable&amp;#039; doesn&amp;#039;t exist </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-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.mysql-errno.php' class='function' rel='rdfs-seeAlso'>mysql_errno()</a> - Retorna o valor num&amp;eacute;rico da mensagem de erro da opera&amp;ccedil;&amp;atilde;o MySQL anterior</li> <li class='member'><a href='http://dev.mysql.com/doc/mysql/en/error-handling.html' class='link external'>&amp;raquo; c&amp;oacute;digos de erro MySQL</a></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="mysql_errno" value="<div id='function.mysql-errno' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-errno.php'>mysql_errno</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_errno</span> &amp;mdash; <span class='dc-title'>Retorna o valor num&amp;eacute;rico da mensagem de erro da opera&amp;ccedil;&amp;atilde;o MySQL anterior</span></p> </div> <a name='function.mysql-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>mysql_errno</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna o n&amp;uacute;mero do erro da ultima fun&amp;ccedil;&amp;atilde;o MySQL. </p> <p class='para'> Erros vindos o MySQL n&amp;atilde;o geram mais avisos. Ao inv&amp;eacute;s, use <b>mysql_errno()</b> para obter o c&amp;oacute;digo do erro. Note que esta fu&amp;ccedil;&amp;atilde;o apenas retorna o c&amp;oacute;digo apenas da fun&amp;ccedil;&amp;atilde;o to MySQL mais recentemente usada (n&amp;atilde;o incluindo <a href='http://www.php.net/manual/pt_BR/function.mysql-error.php' class='function'>mysql_error()</a> e <b>mysql_errno()</b>), assim se voc&amp;ecirc; quiser usa-la, tenha certesa de conferir o valor antes de executar outra fun&amp;ccedil;&amp;atilde;o MySQL. </p> </div> <a name='function.mysql-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'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-errno.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o n&amp;uacute;mero de erro da ultima fun&amp;ccedil;&amp;atilde;o MySQL, ou <i>0</i> (zero) se n&amp;atilde;o houve erro. </p> </div> <a name='function.mysql-errno.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_errno()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'nonexistentdb'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_errno</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>':&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>).&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'kossu'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;nonexistenttable'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_errno</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>':&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> 1049: Unknown database &amp;#039;nonexistentdb&amp;#039; 1146: Table &amp;#039;kossu.nonexistenttable&amp;#039; doesn&amp;#039;t exist </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-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.mysql-error.php' class='function' rel='rdfs-seeAlso'>mysql_error()</a> - Retorna o texto da mensagem de erro da opera&amp;ccedil;&amp;atilde;o MySQL anterior</li> <li class='member'><a href='http://dev.mysql.com/doc/mysql/en/error-handling.html' class='link external'>&amp;raquo; c&amp;oacute;digos de erro MySQL</a></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="mysql_db_query" value="<div id='function.mysql-db-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-db-query.php'>mysql_db_query</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_db_query</span> &amp;mdash; <span class='dc-title'>Envia uma consulta MySQL</span></p> </div> <a name='function.mysql-db-query.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>mysql_db_query</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'>$query</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> <b>mysql_db_query()</b> seleciona um banco de dados, e executa uma consulta nele. </p> </div> <a name='function.mysql-db-query.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'> O nome do banco de dados que ser&amp;aacute; selecionado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A consulta MySQL. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-db-query.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um recurso de resultado MySQL com o resultado da consulta, ou <b><tt class='constant'>FALSE</tt></b> em caso de erro. A fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m retorna <b><tt class='constant'>TRUE</tt></b>/<b><tt class='constant'>FALSE</tt></b> para consultas <i>INSERT</i>/<i>UPDATE</i>/<i>DELETE</i> para indicar sucesso/falha. </p> </div> <a name='function.mysql-db-query.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.6</td> <td align='left'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; obsoleta, n&amp;atilde;o use esta fun&amp;ccedil;&amp;atilde;o. Use <a href='http://www.php.net/manual/pt_BR/function.mysql-select-db.php' class='function'>mysql_select_db()</a> e <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a> ao inv&amp;eacute;s. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mysql-db-query.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo alternativo <b>mysql_db_query()</b></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: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mysql_host'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar&amp;nbsp;ao&amp;nbsp;mysql'</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'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mysql_dbname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;selecionar&amp;nbsp;o&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>$sql&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;foo&amp;nbsp;FROM&amp;nbsp;bar&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;=&amp;nbsp;42'</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$sql</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><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'>'Erro&amp;nbsp;do&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados,&amp;nbsp;n&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;consultar&amp;nbsp;o&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Erro&amp;nbsp;MySQL:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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'>mysql_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;echo&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'foo'</span><span style='color: #007700'>];<br />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</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.mysql-db-query.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Tenha cuidado que esta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>N&amp;Atilde;O</em> muda de volta para o banco de dados que voc&amp;ecirc; estava conectado antes. Em outras palavras, voc&amp;ecirc; n&amp;atilde;o pode usar esta fun&amp;ccedil;&amp;atilde;o para <em class='emphasis'>temporariamente</em> executar uma consulta sql em outro banco de dados, voc&amp;ecirc; dever&amp;aacute; manualmente retornar ao banco de dados anterior. Aos usu&amp;aacute;rios &amp;eacute; fortemente recomendado usar a sintaxe <i>bancodedados.tabela</i> nas suas consultas ou <a href='http://www.php.net/manual/pt_BR/function.mysql-select-db.php' class='function'>mysql_select_db()</a> ao inv&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o. <br /> </p></blockquote> </div> <a name='function.mysql-db-query.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.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-select-db.php' class='function' rel='rdfs-seeAlso'>mysql_select_db()</a> - Seleciona um banco de dados MySQL</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="mysql_db_name" value="<div id='function.mysql-db-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-db-name.php'>mysql_db_name</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_db_name</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m dados do resultado(nome de banco de dados)</span></p> </div> <a name='function.mysql-db-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>mysql_db_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'>$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'> Obt&amp;eacute;m o nome do banco de dados a partir de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-list-dbs.php' class='function'>mysql_list_dbs()</a>. </p> </div> <a name='function.mysql-db-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O ponteiro de resultado de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-list-dbs.php' class='function'>mysql_list_dbs()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O &amp;iacute;ndice dentro do conjunto de resultados. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>field</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do campo. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-db-name.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o nome do banco de dados em caso de sucesso, e <b><tt class='constant'>FALSE</tt></b> em caso de falha. Se for retornado <b><tt class='constant'>FALSE</tt></b>, use <a href='http://www.php.net/manual/pt_BR/function.mysql-error.php' class='function'>mysql_error()</a> para determinar a natureza do erro. </p> </div> <a name='function.mysql-db-name.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_db_name()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />error_reporting</span><span style='color: #007700'>(</span><span style='color: #0000BB'>E_ALL</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dbhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'username'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$db_list&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_list_dbs</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></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 /></span><span style='color: #0000BB'>$cnt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db_list</span><span style='color: #007700'>);<br />while&amp;nbsp;(</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>$cnt</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>mysql_db_name</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db_list</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</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'>$i</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.mysql-db-name.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Para compatibilidade com vers&amp;otilde;es anteriores, o seguinte apelido obsoleto pode ser usado: <b>mysql_dbname()</b> <br /> </p></blockquote> </div> <a name='function.mysql-db-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.mysql-list-dbs.php' class='function' rel='rdfs-seeAlso'>mysql_list_dbs()</a> - Lista os bancos de dados dispon&amp;iacute;veis em um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-tablename.php' class='function' rel='rdfs-seeAlso'>mysql_tablename()</a> - Retorna o nome da tabela do 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="mysql_data_seek" value="<div id='function.mysql-data-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-data-seek.php'>mysql_data_seek</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_data_seek</span> &amp;mdash; <span class='dc-title'>Move o ponteiro interno do resultado</span></p> </div> <a name='function.mysql-data-seek.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>mysql_data_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'>$row_number</tt></span> )</div> <p class='para rdfs-comment'> <b>mysql_data_seek()</b> move o ponteiro interno das linhas de um resultado MySQL associado ao identificador de resultado dado para o n&amp;uacute;mero da linha especificado. A pr&amp;oacute;xima chamada a uma fun&amp;ccedil;&amp;atilde;o MySQL que retorne resultado, como <a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function'>mysql_fetch_assoc()</a>, ir&amp;aacute; retornar esta linha. </p> <p class='para'> <i><tt class='parameter'>row_number</tt></i> come&amp;ccedil;a em 0. O <i><tt class='parameter'>row_number</tt></i> deve ser um valor no intervalo de 0 a <a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function'>mysql_num_rows()</a> - 1. Entretanto, se o conjunto de reseultados for vazio (<a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function'>mysql_num_rows()</a> == 0), uma busca para 0 ir&amp;aacute; falhar com um <a href='http://www.php.net/manual/pt_BR/errorfunc.constants.php#errorfunc.constants.errorlevels.e-warning' class='link'>E_WARNING</a> e <b>mysql_data_seek()</b> i&amp;aacute; retornar <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mysql-data-seek.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 resultado <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> que esta sendo avaliado. Este resultado vem de uma chamada a <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>row_number</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero de linha desejado para o ponteiro de resultado. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-data-seek.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.mysql-data-seek.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_data_seek()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>$db_selected&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'sample_db'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$db_selected</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;selecionar&amp;nbsp;o&amp;nbsp;banco&amp;nbsp;de&amp;nbsp;dados:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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;last_name,&amp;nbsp;first_name&amp;nbsp;FROM&amp;nbsp;friends'</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'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</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;die(</span><span style='color: #DD0000'>'A&amp;nbsp;consulta&amp;nbsp;falhou:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #FF8000'>/*&amp;nbsp;obt&amp;eacute;m&amp;nbsp;as&amp;nbsp;linhas&amp;nbsp;em&amp;nbsp;ordem&amp;nbsp;reversa&amp;nbsp;*/<br /></span><span style='color: #007700'>for&amp;nbsp;(</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;gt;=&amp;nbsp;</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;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</span><span style='color: #0000BB'>mysql_data_seek</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;mover&amp;nbsp;para&amp;nbsp;a&amp;nbsp;linha&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #DD0000'>:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;continue;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_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;&amp;nbsp;&amp;nbsp;continue;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&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'>'last_name'</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'first_name'</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 />}<br /><br /></span><span style='color: #0000BB'>mysql_free_result</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> <a name='function.mysql-data-seek.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A fun&amp;ccedil;&amp;atilde;o <b>mysql_data_seek()</b> pode ser usada apenas em conjunto com a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-query.php' class='function'>mysql_query()</a>, n&amp;atilde;o com <a href='http://www.php.net/manual/pt_BR/function.mysql-unbuffered-query.php' class='function'>mysql_unbuffered_query()</a>. <br /> </p></blockquote> </div> <a name='function.mysql-data-seek.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.mysql-query.php' class='function' rel='rdfs-seeAlso'>mysql_query()</a> - Envia uma consulta MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function' rel='rdfs-seeAlso'>mysql_num_rows()</a> - Obt&amp;eacute;m o n&amp;uacute;mero de linhas em um resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-row.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_row()</a> - Obt&amp;eacute;m uma linha como uma array num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_assoc()</a> - Obt&amp;eacute;m um linha do resultado como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-array.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_array()</a> - Obt&amp;eacute;m uma linha como uma matriz associativa, uma matriz num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-fetch-object.php' class='function' rel='rdfs-seeAlso'>mysql_fetch_object()</a> - Obt&amp;eacute;m o resultado de uma linha como um objeto</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="mysql_connect" value="<div id='function.mysql-connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-connect.php'>mysql_connect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_connect</span> &amp;mdash; <span class='dc-title'>Abre uma conex&amp;atilde;o com um servidor MySQL</span></p> </div> <a name='function.mysql-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>mysql_connect</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$server</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'>bool</span> <tt class='parameter'>$new_link</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$client_flags</tt></span> ]]]]] )</div> <p class='para rdfs-comment'> Abre ou reutiliza uma conex&amp;atilde;o com um servidor MySQL. </p> </div> <a name='function.mysql-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'>server</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O servidor MySQL. Tamb&amp;eacute;m pode incluir um n&amp;uacute;mero de porta, exemplo &amp;quot;servidor:porta&amp;quot; ou um caminho para um socket local, exemplo &amp;quot;:/caminho/para/socket&amp;quot; para o servidor local(localhost). </p> <p class='para'> Se a diretiva do PHP <a href='http://www.php.net/manual/pt_BR/mysql.configuration.php#ini.mysql.default-host' class='link'> mysql.default_host</a> n&amp;atilde;o estiver definida(padr&amp;atilde;o), ent&amp;atilde;o o valor padr&amp;atilde;o &amp;eacute; &amp;#039;localhost:3306&amp;#039; </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>username</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome de usu&amp;aacute;rio. O valor padr&amp;atilde;o &amp;eacute; o nome do usu&amp;aacute;rio que &amp;eacute; o propriet&amp;aacute;rio do processo do servidor. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>password</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A senha. O valor padr&amp;atilde;o &amp;eacute; uma senha vazia. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>new_link</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se uma segunda chamada &amp;eacute; feita a <b>mysql_connect()</b> com os mesmos argumentos, n&amp;atilde;o &amp;eacute; estabelecida uma nova conex&amp;atilde;o, mas ao inv&amp;eacute;s, o identificador da conex&amp;atilde;o que j&amp;aacute; esta aberta &amp;eacute; retornado. O par&amp;acirc;metro <i><tt class='parameter'>new_link</tt></i> modifica este funcionamento e faz <b>mysql_connect()</b> sempre abrir uma nova conex&amp;atilde;o, mesmo que <b>mysql_connect()</b> seja chamado antes com os mesmos par&amp;acirc;metros. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>client_flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O par&amp;acirc;metro <i><tt class='parameter'>client_flags</tt></i> pode ser uma combina&amp;ccedil;&amp;atilde;o das seguintes constantes: <b><tt class='constant'>MYSQL_CLIENT_SSL</tt></b>, <b><tt class='constant'>MYSQL_CLIENT_COMPRESS</tt></b>, <b><tt class='constant'>MYSQL_CLIENT_IGNORE_SPACE</tt></b> ou <b><tt class='constant'>MYSQL_CLIENT_INTERACTIVE</tt></b>. Leia a se&amp;ccedil;&amp;atilde;o sobre <a href='http://www.php.net/manual/pt_BR/mysql.constants.php' class='xref'>Constantes pr&amp;eacute;-definidas</a> para maiores informa&amp;ccedil;&amp;otilde;es. </p> </dd> </dl> <p> </p> </div> <a name='function.mysql-connect.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de conex&amp;atilde;o MySQL em caso de sucesso, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> </div> <a name='function.mysql-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.3.0</td> <td align='left'> Adicionado o par&amp;acirc;metro <i><tt class='parameter'>client_flags</tt></i> . </td> </tr> <tr valign='middle'> <td align='left'>4.2.0</td> <td align='left'> Adicionado o par&amp;acirc;metro <i><tt class='parameter'>new_link</tt></i> . </td> </tr> <tr valign='middle'> <td align='left'>3.0.10</td> <td align='left'> Adicionado o suporte para &amp;quot;:/caminho/para/socket&amp;quot; com <i><tt class='parameter'>server</tt></i> . </td> </tr> <tr valign='middle'> <td align='left'>3.0.0</td> <td align='left'> Adicionado o suporte para &amp;quot;:porta&amp;quot; com <i><tt class='parameter'>server</tt></i> . </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mysql-connect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_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 />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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>mysql_connect()</b> usando a a sintaxe <i>servidor:porta</i></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;n&amp;oacute;s&amp;nbsp;conectamos&amp;nbsp;com&amp;nbsp;example.com&amp;nbsp;na&amp;nbsp;porta&amp;nbsp;3307<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'example.com:3307'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;n&amp;oacute;s&amp;nbsp;conectamos&amp;nbsp;com&amp;nbsp;localhost&amp;nbsp;na&amp;nbsp;porta&amp;nbsp;3307<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'127.0.0.1:3307'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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>mysql_connect()</b> usando a sintaxe &amp;quot;:/caminho/para/socket&amp;quot;</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;n&amp;oacute;s&amp;nbsp;conectamos&amp;nbsp;com&amp;nbsp;localhost&amp;nbsp;e&amp;nbsp;socket&amp;nbsp;exemplo&amp;nbsp;/tmp/mysql.sock<br /><br />//varia&amp;ccedil;&amp;atilde;o&amp;nbsp;1:&amp;nbsp;omitindo&amp;nbsp;localhost<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'/tmp/mysql'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;variant&amp;nbsp;2:&amp;nbsp;with&amp;nbsp;localhost<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost:/tmp/mysql.sock'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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.mysql-connect.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Em qualquer lugar que voc&amp;ecirc; especificar &amp;quot;localhost&amp;quot; ou &amp;quot;localhost:porta&amp;quot; como servidor, a biblioteca de cliente do MySQL ir&amp;aacute; sobrescrever isso e tentar conectar com um socket local (named pipe no Windows). Se voc&amp;ecirc; quiser usar TCP/IP, use &amp;quot;127.0.0.1&amp;quot; ao inv&amp;eacute;s de &amp;quot;localhost&amp;quot;. Se a biblioteca de cliente do MySQL tentar conectar com o socket local errado, voc&amp;ecirc; dever&amp;aacute; definir o caminho correto como <a href='http://www.php.net/manual/pt_BR/mysql.configuration.php' class='xref'>Configura&amp;ccedil;&amp;otilde;es em Execu&amp;ccedil;&amp;atilde;o</a> na sua configura&amp;ccedil;&amp;atilde;o do PHP e deixar o campo servidor em branco. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: A conex&amp;atilde;o com o servidor ser&amp;aacute; fechada assim que a execu&amp;ccedil;&amp;atilde;o do script terminar, a menos que tenha sido fechada anteriormente usando-se explicitamente <a href='http://www.php.net/manual/pt_BR/function.mysql-close.php' class='function'>mysql_close()</a>. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Voc&amp;ecirc; pode suprimir a mensagem de erro em caso de falha adicionando ante do nome da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/language.operators.errorcontrol.php' class='link'>@</a>. <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-pconnect.php' class='function' rel='rdfs-seeAlso'>mysql_pconnect()</a> - Abre uma conex&amp;atilde;o persistente com um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-close.php' class='function' rel='rdfs-seeAlso'>mysql_close()</a> - Fecha a conex&amp;atilde;o MySQL</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="mysql_close" value="<div id='function.mysql-close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-close.php'>mysql_close</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_close</span> &amp;mdash; <span class='dc-title'>Fecha a conex&amp;atilde;o MySQL</span></p> </div> <a name='function.mysql-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>mysql_close</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> <b>mysql_close()</b> fecha a conex&amp;atilde;o n&amp;atilde;o persistente ao servidor MySQL que esta associado ao identificador de conex&amp;atilde;o dado. Se <i><tt class='parameter'>link_identifier</tt></i> n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta &amp;eacute; usada. </p> <p class='para'> Usar <b>mysql_close()</b> n&amp;atilde;o &amp;eacute; normalmente necess&amp;aacute;rio, j&amp;aacute; que as conex&amp;otilde;es n&amp;atilde;o persistentes s&amp;atilde;o automaticamente fechadas ao final da execu&amp;ccedil;&amp;atilde;o do script. Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/language.types.resource.php#language.types.resource.self-destruct' class='link'>liberando recursos</a>. </p> </div> <a name='function.mysql-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-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.mysql-close.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_close()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Conex&amp;atilde;o&amp;nbsp;bem&amp;nbsp;sucedida'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysql_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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> Conex&amp;atilde;o bem sucedida </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-close.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>mysql_close()</b> n&amp;atilde;o ir&amp;aacute; fechar conex&amp;otilde;es persistentes criadas por <a href='http://www.php.net/manual/pt_BR/function.mysql-pconnect.php' class='function'>mysql_pconnect()</a>. <br /> </p></blockquote> </div> <a name='function.mysql-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.mysql-connect.php' class='function' rel='rdfs-seeAlso'>mysql_connect()</a> - Abre uma conex&amp;atilde;o com um servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-free-result.php' class='function' rel='rdfs-seeAlso'>mysql_free_result()</a> - Libera um resultado da mem&amp;oacute;ria</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="mysql_client_encoding" value="<div id='function.mysql-client-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-client-encoding.php'>mysql_client_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_client_encoding</span> &amp;mdash; <span class='dc-title'>Retorna o nome do conjunto de caracteres</span></p> </div> <a name='function.mysql-client-encoding.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>mysql_client_encoding</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m a vari&amp;aacute;vel <i>character_set</i> do MySQL. </p> </div> <a name='function.mysql-client-encoding.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'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-client-encoding.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o conjunto de caracteres padr&amp;atilde;o da conex&amp;atilde;o atual. </p> </div> <a name='function.mysql-client-encoding.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_client_encoding()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$charset&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_client_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;conjunto&amp;nbsp;de&amp;nbsp;caracteres&amp;nbsp;atual&amp;nbsp;&amp;eacute;:&amp;nbsp;</span><span style='color: #0000BB'>$charset</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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> O conjunto de caracteres atual &amp;eacute;: latin1 </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-client-encoding.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.mysql-real-escape-string.php' class='function' rel='rdfs-seeAlso'>mysql_real_escape_string()</a> - Escapa os caracteres especiais numa string para usar em um comando SQL, levando em conta o conjunto atual de caracteres.</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="mysql_affected_rows" value="<div id='function.mysql-affected-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysql-affected-rows.php'>mysql_affected_rows</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mysql_affected_rows</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o n&amp;uacute;mero de linhas atingidas na opera&amp;ccedil;&amp;atilde;o anterior do MySQL</span></p> </div> <a name='function.mysql-affected-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>mysql_affected_rows</b></span> ([ <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$link_identifier</tt></span> ] )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o n&amp;uacute;mero de linhas atingidas pela consulta INSERT, UPDATE, REPLACE ou DELETE mais recente associada ao <i><tt class='parameter'>link_identifier</tt></i> . </p> </div> <a name='function.mysql-affected-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'> link_identifier</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A conex&amp;atilde;o MySQL. se o identificador de conex&amp;atilde;o n&amp;atilde;o for especificado, a ultima conex&amp;atilde;o aberta por <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> &amp;eacute; assumida. Se uma conex&amp;atilde;o assim n&amp;atilde;o for encontrada, ela ir&amp;aacute; tentar criar uma como se a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.mysql-connect.php' class='function'>mysql_connect()</a> fosse chamada sem argumentos. Se uma conex&amp;atilde;o n&amp;atilde;o for encontrada ou estabelecida, um aviso de n&amp;iacute;vel de erro <b><tt class='constant'>E_WARNING</tt></b> &amp;eacute; gerado.</p></dd> </dl> <p> </p> </div> <a name='function.mysql-affected-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retona o n&amp;uacute;mero de linas atingidas em caso de sucesso, e -1 se a ultima consulta falhou. </p> <p class='para'> Se a ultima consulta foi um consulta DELETE sem a cla&amp;uacute;sula WHERE, todos os registros ter&amp;atilde;o sido exclu&amp;iacute;dos da tabela mas esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar zero com vers&amp;otilde;es do MySQL anteriores a 4.1.2. </p> <p class='para'> Ao usar UPDATE, o MySQL n&amp;atilde;o ir&amp;aacute; atualizar colunas aonde o novo valor &amp;eacute; o mesmo que o valor anterior. Isto cria a possibilidade de que <b>mysql_affected_rows()</b> possa n&amp;atilde;o ser igual ao n&amp;uacute;mero de linhas encontradas, apenas o n&amp;uacute;mero de linhas que literalmente foram afetadas pela consulta. </p> <p class='para'> O comando REPLACE primeiro exclui o registro com a mesma chave primaria e ent&amp;atilde;o insere o novo registro. Esta fun&amp;ccedil;&amp;atilde;o retorna o n&amp;uacute;mero de registros exclu&amp;iacute;dos mais o n&amp;uacute;mero de registros inseridos. </p> </div> <a name='function.mysql-affected-rows.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>mysql_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 />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;isto&amp;nbsp;deve&amp;nbsp;retornar&amp;nbsp;o&amp;nbsp;n&amp;uacute;mero&amp;nbsp;correto&amp;nbsp;de&amp;nbsp;registros&amp;nbsp;exclu&amp;iacute;dos&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;mytable&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;&amp;lt;&amp;nbsp;10'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Registros&amp;nbsp;exclu&amp;iacute;dos:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_affected_rows</span><span style='color: #007700'>());<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;com&amp;nbsp;uma&amp;nbsp;clausula&amp;nbsp;where&amp;nbsp;que&amp;nbsp;jamais&amp;nbsp;&amp;eacute;&amp;nbsp;verdadeira,&amp;nbsp;deve&amp;nbsp;retornar&amp;nbsp;0&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;mytable&amp;nbsp;WHERE&amp;nbsp;0'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Registros&amp;nbsp;Exclu&amp;iacute;dos:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_affected_rows</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> Records deleted: 10 Records deleted: 0 </pre></div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 Exemplo de <b>mysql_affected_rows()</b> usando transa&amp;ccedil;&amp;otilde;es</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_password'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'N&amp;atilde;o&amp;nbsp;foi&amp;nbsp;poss&amp;iacute;vel&amp;nbsp;conectar:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /></span><span style='color: #0000BB'>mysql_select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mydb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Atualiza&amp;nbsp;os&amp;nbsp;registros&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'UPDATE&amp;nbsp;mytable&amp;nbsp;SET&amp;nbsp;used=1&amp;nbsp;WHERE&amp;nbsp;id&amp;nbsp;&amp;lt;&amp;nbsp;10'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Registros&amp;nbsp;atualizados:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysql_affected_rows</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>mysql_query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'COMMIT'</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> Updated Records: 10 </pre></div> </div> </div><p> </p> </div> <a name='function.mysql-affected-rows.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>Transa&amp;ccedil;&amp;otilde;es</b><br /> Se voc&amp;ecirc; estiver usando transa&amp;ccedil;&amp;otilde;es, voc&amp;ecirc; deve utilizar <b>mysql_affected_rows()</b> depois da sua consulta INSERT, UPDATE, ou DELETE, n&amp;atilde;o depois de COMMIT. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <b>Comandos SELECT</b><br /> Para obter o n&amp;uacute;mero de linhas retornados por um SELECT, &amp;eacute; poss&amp;iacute;vel usar <a href='http://www.php.net/manual/pt_BR/function.mysql-num-rows.php' class='function'>mysql_num_rows()</a>. <br /> </p></blockquote> </div> <a name='function.mysql-affected-rows.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.mysql-num-rows.php' class='function' rel='rdfs-seeAlso'>mysql_num_rows()</a> - Obt&amp;eacute;m o n&amp;uacute;mero de linhas em um resultado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mysql-info.php' class='function' rel='rdfs-seeAlso'>mysql_info()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre a consulta mais recente</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="mysqli_warning_count" value="<div id='mysqli.warning-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.warning-count.php'>mysqli::warning_count</a></h1> <h1 class='refname'>mysqli_warning_count</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::warning_count</span> -- <span class='refname'>mysqli_warning_count</span> &amp;mdash; <span class='dc-title'>Returns the number of warnings from the last query for the given link</span></p> </div> <a name='mysqli.warning-count.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$warning_count</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_warning_count</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of warnings from the last query in the connection. </p> <blockquote><p><b class='note'>Nota</b>: For retrieving warning messages you can use the SQL command <i>SHOW WARNINGS [limit row_count]</i>. <br /> </p></blockquote> </div> <a name='mysqli.warning-count.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.warning-count.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Number of warnings or zero if there are no warnings. </p> </div> <a name='mysqli.warning-count.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;a&amp;nbsp;remarkable&amp;nbsp;city&amp;nbsp;in&amp;nbsp;Wales&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;(CountryCode,&amp;nbsp;Name)&amp;nbsp;VALUES('GBR',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'Llanfairpwllgwyngyllgogerychwyrndrobwllllantysiliogogogoch')'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>warning_count</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SHOW&amp;nbsp;WARNINGS'</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&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%d):&amp;nbsp;%s\n'</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: #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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;a&amp;nbsp;remarkable&amp;nbsp;long&amp;nbsp;city&amp;nbsp;name&amp;nbsp;in&amp;nbsp;Wales&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;(CountryCode,&amp;nbsp;Name)&amp;nbsp;VALUES('GBR',<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'Llanfairpwllgwyngyllgogerychwyrndrobwllllantysiliogogogoch')'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_warning_count</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SHOW&amp;nbsp;WARNINGS'</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&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%d):&amp;nbsp;%s\n'</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: #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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</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;}<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Warning (1264): Data truncated for column &amp;#039;Name&amp;#039; at row 1 </pre></div> </div> </div> <a name='mysqli.warning-count.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/mysqli.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_errno()</a> - Retorna o c&amp;oacute;digo de erro para a chamada de fun&amp;ccedil;&amp;atilde;o mais recente</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function' rel='rdfs-seeAlso'>mysqli_error()</a> - Retorna uma string descrevendo o ultimo erro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php' class='function' rel='rdfs-seeAlso'>mysqli_sqlstate()</a> - Returns the SQLSTATE error from previous MySQL operation</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="mysqli_use_result" value="<div id='mysqli.use-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.use-result.php'>mysqli::use_result</a></h1> <h1 class='refname'>mysqli_use_result</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::use_result</span> -- <span class='refname'>mysqli_use_result</span> &amp;mdash; <span class='dc-title'>Initiate a result set retrieval</span></p> </div> <a name='mysqli.use-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <span class='methodname'><b>mysqli::use_result</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <span class='methodname'><b>mysqli_use_result</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Used to initiate the retrieval of a result set from the last query executed using the <a href='http://www.php.net/manual/pt_BR/mysqli.real-query.php' class='function'>mysqli_real_query()</a> function on the database connection. </p> <p class='para'> Either this or the <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> function must be called before the results of a query can be retrieved, and one or the other must be called to prevent the next query on that database connection from failing. </p> <blockquote><p><b class='note'>Nota</b>: The <b>mysqli_use_result()</b> function does not transfer the entire result set from the database and hence cannot be used functions such as <a href='http://www.php.net/manual/pt_BR/mysqli-result.data-seek.php' class='function'>mysqli_data_seek()</a> to move to a particular row within the set. To use this functionality, the result set must be stored using <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a>. One should not use <b>mysqli_use_result()</b> if a lot of processing on the client side is performed, since this will tie up the server and prevent other threads from updating any tables from which the data is being fetched. <br /> </p></blockquote> </div> <a name='mysqli.use-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an unbuffered result object or <b><tt class='constant'>FALSE</tt></b> if an error occurred. </p> </div> <a name='mysqli.use-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;CURRENT_USER();'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;20,&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;multi&amp;nbsp;query&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>multi_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;do&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;first&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>use_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;&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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s\n'</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'>]);<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;}<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;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</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'>/*&amp;nbsp;print&amp;nbsp;divider&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>more_results</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;</span><span style='color: #0000BB'>printf</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>next_result</span><span style='color: #007700'>());<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;CURRENT_USER();'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;20,&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;multi&amp;nbsp;query&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_multi_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;do&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;first&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_use_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_row</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;&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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s\n'</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'>]);<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;}<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;</span><span style='color: #0000BB'>mysqli_free_result</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;&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'>/*&amp;nbsp;print&amp;nbsp;divider&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_more_results</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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;</span><span style='color: #0000BB'>printf</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer </pre></div> </div> </div> <a name='mysqli.use-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/mysqli.real-query.php' class='function' rel='rdfs-seeAlso'>mysqli_real_query()</a> - Execute an SQL query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last 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="mysqli_thread_safe" value="<div id='mysqli.thread-safe' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.thread-safe.php'>mysqli::thread_safe</a></h1> <h1 class='refname'>mysqli_thread_safe</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::thread_safe</span> -- <span class='refname'>mysqli_thread_safe</span> &amp;mdash; <span class='dc-title'>Returns whether thread safety is given or not</span></p> </div> <a name='mysqli.thread-safe.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_thread_safe</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Tells whether the client library is compiled as thread-safe. </p> </div> <a name='mysqli.thread-safe.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b><tt class='constant'>TRUE</tt></b> if the client library is thread-safe, otherwise <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="mysqli_thread_id" value="<div id='mysqli.thread-id' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.thread-id.php'>mysqli::thread_id</a></h1> <h1 class='refname'>mysqli_thread_id</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::thread_id</span> -- <span class='refname'>mysqli_thread_id</span> &amp;mdash; <span class='dc-title'>Returns the thread ID for the current connection</span></p> </div> <a name='mysqli.thread-id.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$thread_id</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_thread_id</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> The <b>mysqli_thread_id()</b> function returns the thread ID for the current connection which can then be killed using the <a href='http://www.php.net/manual/pt_BR/mysqli.kill.php' class='function'>mysqli_kill()</a> function. If the connection is lost and you reconnect with <a href='http://www.php.net/manual/pt_BR/mysqli.ping.php' class='function'>mysqli_ping()</a>, the thread ID will be other. Therefore you should get the thread ID only when you need it. </p> <blockquote><p><b class='note'>Nota</b>: The thread ID is assigned on a connection-by-connection basis. Hence, if the connection is broken and then re-established a new thread ID will be assigned. <br /> To kill a running query you can use the SQL command <i>KILL QUERY processid</i>. <br /> </p></blockquote> </div> <a name='mysqli.thread-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.thread-id.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the Thread ID for the current connection. </p> </div> <a name='mysqli.thread-id.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;our&amp;nbsp;thread&amp;nbsp;id&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$thread_id&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>thread_id</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Kill&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>kill</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$thread_id</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;This&amp;nbsp;should&amp;nbsp;produce&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</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;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;our&amp;nbsp;thread&amp;nbsp;id&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$thread_id&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_thread_id</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Kill&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_kill</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$thread_id</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;This&amp;nbsp;should&amp;nbsp;produce&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</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;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error: MySQL server has gone away </pre></div> </div> </div> <a name='mysqli.thread-id.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/mysqli.kill.php' class='function' rel='rdfs-seeAlso'>mysqli_kill()</a> - Solicita ao servidor o encerramento de um thread do MySQL</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="mysqli_store_result" value="<div id='mysqli.store-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.store-result.php'>mysqli::store_result</a></h1> <h1 class='refname'>mysqli_store_result</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::store_result</span> -- <span class='refname'>mysqli_store_result</span> &amp;mdash; <span class='dc-title'>Transfers a result set from the last query</span></p> </div> <a name='mysqli.store-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <span class='methodname'><b>mysqli::store_result</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <span class='methodname'><b>mysqli_store_result</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Transfers the result set from the last query on the database connection represented by the <i><tt class='parameter'>link</tt></i> parameter to be used with the <a href='http://www.php.net/manual/pt_BR/mysqli-result.data-seek.php' class='function'>mysqli_data_seek()</a> function. </p> </div> <a name='mysqli.store-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.store-result.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a buffered result object or <b><tt class='constant'>FALSE</tt></b> if an error occurred. </p> <blockquote><p><b class='note'>Nota</b>: <b>mysqli_store_result()</b> returns <b><tt class='constant'>FALSE</tt></b> in case the query didn&amp;#039;t return a result set (if the query was, for example an INSERT statement). This function also returns <b><tt class='constant'>FALSE</tt></b> if the reading of the result set failed. You can check if you have got an error by checking if <a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function'>mysqli_error()</a> doesn&amp;#039;t return an empty string, if <a href='http://www.php.net/manual/pt_BR/mysqli.errno.php' class='function'>mysqli_errno()</a> returns a non zero value, or if <a href='http://www.php.net/manual/pt_BR/mysqli.field-count.php' class='function'>mysqli_field_count()</a> returns a non zero value. Also possible reason for this function returning <b><tt class='constant'>FALSE</tt></b> after successful call to <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a> can be too large result set (memory for it cannot be allocated). If <a href='http://www.php.net/manual/pt_BR/mysqli.field-count.php' class='function'>mysqli_field_count()</a> returns a non-zero value, the statement should have produced a non-empty result set. <br /> </p></blockquote> </div> <a name='mysqli.store-result.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Although it is always good practice to free the memory used by the result of a query using the <a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function'>mysqli_free_result()</a> function, when transferring large result sets using the <b>mysqli_store_result()</b> this becomes particularly important. <br /> </p></blockquote> </div> <a name='mysqli.store-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> See <a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli_multi_query()</a>. </p> </div> <a name='mysqli.store-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/mysqli.real-query.php' class='function' rel='rdfs-seeAlso'>mysqli_real_query()</a> - Execute an SQL query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</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="mysqli_stmt_store_result" value="<div id='mysqli-stmt.store-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.store-result.php'>mysqli_stmt::store_result</a></h1> <h1 class='refname'>mysqli_stmt_store_result</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::store_result</span> -- <span class='refname'>mysqli_stmt_store_result</span> &amp;mdash; <span class='dc-title'>Transfers a result set from a prepared statement</span></p> </div> <a name='mysqli-stmt.store-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::store_result</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_store_result</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> You must call <b>mysqli_stmt_store_result()</b> for every query that successfully produces a result set (<i>SELECT, SHOW, DESCRIBE, EXPLAIN</i>), and only if you want to buffer the complete result set by the client, so that the subsequent <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a> call returns buffered data. </p> <blockquote><p><b class='note'>Nota</b>: It is unnecessary to call <b>mysqli_stmt_store_result()</b> for other queries, but if you do, it will not harm or cause any notable performance in all cases. You can detect whether the query produced a result set by checking if <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.result-metadata.php' class='function'>mysqli_stmt_result_metadata()</a> returns NULL. <br /> </p></blockquote> </div> <a name='mysqli-stmt.store-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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.store-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='mysqli-stmt.store-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;20'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>store_result</span><span style='color: #007700'>();<br /><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'>'Number&amp;nbsp;of&amp;nbsp;rows:&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>num_rows</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>free_result</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;20'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;store&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_store_result</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Number&amp;nbsp;of&amp;nbsp;rows:&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_num_rows</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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_free_result</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Number of rows: 20. </pre></div> </div> </div> <a name='mysqli-stmt.store-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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.result-metadata.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_result_metadata()</a> - Returns result set metadata from a prepared statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_fetch()</a> - Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis</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="mysqli_stmt_sqlstate" value="<div id='mysqli-stmt.sqlstate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.sqlstate.php'>mysqli_stmt::sqlstate</a></h1> <h1 class='refname'>mysqli_stmt_sqlstate</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::sqlstate</span> -- <span class='refname'>mysqli_stmt_sqlstate</span> &amp;mdash; <span class='dc-title'>Returns SQLSTATE error from previous statement operation</span></p> </div> <a name='mysqli-stmt.sqlstate.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$sqlstate</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_stmt_sqlstate</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns a string containing the SQLSTATE error code for the most recently invoked prepared statement function that can succeed or fail. The error code consists of five characters. <i>&amp;#039;00000&amp;#039;</i> means no error. The values are specified by ANSI SQL and ODBC. For a list of possible values, see <a href='http://dev.mysql.com/doc/mysql/en/error-handling.html' class='link external'>&amp;raquo; http://dev.mysql.com/doc/mysql/en/error-handling.html</a>. </p> </div> <a name='mysqli-stmt.sqlstate.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.sqlstate.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing the SQLSTATE error code for the last error. The error code consists of five characters. <i>&amp;#039;00000&amp;#039;</i> means no error. </p> </div> <a name='mysqli-stmt.sqlstate.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Note that not all MySQL errors are yet mapped to SQLSTATE&amp;#039;s. The value <i>HY000</i> (general error) is used for unmapped errors. <br /> </p></blockquote> </div> <a name='mysqli-stmt.sqlstate.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country'</span><span style='color: #007700'>);<br /><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;Name,&amp;nbsp;Code&amp;nbsp;FROM&amp;nbsp;myCountry&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCountry'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><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;%s.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>sqlstate</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country'</span><span style='color: #007700'>);<br /><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;Name,&amp;nbsp;Code&amp;nbsp;FROM&amp;nbsp;myCountry&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCountry'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Error:&amp;nbsp;%s.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_sqlstate</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error: 42S02. </pre></div> </div> </div> <a name='mysqli-stmt.sqlstate.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/mysqli-stmt.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_errno()</a> - Returns the error code for the most recent statement call</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.error.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_error()</a> - Returns a string description for last statement error</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="mysqli_stmt_send_long_data" value="<div id='mysqli-stmt.send-long-data' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.send-long-data.php'>mysqli_stmt::send_long_data</a></h1> <h1 class='refname'>mysqli_stmt_send_long_data</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::send_long_data</span> -- <span class='refname'>mysqli_stmt_send_long_data</span> &amp;mdash; <span class='dc-title'>Send data in blocks</span></p> </div> <a name='mysqli-stmt.send-long-data.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method)</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::send_long_data</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$param_nr</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_send_long_data</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$param_nr</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <p class='para rdfs-comment'> Allows to send parameter data to the server in pieces (or chunks), e.g. if the size of a blob exceeds the size of <i>max_allowed_packet</i>. This function can be called multiple times to send the parts of a character or binary data value for a column, which must be one of the TEXT or BLOB datatypes. </p> </div> <a name='mysqli-stmt.send-long-data.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>param_nr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Indicates which parameter to associate the data with. Parameters are numbered beginning with 0. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>data</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string containing data to be sent. </p> </dd> </dl> <p> </p> </div> <a name='mysqli-stmt.send-long-data.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='mysqli-stmt.send-long-data.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;messages&amp;nbsp;(message)&amp;nbsp;VALUES&amp;nbsp;(?)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$null&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>NULL</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_param</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'b'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$null</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$fp&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>fopen</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'messages.txt'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'r'</span><span style='color: #007700'>);<br />while&amp;nbsp;(!</span><span style='color: #0000BB'>feof</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$fp</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>send_long_data</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>fread</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$fp</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>8192</span><span style='color: #007700'>));<br />}<br /></span><span style='color: #0000BB'>fclose</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$fp</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> </div> <a name='mysqli-stmt.send-long-data.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_param()</a> - Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros</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="mysqli_stmt_result_metadata" value="<div id='mysqli-stmt.result-metadata' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.result-metadata.php'>mysqli_stmt::result_metadata</a></h1> <h1 class='refname'>mysqli_stmt_result_metadata</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::result_metadata</span> -- <span class='refname'>mysqli_stmt_result_metadata</span> &amp;mdash; <span class='dc-title'>Returns result set metadata from a prepared statement</span></p> </div> <a name='mysqli-stmt.result-metadata.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <span class='methodname'><b>mysqli_stmt::result_metadata</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <span class='methodname'><b>mysqli_stmt_result_metadata</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> If a statement passed to <a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function'>mysqli_prepare()</a> is one that produces a result set, <b>mysqli_stmt_result_metadata()</b> returns the result object that can be used to process the meta information such as total number of fields and individual field information. </p> <blockquote><p><b class='note'>Nota</b>: This result set pointer can be passed as an argument to any of the field-based functions that process result set metadata, such as: </p><ul class='itemizedlist'> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-count.php' class='function'>mysqli_num_fields()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function'>mysqli_fetch_field()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field-direct.php' class='function'>mysqli_fetch_field_direct()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-fields.php' class='function'>mysqli_fetch_fields()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli.field-count.php' class='function'>mysqli_field_count()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-seek.php' class='function'>mysqli_field_seek()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.current-field.php' class='function'>mysqli_field_tell()</a></p></li> <li class='listitem'><p class='para'><a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function'>mysqli_free_result()</a></p></li> </ul><p> <br /> </p></blockquote> <p class='para'> The result set structure should be freed when you are done with it, which you can do by passing it to <a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function'>mysqli_free_result()</a> </p> <blockquote><p><b class='note'>Nota</b>: The result set returned by <b>mysqli_stmt_result_metadata()</b> contains only metadata. It does not contain any row results. The rows are obtained by using the statement handle with <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a>. <br /> </p></blockquote> </div> <a name='mysqli-stmt.result-metadata.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.result-metadata.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a result object or <b><tt class='constant'>FALSE</tt></b> if an error occurred. </p> </div> <a name='mysqli-stmt.result-metadata.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;IF&amp;nbsp;EXISTS&amp;nbsp;friends'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;friends&amp;nbsp;(id&amp;nbsp;int,&amp;nbsp;name&amp;nbsp;varchar(20))'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;friends&amp;nbsp;VALUES&amp;nbsp;(1,'Hartmut'),&amp;nbsp;(2,&amp;nbsp;'Ulf')'</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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;friends'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;get&amp;nbsp;resultset&amp;nbsp;for&amp;nbsp;metadata&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>result_metadata</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;retrieve&amp;nbsp;field&amp;nbsp;information&amp;nbsp;from&amp;nbsp;metadata&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$field&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_field</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Fieldname:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$field</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;resultset&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;IF&amp;nbsp;EXISTS&amp;nbsp;friends'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;friends&amp;nbsp;(id&amp;nbsp;int,&amp;nbsp;name&amp;nbsp;varchar(20))'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;friends&amp;nbsp;VALUES&amp;nbsp;(1,'Hartmut'),&amp;nbsp;(2,&amp;nbsp;'Ulf')'</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'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;id,&amp;nbsp;name&amp;nbsp;FROM&amp;nbsp;friends'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_stmt_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;get&amp;nbsp;resultset&amp;nbsp;for&amp;nbsp;metadata&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_result_metadata</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;retrieve&amp;nbsp;field&amp;nbsp;information&amp;nbsp;from&amp;nbsp;metadata&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$field&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_field</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Fieldname:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$field</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;resultset&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='mysqli-stmt.result-metadata.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function' rel='rdfs-seeAlso'>mysqli_free_result()</a> - Frees the memory associated with a 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="mysqli_stmt_reset" value="<div id='mysqli-stmt.reset' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.reset.php'>mysqli_stmt::reset</a></h1> <h1 class='refname'>mysqli_stmt_reset</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::reset</span> -- <span class='refname'>mysqli_stmt_reset</span> &amp;mdash; <span class='dc-title'>Resets a prepared statement</span></p> </div> <a name='mysqli-stmt.reset.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::reset</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_reset</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Resets a prepared statement on client and server to state after prepare. </p> <p class='para'> It resets the statement on the server, data sent using <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php' class='function'>mysqli_stmt_send_long_data()</a>, unbuffered result sets and current errors. It does not clear bindings or stored result sets. Stored result sets will be cleared when executing the prepared statement (or closing it). </p> <p class='para'> To prepare a statement with another query use function <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.prepare.php' class='function'>mysqli_stmt_prepare()</a>. </p> </div> <a name='mysqli-stmt.reset.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.reset.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='mysqli-stmt.reset.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</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="mysqli_stmt_prepare" value="<div id='mysqli-stmt.prepare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.prepare.php'>mysqli_stmt::prepare</a></h1> <h1 class='refname'>mysqli_stmt_prepare</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::prepare</span> -- <span class='refname'>mysqli_stmt_prepare</span> &amp;mdash; <span class='dc-title'>Prepara uma declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SQL para execu&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o</span></p> </div> <a name='mysqli-stmt.prepare.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (m&amp;Atilde;&amp;copy;todo)</p> <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>mysqli_stmt::prepare</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'>Estilo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_prepare</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> Prepares the SQL query pointed to by the null-terminated string query. </p> <p class='para'> Os marcadores de par&amp;Atilde;&amp;cent;metros devem ser ligados as vari&amp;Atilde;&amp;iexcl;veis da aplica&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o utilizando-se <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function'>mysqli_stmt_bind_param()</a> e/ou <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function'>mysqli_stmt_bind_result()</a> antes de executar a declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o ou trazer os resultados. </p> </div> <a name='mysqli-stmt.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'> stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A query, como uma string. Deve conter somente uma &amp;Atilde;&amp;ordm;nica declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SQL. </p> <p class='para'> Voc&amp;Atilde;&amp;ordf; pode incluir um ou mais marcadores de par&amp;Atilde;&amp;cent;metros na declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SQL colocando a interroga&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o (<i>?</i>) nas posi&amp;Atilde;&amp;sect;&amp;Atilde;&amp;micro;es apropriadas. </p> <blockquote><p><b class='note'>Nota</b>: Voc&amp;Atilde;&amp;ordf; n&amp;Atilde;&amp;pound;o deve adicionar um ponto-e-virgula ou <i>\g</i> para terminar a declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Os marcadores s&amp;Atilde;&amp;pound;o permitidos somente em alguns lugares das declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;micro;es SQL. Por exemplo, eles s&amp;Atilde;&amp;pound;o permitidos na lista VALUES() de um INSERT (para especificar valores das colunas em uma linha), ou na compara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o de uma coluna na cl&amp;Atilde;&amp;iexcl;usula WHERE para especificar um valor de compara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o. <br /> Entretanto, eles n&amp;Atilde;&amp;pound;o s&amp;Atilde;&amp;pound;o permitidos em identificadores (como nomes de tabela e coluna, na lista que nomeia os nomes das colunas a serem retornados por uma declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SELECT), ou para especificar ambos os operandos de um operador bin&amp;Atilde;&amp;iexcl;rio como o <i>=</i> sinal de igual. A &amp;Atilde;&amp;ordm;ltima restri&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o &amp;Atilde;&amp;copy; necess&amp;Atilde;&amp;iexcl;ria pois seria imposs&amp;Atilde;&amp;shy;vel determinar o tipo do par&amp;Atilde;&amp;cent;metro. No geral, os par&amp;Atilde;&amp;cent;metros s&amp;Atilde;&amp;pound;o permitidos somente em declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;micro;es de Linguagem de Manipula&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o de Dados (no ingl&amp;Atilde;&amp;ordf;s DML), e n&amp;Atilde;&amp;pound;o em Linguagem Defini&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o de Dados (DDL). <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='mysqli-stmt.prepare.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='mysqli-stmt.prepare.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;verifica&amp;nbsp;coenx&amp;Atilde;&amp;pound;o&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Conex&amp;Atilde;&amp;pound;o&amp;nbsp;falhou:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$cidade&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Curitiba'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;cria&amp;nbsp;uma&amp;nbsp;declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o&amp;nbsp;preparada&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>stmt_init</span><span style='color: #007700'>();<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Estado&amp;nbsp;FROM&amp;nbsp;Cidade&amp;nbsp;WHERE&amp;nbsp;Nome=?'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;atribui&amp;nbsp;os&amp;nbsp;par&amp;Atilde;&amp;cent;metros&amp;nbsp;aos&amp;nbsp;marcadores&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_param</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$cidade</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;executa&amp;nbsp;a&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;atribui&amp;nbsp;as&amp;nbsp;vari&amp;Atilde;&amp;iexcl;veis&amp;nbsp;de&amp;nbsp;resultado&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$estado</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;busca&amp;nbsp;o&amp;nbsp;valor&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch</span><span style='color: #007700'>();<br /><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'>'%s&amp;nbsp;est&amp;Atilde;&amp;iexcl;&amp;nbsp;no&amp;nbsp;estado&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$cidade</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$estado</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fecha&amp;nbsp;a&amp;nbsp;declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;fecha&amp;nbsp;a&amp;nbsp;conex&amp;Atilde;&amp;pound;o&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;verifica&amp;nbsp;coenx&amp;Atilde;&amp;pound;o&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Conex&amp;Atilde;&amp;pound;o&amp;nbsp;falhou:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$cidade&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Curitiba'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;cria&amp;nbsp;uma&amp;nbsp;declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o&amp;nbsp;preparada&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_init</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_stmt_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Estado&amp;nbsp;FROM&amp;nbsp;Cidade&amp;nbsp;WHERE&amp;nbsp;Nome=?'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;atribui&amp;nbsp;os&amp;nbsp;par&amp;Atilde;&amp;cent;metros&amp;nbsp;aos&amp;nbsp;marcadores&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$cidade</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;executa&amp;nbsp;a&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;atribui&amp;nbsp;as&amp;nbsp;vari&amp;Atilde;&amp;iexcl;veis&amp;nbsp;de&amp;nbsp;resultado&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$estado</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;busca&amp;nbsp;o&amp;nbsp;valor&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_fetch</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;est&amp;Atilde;&amp;iexcl;&amp;nbsp;no&amp;nbsp;estado&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$cidade</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$estado</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fecha&amp;nbsp;a&amp;nbsp;declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;fecha&amp;nbsp;a&amp;nbsp;conex&amp;Atilde;&amp;pound;o&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Curitiba est&amp;Atilde;&amp;iexcl; no estado Paran&amp;Atilde;&amp;iexcl; </pre></div> </div> </div> <a name='mysqli-stmt.prepare.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_init()</a> - Initializes a statement and returns an object for use with mysqli_stmt_prepare, <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_execute()</a> - Executa uma preparada query, <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_fetch()</a> - Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis, <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_param()</a> - Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros, <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_result()</a> - Passa vari&amp;aacute;veis para um preparado comando por resultado armazenado <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.close.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_close()</a> - Closes a prepared statement. </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="mysqli_stmt_param_count" value="<div id='mysqli-stmt.param-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.param-count.php'>mysqli_stmt-&amp;gt;param_count</a></h1> <h1 class='refname'>mysqli_stmt_param_count</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;param_count</span> -- <span class='refname'>mysqli_stmt_param_count</span> &amp;mdash; <span class='dc-title'>Returns the number of parameter for the given statement</span></p> </div> <a name='mysqli-stmt.param-count.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$param_count</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt_param_count</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of parameter markers present in the prepared statement. </p> </div> <a name='mysqli-stmt.param-count.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.param-count.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an integer representing the number of parameters. </p> </div> <a name='mysqli-stmt.param-count.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;WHERE&amp;nbsp;Name=?&amp;nbsp;OR&amp;nbsp;Code=?'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$marker&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>param_count</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'>'Statement&amp;nbsp;has&amp;nbsp;%d&amp;nbsp;markers.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$marker</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;WHERE&amp;nbsp;Name=?&amp;nbsp;OR&amp;nbsp;Code=?'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$marker&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_param_count</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'>'Statement&amp;nbsp;has&amp;nbsp;%d&amp;nbsp;markers.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$marker</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Statement has 2 markers. </pre></div> </div> </div> <a name='mysqli-stmt.param-count.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</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="mysqli_stmt_num_rows" value="<div id='mysqli-stmt.num-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.num-rows.php'>mysqli_stmt::num_rows</a></h1> <h1 class='refname'>mysqli_stmt_num_rows</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::num_rows</span> -- <span class='refname'>mysqli_stmt_num_rows</span> &amp;mdash; <span class='dc-title'>Return the number of rows in statements result set</span></p> </div> <a name='mysqli-stmt.num-rows.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$num_rows</var>;</div> </div> <p class='para'>Procedural style :</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt_num_rows</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of rows in the result set. The use of <b>mysqli_stmt_num_rows()</b> depends on whether or not you used <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a> to buffer the entire result set in the statement handle. </p> <p class='para'> If you use <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a>, <b>mysqli_stmt_num_rows()</b> may be called immediately. </p> </div> <a name='mysqli-stmt.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.num-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An integer representing the number of rows in result set. </p> </div> <a name='mysqli-stmt.num-rows.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;20'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>store_result</span><span style='color: #007700'>();<br /><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'>'Number&amp;nbsp;of&amp;nbsp;rows:&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>num_rows</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;20'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;store&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_store_result</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Number&amp;nbsp;of&amp;nbsp;rows:&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_num_rows</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Number of rows: 20. </pre></div> </div> </div> <a name='mysqli-stmt.num-rows.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/mysqli-stmt.affected-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_affected_rows()</a> - Returns the total number of rows changed, deleted, or inserted by the last executed statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_store_result()</a> - Transfers a result set from a prepared 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="mysqli_stmt_insert_id" value="<div id='mysqli-stmt.insert-id' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.insert-id.php'>mysqli_stmt-&amp;gt;insert_id</a></h1> <h1 class='refname'>mysqli_stmt_insert_id</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;insert_id</span> -- <span class='refname'>mysqli_stmt_insert_id</span> &amp;mdash; <span class='dc-title'>Get the ID generated from the previous INSERT operation</span></p> </div> <a name='mysqli-stmt.insert-id.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$insert_id</var>;</div> </div> <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>mysqli_stmt_insert_id</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</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="mysqli_stmt_init" value="<div id='mysqli.stmt-init' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.stmt-init.php'>mysqli::stmt_init</a></h1> <h1 class='refname'>mysqli_stmt_init</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::stmt_init</span> -- <span class='refname'>mysqli_stmt_init</span> &amp;mdash; <span class='dc-title'>Initializes a statement and returns an object for use with mysqli_stmt_prepare</span></p> </div> <a name='mysqli.stmt-init.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli_stmt</span> <span class='methodname'><b>stmt_init</b></span> ( <span class='methodparam'>void</span> )</div> </div> <p class='para'>Procedural style :</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <span class='methodname'><b>mysqli_stmt_init</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Allocates and initializes a statement object suitable for <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.prepare.php' class='function'>mysqli_stmt_prepare()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Any subsequent calls to any mysqli_stmt function will fail until <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.prepare.php' class='function'>mysqli_stmt_prepare()</a> was called. <br /> </p></blockquote> </div> <a name='mysqli.stmt-init.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.stmt-init.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an object. </p> </div> <a name='mysqli.stmt-init.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/mysqli-stmt.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_prepare()</a> - Prepara uma declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SQL para execu&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;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="mysqli_stmt_get_warnings" value="<div id='mysqli-stmt.get-warnings' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.get-warnings.php'>mysqli_stmt::get_warnings</a></h1> <h1 class='refname'>mysqli_stmt_get_warnings</h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::get_warnings</span> -- <span class='refname'>mysqli_stmt_get_warnings</span> &amp;mdash; <span class='dc-title'>Get result of SHOW WARNINGS</span></p> </div> <a name='mysqli-stmt.get-warnings.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>mysqli_stmt::get_warnings</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>mysqli_stmt_get_warnings</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</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="mysqli_stmt_free_result" value="<div id='mysqli-stmt.free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.free-result.php'>mysqli_free_result</a></h1> <h1 class='refname'>result-&amp;gt;free</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_free_result</span> -- <span class='refname'>result-&amp;gt;free</span> &amp;mdash; <span class='dc-title'>Libera a mem&amp;oacute;ria associada ao resultado</span></p> </div> <a name='mysqli-stmt.free-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_stmt::free_result</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_stmt_free_result</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Libera o resultado da mem&amp;oacute;ria associado com o comando, que foi alocado por <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a>. </p> </div> <a name='mysqli-stmt.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.free-result.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='mysqli-stmt.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/mysqli-stmt.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_store_result()</a> - Transfers a result set from a prepared 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="mysqli_stmt_field_count" value="<div id='mysqli-stmt.field-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.field-count.php'>mysqli_stmt-&amp;gt;field_count</a></h1> <h1 class='refname'>mysqli_stmt_field_count</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;field_count</span> -- <span class='refname'>mysqli_stmt_field_count</span> &amp;mdash; <span class='dc-title'>Returns the number of field in the given statement</span></p> </div> <a name='mysqli-stmt.field-count.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$field_count</var>;</div> </div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt_field_count</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</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="mysqli_stmt_fetch" value="<div id='mysqli-stmt.fetch' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.fetch.php'>mysqli_stmt::fetch</a></h1> <h1 class='refname'>mysqli_stmt_fetch</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::fetch</span> -- <span class='refname'>mysqli_stmt_fetch</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis</span></p> </div> <a name='mysqli-stmt.fetch.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::fetch</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_fetch</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m o resultado de um preparado comando e coloca nas vari&amp;aacute;veis determinadas por <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function'>mysqli_stmt_bind_result()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Note que todas as colunas precisam ser determinadas para aplica&amp;ccedil;&amp;atilde;o antes de chamar a <b>mysqli_stmt_fetch()</b>. <br /> </p></blockquote> </div> <a name='mysqli-stmt.fetch.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.fetch.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <table class='doctable table'> <caption><b>Valor Retornado</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Valor</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>TRUE</tt></b></td> <td align='left'>Sucesso. Dados foram obtidos</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>FALSE</tt></b></td> <td align='left'>Erro ocorrido</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>NULL</tt></b></td> <td align='left'>N&amp;atilde;o h&amp;aacute; mais linhas/n&amp;atilde;o existe dados ou dados truncados</td> </tr> </tbody> </table> </div> <a name='mysqli-stmt.fetch.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;150,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;result&amp;nbsp;variables&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;values&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch</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'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;150,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;result&amp;nbsp;variables&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;values&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_stmt_fetch</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;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Rockford (USA) Tallahassee (USA) Salinas (USA) Santa Clarita (USA) Springfield (USA) </pre></div> </div> </div> <a name='mysqli-stmt.fetch.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_errno()</a> - Returns the error code for the most recent statement call</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.error.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_error()</a> - Returns a string description for last statement error</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_result()</a> - Passa vari&amp;aacute;veis para um preparado comando por resultado armazenado</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="mysqli_stmt_execute" value="<div id='mysqli-stmt.execute' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.execute.php'>mysqli_stmt-&amp;gt;execute</a></h1> <h1 class='refname'>mysqli_stmt_execute</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;execute</span> -- <span class='refname'>mysqli_stmt_execute</span> &amp;mdash; <span class='dc-title'>Executa uma preparada query</span></p> </div> <a name='mysqli-stmt.execute.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::execute</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_execute</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Executa uma query que foi previamente preparada usando a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function'>mysqli_prepare()</a>. Quando executada alguns par&amp;acirc;metros marcados que existem ir&amp;atilde;o automaticamente ser substituido com a informa&amp;ccedil;&amp;atilde;o apropriada. </p> <p class='para'> Se o comando &amp;eacute; <i>UPDATE</i>, <i>DELETE</i>, ou <i>INSERT</i>, o n&amp;uacute;mero total de linhas afetadas pode ser determinado usando a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.affected-rows.php' class='function'>mysqli_stmt_affected_rows()</a>. Da mesma forma, se a query produz um conjunto de resultado a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a> &amp;eacute; usada. </p> <blockquote><p><b class='note'>Nota</b>: Quando usando <b>mysqli_stmt_execute()</b>, a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a> precisa ser usada para obter a informa&amp;ccedil;&amp;atilde;o antes de executar alguma query adicional. <br /> </p></blockquote> </div> <a name='mysqli-stmt.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.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='mysqli-stmt.execute.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Prepare&amp;nbsp;an&amp;nbsp;insert&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;(Name,&amp;nbsp;CountryCode,&amp;nbsp;District)&amp;nbsp;VALUES&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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_param</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'sss'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val3</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$val1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Stuttgart'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DEU'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Baden-Wuerttemberg'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>$val1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Bordeaux'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'FRA'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Aquitaine'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;retrieve&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;from&amp;nbsp;myCity&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name,&amp;nbsp;CountryCode,&amp;nbsp;District&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s,%s)\n'</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: #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'>]);<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;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;remove&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Prepare&amp;nbsp;an&amp;nbsp;insert&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;(Name,&amp;nbsp;CountryCode,&amp;nbsp;District)&amp;nbsp;VALUES&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'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>mysqli_stmt_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'sss'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val3</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$val1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Stuttgart'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DEU'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Baden-Wuerttemberg'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_stmt_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$val1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Bordeaux'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'FRA'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$val3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Aquitaine'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Execute&amp;nbsp;the&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_stmt_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;retrieve&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;from&amp;nbsp;myCity&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name,&amp;nbsp;CountryCode,&amp;nbsp;District&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</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'>mysqli_fetch_row</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;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s,%s)\n'</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: #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'>]);<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;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;remove&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Stuttgart (DEU,Baden-Wuerttemberg) Bordeaux (FRA,Aquitaine) </pre></div> </div> </div> <a name='mysqli-stmt.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_param()</a> - Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros</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="mysqli_stmt_error" value="<div id='mysqli-stmt.error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.error.php'>mysqli_stmt-&amp;gt;error</a></h1> <h1 class='refname'>mysqli_stmt_error</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;error</span> -- <span class='refname'>mysqli_stmt_error</span> &amp;mdash; <span class='dc-title'>Returns a string description for last statement error</span></p> </div> <a name='mysqli-stmt.error.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$error</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_stmt_error</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns a containing the error message for the most recently invoked statement function that can succeed or fail. </p> </div> <a name='mysqli-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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A string that describes the error. An empty string if no error occurred. </p> </div> <a name='mysqli-stmt.error.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country'</span><span style='color: #007700'>);<br /><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;Name,&amp;nbsp;Code&amp;nbsp;FROM&amp;nbsp;myCountry&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCountry'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><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;%s.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country'</span><span style='color: #007700'>);<br /><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;Name,&amp;nbsp;Code&amp;nbsp;FROM&amp;nbsp;myCountry&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCountry'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Error:&amp;nbsp;%s.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_error</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error: Table &amp;#039;world.myCountry&amp;#039; doesn&amp;#039;t exist. </pre></div> </div> </div> <a name='mysqli-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/mysqli-stmt.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_errno()</a> - Returns the error code for the most recent statement call</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.sqlstate.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_sqlstate()</a> - Returns SQLSTATE error from previous statement operation</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="mysqli_stmt_errno" value="<div id='mysqli-stmt.errno' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.errno.php'>mysqli_stmt-&amp;gt;errno</a></h1> <h1 class='refname'>mysqli_stmt_errno</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;errno</span> -- <span class='refname'>mysqli_stmt_errno</span> &amp;mdash; <span class='dc-title'>Returns the error code for the most recent statement call</span></p> </div> <a name='mysqli-stmt.errno.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$errno</var>;</div> </div> <p class='para'>Procedural style :</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt_errno</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the error code for the most recently invoked statement function that can succeed or fail. </p> <p class='para'> Client error message numbers are listed in the MySQL <var class='filename'>errmsg.h</var> header file, server error message numbers are listed in <var class='filename'>mysqld_error.h</var>. In the MySQL source distribution you can find a complete list of error messages and error numbers in the file <var class='filename'>Docs/mysqld_error.txt</var>. </p> </div> <a name='mysqli-stmt.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'> stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.errno.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An error code value. Zero means no error occurred. </p> </div> <a name='mysqli-stmt.errno.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country'</span><span style='color: #007700'>);<br /><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;Name,&amp;nbsp;Code&amp;nbsp;FROM&amp;nbsp;myCountry&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCountry'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><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;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>errno</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country'</span><span style='color: #007700'>);<br /><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;Name,&amp;nbsp;Code&amp;nbsp;FROM&amp;nbsp;myCountry&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCountry'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Error:&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_errno</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error: 1146. </pre></div> </div> </div> <a name='mysqli-stmt.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/mysqli-stmt.error.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_error()</a> - Returns a string description for last statement error</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.sqlstate.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_sqlstate()</a> - Returns SQLSTATE error from previous statement operation</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="mysqli_stmt_data_seek" value="<div id='mysqli-stmt.data-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.data-seek.php'>mysqli_stmt::data_seek</a></h1> <h1 class='refname'>mysqli_stmt_data_seek</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::data_seek</span> -- <span class='refname'>mysqli_stmt_data_seek</span> &amp;mdash; <span class='dc-title'>Seeks to an arbitrary row in statement result set</span></p> </div> <a name='mysqli-stmt.data-seek.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_stmt::data_seek</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_stmt_data_seek</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> )</div> <p class='para rdfs-comment'> Seeks to an arbitrary result pointer in the statement result set. </p> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a> must be called prior to <b>mysqli_stmt_data_seek()</b>. </p> </div> <a name='mysqli-stmt.data-seek.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Must be between zero and the total number of rows minus one (0.. <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.num-rows.php' class='function'>mysqli_stmt_num_rows()</a> - 1). </p> </dd> </dl> <p> </p> </div> <a name='mysqli-stmt.data-seek.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='mysqli-stmt.data-seek.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;result&amp;nbsp;variables&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>store_result</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;seek&amp;nbsp;to&amp;nbsp;row&amp;nbsp;no.&amp;nbsp;400&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>data_seek</span><span style='color: #007700'>(</span><span style='color: #0000BB'>399</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;values&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch</span><span style='color: #007700'>();<br /><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'>'City:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Countrycode:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;result&amp;nbsp;variables&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_store_result</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: #FF8000'>/*&amp;nbsp;seek&amp;nbsp;to&amp;nbsp;row&amp;nbsp;no.&amp;nbsp;400&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_data_seek</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>399</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;values&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_fetch</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'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'City:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Countrycode:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> City: Benin City Countrycode: NGA </pre></div> </div> </div> <a name='mysqli-stmt.data-seek.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</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="mysqli_stmt_close" value="<div id='mysqli-stmt.close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.close.php'>mysqli_stmt::close</a></h1> <h1 class='refname'>mysqli_stmt_close</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::close</span> -- <span class='refname'>mysqli_stmt_close</span> &amp;mdash; <span class='dc-title'>Closes a prepared statement</span></p> </div> <a name='mysqli-stmt.close.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::close</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_close</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Closes a prepared statement. <b>mysqli_stmt_close()</b> also deallocates the statement handle. If the current statement has pending or unread results, this function cancels them so that the next query can be executed. </p> </div> <a name='mysqli-stmt.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'> stmt</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.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='mysqli-stmt.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/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</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="mysqli_stmt_bind_result" value="<div id='mysqli-stmt.bind-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.bind-result.php'>mysqli_stmt::bind_result</a></h1> <h1 class='refname'>mysqli_stmt_bind_result</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::bind_result</span> -- <span class='refname'>mysqli_stmt_bind_result</span> &amp;mdash; <span class='dc-title'>Passa vari&amp;aacute;veis para um preparado comando por resultado armazenado</span></p> </div> <a name='mysqli-stmt.bind-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::bind_result</b></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;$var1</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;$...</tt></span> ] )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_bind_result</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></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 reference'>&amp;amp;$var1</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;$...</tt></span> ] )</div> <p class='para rdfs-comment'> Passa colunas em um conjunto de resultados para vari&amp;aacute;veis. </p> <p class='para'> Quando <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a> &amp;eacute; chamada para obter dados, o MySQL client/server protocol coloca a informa&amp;ccedil;&amp;atilde;o das colunas nas especificadas vari&amp;aacute;veis <i><tt class='parameter'>var1, ...</tt></i> . </p> <blockquote><p><b class='note'>Nota</b>: Note que todas as colunas precisam ser determinadas antes de <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function'>mysqli_stmt_execute()</a> e antes de chamar <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a>. Dependendo do tipo da coluna de determinada vari&amp;aacute;vel pode silenciosamente mudar para o tipo do PHP correspondente. <br /> Uma coluna pode ser especificada ou n&amp;atilde;o especificada em dado tempo, at&amp;eacute; mesmo depois de um conjunto de resultado tem sido parcialmente recebido. A nova passagem pega o efeito da &amp;uacute;ltima chamada a <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt_fetch()</a>. <br /> </p></blockquote> </div> <a name='mysqli-stmt.bind-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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>var1</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser determinada. </p> </dd> </dl> <p> </p> </div> <a name='mysqli-stmt.bind-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='mysqli-stmt.bind-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;prepare&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Code,&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;variables&amp;nbsp;to&amp;nbsp;prepared&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$col1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col2</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;values&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col2</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;prepare&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Code,&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;variables&amp;nbsp;to&amp;nbsp;prepared&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col2</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;values&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_stmt_fetch</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;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col2</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> AFG Afghanistan ALB Albania DZA Algeria ASM American Samoa AND Andorra </pre></div> </div> </div> <a name='mysqli-stmt.bind-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/mysqli-stmt.bind-param.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_param()</a> - Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_execute()</a> - Executa uma preparada query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_fetch()</a> - Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_prepare()</a> - Prepara uma declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SQL para execu&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_init()</a> - Initializes a statement and returns an object for use with mysqli_stmt_prepare</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_errno()</a> - Returns the error code for the most recent statement call</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.error.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_error()</a> - Returns a string description for last statement error</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="mysqli_stmt_bind_param" value="<div id='mysqli-stmt.bind-param' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.bind-param.php'>mysqli_stmt::bind_param</a></h1> <h1 class='refname'>mysqli_stmt_bind_param</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::bind_param</span> -- <span class='refname'>mysqli_stmt_bind_param</span> &amp;mdash; <span class='dc-title'>Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros</span></p> </div> <a name='mysqli-stmt.bind-param.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::bind_param</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$types</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;$var1</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;$...</tt></span> ] )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_bind_param</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$types</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;$var1</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;$...</tt></span> ] )</div> <p class='para rdfs-comment'> Passa vari&amp;aacute;veis para marcadores de par&amp;acirc;metros no comando SQL que foi passado para <a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function'>mysqli_prepare()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Se o tamanho da informa&amp;ccedil;&amp;atilde;o da vari&amp;aacute;veis excede o m&amp;aacute;ximo permitido do tamanho de pacote (max_allowed_packet), voc&amp;ecirc; deve especificar <i>b</i> no <i><tt class='parameter'>types</tt></i> e usar <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php' class='function'>mysqli_stmt_send_long_data()</a> para enviar a informa&amp;ccedil;&amp;atilde;o em pacotes. <br /> </p></blockquote> </div> <a name='mysqli-stmt.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>types</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string que cont&amp;eacute;m um ou mais caracteres que especifica os tipos para as correspondente vari&amp;aacute;veis passadas: </p><table class='doctable table'> <caption><b>Caracteres de especifica&amp;ccedil;&amp;atilde;o de tipo</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Caractere</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>i</td> <td align='left'>corresponde a uma vari&amp;aacute;vel de tipo inteiro</td> </tr> <tr valign='middle'> <td align='left'>d</td> <td align='left'>corresponde a uma vari&amp;aacute;vel de tipo double</td> </tr> <tr valign='middle'> <td align='left'>s</td> <td align='left'>corresponde a uma vari&amp;aacute;vel de tipo string</td> </tr> <tr valign='middle'> <td align='left'>b</td> <td align='left'>corresponde a uma vari&amp;aacute;vel que cont&amp;eacute;m dados para um blob e enviar&amp;aacute; em pacotes</td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>var1</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero de vari&amp;aacute;veis e tamanho da string <i><tt class='parameter'>types</tt></i> precisa combinar com os par&amp;acirc;metros no comando. </p> </dd> </dl> <p> </p> </div> <a name='mysqli-stmt.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='mysqli-stmt.bind-param.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;CountryLanguage&amp;nbsp;VALUES&amp;nbsp;(?,&amp;nbsp;?,&amp;nbsp;?,&amp;nbsp;?)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_param</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'sssd'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$language</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$official</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$percent</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$code&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DEU'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$language&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Bavarian'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$official&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'F'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$percent&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>11.2</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;prepared&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%d&amp;nbsp;Row&amp;nbsp;inserted.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;and&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Clean&amp;nbsp;up&amp;nbsp;table&amp;nbsp;CountryLanguage&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;CountryLanguage&amp;nbsp;WHERE&amp;nbsp;Language='Bavarian''</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%d&amp;nbsp;Row&amp;nbsp;deleted.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;CountryLanguage&amp;nbsp;VALUES&amp;nbsp;(?,&amp;nbsp;?,&amp;nbsp;?,&amp;nbsp;?)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_stmt_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'sssd'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$language</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$official</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$percent</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$code&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'DEU'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$language&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Bavarian'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$official&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'F'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$percent&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>11.2</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;prepared&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_stmt_execute</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%d&amp;nbsp;Row&amp;nbsp;inserted.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;and&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Clean&amp;nbsp;up&amp;nbsp;table&amp;nbsp;CountryLanguage&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;CountryLanguage&amp;nbsp;WHERE&amp;nbsp;Language='Bavarian''</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%d&amp;nbsp;Row&amp;nbsp;deleted.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> 1 Row inserted. 1 Row deleted. </pre></div> </div> </div> <a name='mysqli-stmt.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/mysqli-stmt.bind-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_result()</a> - Passa vari&amp;aacute;veis para um preparado comando por resultado armazenado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_execute()</a> - Executa uma preparada query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_fetch()</a> - Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_send_long_data()</a> - Send data in blocks</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_errno()</a> - Returns the error code for the most recent statement call</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.error.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_error()</a> - Returns a string description for last statement error</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="mysqli_stmt_attr_set" value="<div id='mysqli-stmt.attr-set' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.attr-set.php'>mysqli_stmt::attr_set</a></h1> <h1 class='refname'>mysqli_stmt_attr_set</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::attr_set</span> -- <span class='refname'>mysqli_stmt_attr_set</span> &amp;mdash; <span class='dc-title'>Used to modify the behavior of a prepared statement</span></p> </div> <a name='mysqli-stmt.attr-set.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt::attr_set</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attr</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mode</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_stmt_attr_set</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attr</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mode</tt></span> )</div> <p class='para rdfs-comment'> Used to modify the behavior of a prepared statement. This function may be called multiple times to set several attributes. </p> </div> <a name='mysqli-stmt.attr-set.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The attribute that you want to set. It can have one of the following values: </p><table class='doctable table'> <caption><b>Attribute values</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Character</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH</td> <td align='left'> If set to 1, causes <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a> to update the metadata <i>MYSQL_FIELD-&amp;gt;max_length</i> value. </td> </tr> <tr valign='middle'> <td align='left'>MYSQLI_STMT_ATTR_CURSOR_TYPE</td> <td align='left'> Type of cursor to open for statement when <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function'>mysqli_stmt_execute()</a> is invoked. <i><tt class='parameter'>mode</tt></i> can be <i>MYSQLI_CURSOR_TYPE_NO_CURSOR</i> (the default) or <i>MYSQLI_CURSOR_TYPE_READ_ONLY</i>. </td> </tr> <tr valign='middle'> <td align='left'>MYSQLI_STMT_ATTR_PREFETCH_ROWS</td> <td align='left'> Number of rows to fetch from server at a time when using a cursor. <i><tt class='parameter'>mode</tt></i> can be in the range from 1 to the maximum value of unsigned long. The default is 1. </td> </tr> </tbody> </table> <p> </p> <p class='para'> If you use the <i>MYSQLI_STMT_ATTR_CURSOR_TYPE</i> option with <i>MYSQLI_CURSOR_TYPE_READ_ONLY</i>, a cursor is opened for the statement when you invoke <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function'>mysqli_stmt_execute()</a>. If there is already an open cursor from a previous <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function'>mysqli_stmt_execute()</a> call, it closes the cursor before opening a new one. <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.reset.php' class='function'>mysqli_stmt_reset()</a> also closes any open cursor before preparing the statement for re-execution. <b>mysqli_stmt_free_result()</b> closes any open cursor. </p> <p class='para'> If you open a cursor for a prepared statement, <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a> is unnecessary. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>mode</tt></i> </span> </dt><dd class='listitem'> <p class='para'>The value to assign to the attribute.</p> </dd> </dl> <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="mysqli_stmt_attr_get" value="<div id='mysqli-stmt.attr-get' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.attr-get.php'>mysqli_stmt::attr_get</a></h1> <h1 class='refname'>mysqli_stmt_attr_get</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt::attr_get</span> -- <span class='refname'>mysqli_stmt_attr_get</span> &amp;mdash; <span class='dc-title'>Used to get the current value of a statement attribute</span></p> </div> <a name='mysqli-stmt.attr-get.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt::attr_get</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attr</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt_attr_get</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attr</tt></span> )</div> <p class='para rdfs-comment'> Gets the current value of a statement attribute. </p> </div> <a name='mysqli-stmt.attr-get.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>attr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The attribute that you want to get. </p> </dd> </dl> <p> </p> </div> <a name='mysqli-stmt.attr-get.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns <b><tt class='constant'>FALSE</tt></b> if the attribute is not found, otherwise returns the value of the attribute. </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="mysqli_stmt_affected_rows" value="<div id='mysqli-stmt.affected-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.affected-rows.php'>mysqli_stmt-&amp;gt;affected_rows</a></h1> <h1 class='refname'>mysqli_stmt_affected_rows</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_stmt-&amp;gt;affected_rows</span> -- <span class='refname'>mysqli_stmt_affected_rows</span> &amp;mdash; <span class='dc-title'>Returns the total number of rows changed, deleted, or inserted by the last executed statement </span></p> </div> <a name='mysqli-stmt.affected-rows.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_stmt</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$affected_rows</var>;</div> </div> <p class='para'>Procedural style :</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_stmt_affected_rows</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of rows affected by <i>INSERT</i>, <i>UPDATE</i>, or <i>DELETE</i> query. </p> <p class='para'> This function only works with queries which update a table. In order to get the number of rows from a SELECT query, use <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.num-rows.php' class='function'>mysqli_stmt_num_rows()</a> instead. </p> </div> <a name='mysqli-stmt.affected-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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.affected-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An integer greater than zero indicates the number of rows affected or retrieved. Zero indicates that no records where updated for an UPDATE/DELETE statement, no rows matched the WHERE clause in the query or that no query has yet been executed. -1 indicates that the query has returned an error. NULL indicates an invalid argument was supplied to the function. </p> <blockquote><p><b class='note'>Nota</b>: If the number of affected rows is greater than maximal PHP int value, the number of affected rows will be returned as a string value. <br /> </p></blockquote> </div> <a name='mysqli-stmt.affected-rows.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;create&amp;nbsp;temp&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</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'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;WHERE&amp;nbsp;Code&amp;nbsp;LIKE&amp;nbsp;?'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;prepare&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</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&amp;nbsp;variable&amp;nbsp;for&amp;nbsp;placeholder&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$code&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'A%'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_param</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><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'>'rows&amp;nbsp;inserted:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;create&amp;nbsp;temp&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;myCountry&amp;nbsp;LIKE&amp;nbsp;Country'</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'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCountry&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;WHERE&amp;nbsp;Code&amp;nbsp;LIKE&amp;nbsp;?'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;prepare&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</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&amp;nbsp;variable&amp;nbsp;for&amp;nbsp;placeholder&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$code&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'A%'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$code</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'rows&amp;nbsp;inserted:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_affected_rows</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: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> rows inserted: 17 </pre></div> </div> </div> <a name='mysqli-stmt.affected-rows.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/mysqli-stmt.num-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_num_rows()</a> - Return the number of rows in statements result set</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function' rel='rdfs-seeAlso'>mysqli_prepare()</a> - Prepare a SQL statement for execution</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="MySQLi_STMT" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.mysqli-stmt.php'>A classe MySQLi_STMT</a></h1> <div class='partintro'> <div id='mysqli-stmt.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Representa um comando preparado. </p> </div> <div id='mysqli-stmt.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>MySQLi_STMT</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>MySQLi_STMT</b> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Propriedades */</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$affected_rows</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$errno</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$error</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$field_count</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$insert_id</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$num_rows</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$param_count</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$sqlstate</var>;</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* M&amp;eacute;todos */</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.affected-rows.php' class='function'>mysqli_stmt_affected_rows</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.attr-get.php' class='function'>mysqli_stmt::attr_get</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attr</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.attr-set.php' class='function'>mysqli_stmt::attr_set</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$attr</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mode</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function'>mysqli_stmt::bind_param</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$types</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;$var1</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;$...</tt></span> ] )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function'>mysqli_stmt::bind_result</a></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;$var1</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;$...</tt></span> ] )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.close.php' class='function'>mysqli_stmt::close</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.data-seek.php' class='function'>mysqli_stmt::data_seek</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.errno.php' class='function'>mysqli_stmt_errno</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.error.php' class='function'>mysqli_stmt_error</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php' class='function'>mysqli_stmt::execute</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function'>mysqli_stmt::fetch</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.field-count.php' class='function'>mysqli_stmt_field_count</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><b>mysqli_stmt::free_result</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.get-warnings.php' class='function'>mysqli_stmt::get_warnings</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.insert-id.php' class='function'>mysqli_stmt_insert_id</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.num-rows.php' class='function'>mysqli_stmt_num_rows</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.param-count.php' class='function'>mysqli_stmt_param_count</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.prepare.php' class='function'>mysqli_stmt::prepare</a></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'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.reset.php' class='function'>mysqli_stmt::reset</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli_result</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.result-metadata.php' class='function'>mysqli_stmt::result_metadata</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php' class='function'>mysqli_stmt::send_long_data</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$param_nr</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$data</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.sqlstate.php' class='function'>mysqli_stmt_sqlstate</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt::store_result</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.affected-rows.php'>mysqli_stmt->affected_rows</a> &amp;mdash; Returns the total number of rows changed, deleted, or inserted by the last executed statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.attr-get.php'>mysqli_stmt::attr_get</a> &amp;mdash; Used to get the current value of a statement attribute</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.attr-set.php'>mysqli_stmt::attr_set</a> &amp;mdash; Used to modify the behavior of a prepared statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php'>mysqli_stmt::bind_param</a> &amp;mdash; Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php'>mysqli_stmt::bind_result</a> &amp;mdash; Passa vari&amp;aacute;veis para um preparado comando por resultado armazenado</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.close.php'>mysqli_stmt::close</a> &amp;mdash; Closes a prepared statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.data-seek.php'>mysqli_stmt::data_seek</a> &amp;mdash; Seeks to an arbitrary row in statement result set</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.errno.php'>mysqli_stmt->errno</a> &amp;mdash; Returns the error code for the most recent statement call</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.error.php'>mysqli_stmt->error</a> &amp;mdash; Returns a string description for last statement error</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.execute.php'>mysqli_stmt->execute</a> &amp;mdash; Executa uma preparada query</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php'>mysqli_stmt::fetch</a> &amp;mdash; Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.field-count.php'>mysqli_stmt->field_count</a> &amp;mdash; Returns the number of field in the given statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.free-result.php'>mysqli_free_result</a> &amp;mdash; Libera a mem&amp;oacute;ria associada ao resultado</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.get-warnings.php'>mysqli_stmt::get_warnings</a> &amp;mdash; Get result of SHOW WARNINGS</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.insert-id.php'>mysqli_stmt->insert_id</a> &amp;mdash; Get the ID generated from the previous INSERT operation</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.num-rows.php'>mysqli_stmt::num_rows</a> &amp;mdash; Return the number of rows in statements result set</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.param-count.php'>mysqli_stmt->param_count</a> &amp;mdash; Returns the number of parameter for the given statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.prepare.php'>mysqli_stmt::prepare</a> &amp;mdash; Prepara uma declara&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o SQL para execu&amp;Atilde;&amp;sect;&amp;Atilde;&amp;pound;o</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.reset.php'>mysqli_stmt::reset</a> &amp;mdash; Resets a prepared statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.result-metadata.php'>mysqli_stmt::result_metadata</a> &amp;mdash; Returns result set metadata from a prepared statement</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php'>mysqli_stmt::send_long_data</a> &amp;mdash; Send data in blocks</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.sqlstate.php'>mysqli_stmt::sqlstate</a> &amp;mdash; Returns SQLSTATE error from previous statement operation</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php'>mysqli_stmt::store_result</a> &amp;mdash; Transfers a result set from a prepared statement</li></ul> </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="mysqli_stat" value="<div id='mysqli.stat' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.stat.php'>mysqli::stat</a></h1> <h1 class='refname'>mysqli_stat</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::stat</span> -- <span class='refname'>mysqli_stat</span> &amp;mdash; <span class='dc-title'>Gets the current system status</span></p> </div> <a name='mysqli.stat.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli::stat</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_stat</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> <b>mysqli_stat()</b> returns a string containing information similar to that provided by the &amp;#039;mysqladmin status&amp;#039; command. This includes uptime in seconds and the number of running threads, questions, reloads, and open tables. </p> </div> <a name='mysqli.stat.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.stat.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A string describing the server status. <b><tt class='constant'>FALSE</tt></b> if an error occurred. </p> </div> <a name='mysqli.stat.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'System&amp;nbsp;status:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>stat</span><span style='color: #007700'>());<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'System&amp;nbsp;status:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stat</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> System status: Uptime: 272 Threads: 1 Questions: 5340 Slow queries: 0 Opens: 13 Flush tables: 1 Open tables: 0 Queries per second avg: 19.632 Memory in use: 8496K Max memory used: 8560K </pre></div> </div> </div> <a name='mysqli.stat.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/mysqli.get-server-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_info()</a> - Retorna a vers&amp;atilde;o do servidor MySQL</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="mysqli_ssl_set" value="<div id='mysqli.ssl-set' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.ssl-set.php'>mysqli::ssl_set</a></h1> <h1 class='refname'>mysqli_ssl_set</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::ssl_set</span> -- <span class='refname'>mysqli_ssl_set</span> &amp;mdash; <span class='dc-title'>Used for establishing secure connections using SSL</span></p> </div> <a name='mysqli.ssl-set.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::ssl_set</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$key</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$cert</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$ca</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$capath</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$cipher</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_ssl_set</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$key</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$cert</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$ca</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$capath</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$cipher</tt></span> )</div> <p class='para rdfs-comment'> Used for establishing secure connections using SSL. It must be called before <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</a>. This function does nothing unless OpenSSL support is enabled. </p> <p class='para'> Note that MySQL Native Driver does not support SSL, so calling this function when using MySQL Native Driver will result in an error. MySQL Native Driver is enabled by default on Microsoft Windows from PHP version 5.3 onwards. </p> </div> <a name='mysqli.ssl-set.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>key</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The path name to the key file. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>cert</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The path name to the certificate file. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>ca</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The path name to the certificate authority file. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>capath</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The pathname to a directory that contains trusted SSL CA certificates in PEM format. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>cipher</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A list of allowable ciphers to use for SSL encryption. </p> </dd> </dl> <p> </p> <p class='para'> Any unused SSL parameters may be given as <b><tt class='constant'>NULL</tt></b> </p> </div> <a name='mysqli.ssl-set.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> This function always returns <b><tt class='constant'>TRUE</tt></b> value. If SSL setup is incorrect <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</a> will return an error when you attempt to connect. </p> </div> <a name='mysqli.ssl-set.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/mysqli.options.php' class='function' rel='rdfs-seeAlso'>mysqli_options()</a> - Set options</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function' rel='rdfs-seeAlso'>mysqli_real_connect()</a> - Opens a connection to a mysql 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="mysqli_sqlstate" value="<div id='mysqli.sqlstate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.sqlstate.php'>mysqli-&amp;gt;sqlstate</a></h1> <h1 class='refname'>mysqli_sqlstate</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;sqlstate</span> -- <span class='refname'>mysqli_sqlstate</span> &amp;mdash; <span class='dc-title'>Returns the SQLSTATE error from previous MySQL operation</span></p> </div> <a name='mysqli.sqlstate.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$sqlstate</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_sqlstate</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Returns a string containing the SQLSTATE error code for the last error. The error code consists of five characters. <i>&amp;#039;00000&amp;#039;</i> means no error. The values are specified by ANSI SQL and ODBC. For a list of possible values, see <a href='http://dev.mysql.com/doc/mysql/en/error-handling.html' class='link external'>&amp;raquo; http://dev.mysql.com/doc/mysql/en/error-handling.html</a>. </p> <blockquote><p><b class='note'>Nota</b>: Note that not all MySQL errors are yet mapped to SQLSTATE&amp;#039;s. The value <i>HY000</i> (general error) is used for unmapped errors. <br /> </p></blockquote> </div> <a name='mysqli.sqlstate.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.sqlstate.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a string containing the SQLSTATE error code for the last error. The error code consists of five characters. <i>&amp;#039;00000&amp;#039;</i> means no error. </p> </div> <a name='mysqli.sqlstate.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Table&amp;nbsp;City&amp;nbsp;already&amp;nbsp;exists,&amp;nbsp;so&amp;nbsp;we&amp;nbsp;should&amp;nbsp;get&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;City&amp;nbsp;(ID&amp;nbsp;INT,&amp;nbsp;Name&amp;nbsp;VARCHAR(30))'</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;-&amp;nbsp;SQLSTATE&amp;nbsp;%s.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>sqlstate</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Table&amp;nbsp;City&amp;nbsp;already&amp;nbsp;exists,&amp;nbsp;so&amp;nbsp;we&amp;nbsp;should&amp;nbsp;get&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;City&amp;nbsp;(ID&amp;nbsp;INT,&amp;nbsp;Name&amp;nbsp;VARCHAR(30))'</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;-&amp;nbsp;SQLSTATE&amp;nbsp;%s.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_sqlstate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error - SQLSTATE 42S01. </pre></div> </div> </div> <a name='mysqli.sqlstate.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/mysqli.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_errno()</a> - Retorna o c&amp;oacute;digo de erro para a chamada de fun&amp;ccedil;&amp;atilde;o mais recente</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function' rel='rdfs-seeAlso'>mysqli_error()</a> - Retorna uma string descrevendo o ultimo erro</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="mysqli_slave_query" value="<div id='function.mysqli-slave-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-slave-query.php'>mysqli_slave_query</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_slave_query</span> &amp;mdash; <span class='dc-title'>Force execution of a query on a slave in a master/slave setup</span></p> </div> <a name='function.mysqli-slave-query.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>mysqli_slave_query</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_set_opt" value="<div id='function.mysqli-set-opt' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-set-opt.php'>mysqli_set_opt</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_set_opt</span> &amp;mdash; <span class='dc-title'>Alias of <a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function'>mysqli_options()</a></span></p> </div> <a name='function.mysqli-set-opt.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'> This function is an alias of <a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function'>mysqli_options()</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="mysqli_set_local_infile_handler" value="<div id='mysqli.set-local-infile-handler' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.set-local-infile-handler.php'>mysqli::set_local_infile_handler</a></h1> <h1 class='refname'>mysqli_set_local_infile_handler</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::set_local_infile_handler</span> -- <span class='refname'>mysqli_set_local_infile_handler</span> &amp;mdash; <span class='dc-title'>Set callback function for LOAD DATA LOCAL INFILE command</span></p> </div> <a name='mysqli.set-local-infile-handler.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>mysqli_set_local_infile_handler</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.callback' class='type callback'>callback</a></span> <tt class='parameter'>$read_func</tt></span> )</div> <p class='para rdfs-comment'>Object oriented style (method)</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>set_local_infile_handler</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.callback' class='type callback'>callback</a></span> <tt class='parameter'>$read_func</tt></span> )</div> </div> <p class='para'>Set callback function for LOAD DATA LOCAL INFILE command</p> <p class='para'> The callbacks task is to read input from the file specified in the <i>LOAD DATA LOCAL INFILE</i> and to reformat it into the format understood by <i>LOAD DATA INFILE</i>. </p> <p class='para'> The returned data needs to match the format specified in the <i>LOAD DATA</i> </p> </div> <a name='mysqli.set-local-infile-handler.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>read_func</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A callback function or object method taking the following parameters: </p> <dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>stream</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A PHP stream associated with the SQL commands INFILE</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>&amp;amp;buffer</tt></i> </span> </dt><dd class='listitem'> <p class='para'>A string buffer to store the rewritten input into</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>buflen</tt></i> </span> </dt><dd class='listitem'> <p class='para'>The maximum number of characters to be stored in the buffer</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>&amp;amp;errormsg</tt></i> </span> </dt><dd class='listitem'> <p class='para'>If an error occurs you can store an error message in here</p></dd> </dl> </dd> </dl> <p> </p> <p class='para'> The callback function should return the number of characters stored in the <i><tt class='parameter'>buffer</tt></i> or a negative value if an error occurred. </p> </div> <a name='mysqli.set-local-infile-handler.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='mysqli.set-local-infile-handler.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_init</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>real_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'root'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>callme</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stream</span><span style='color: #007700'>,&amp;nbsp;&amp;amp;</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$buflen</span><span style='color: #007700'>,&amp;nbsp;&amp;amp;</span><span style='color: #0000BB'>$errmsg</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$buffer&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>fgets</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stream</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;convert&amp;nbsp;to&amp;nbsp;upper&amp;nbsp;case&amp;nbsp;and&amp;nbsp;replace&amp;nbsp;','&amp;nbsp;delimiter&amp;nbsp;with&amp;nbsp;[TAB]<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$buffer&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>strtoupper</span><span style='color: #007700'>(</span><span style='color: #0000BB'>str_replace</span><span style='color: #007700'>(</span><span style='color: #DD0000'>','</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\t'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>));<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>strlen</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br /><br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Input:\n'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>set_local_infile_handler</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'callme'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'LOAD&amp;nbsp;DATA&amp;nbsp;LOCAL&amp;nbsp;INFILE&amp;nbsp;'input.txt'&amp;nbsp;INTO&amp;nbsp;TABLE&amp;nbsp;t1'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>set_local_infile_default</span><span style='color: #007700'>();<br /><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'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;t1'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'\nResult:\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'>$res</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_assoc</span><span style='color: #007700'>())&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>join</span><span style='color: #007700'>(</span><span style='color: #DD0000'>','</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>).</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_init</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_real_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'root'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>callme</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stream</span><span style='color: #007700'>,&amp;nbsp;&amp;amp;</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$buflen</span><span style='color: #007700'>,&amp;nbsp;&amp;amp;</span><span style='color: #0000BB'>$errmsg</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$buffer&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>fgets</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stream</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;convert&amp;nbsp;to&amp;nbsp;upper&amp;nbsp;case&amp;nbsp;and&amp;nbsp;replace&amp;nbsp;','&amp;nbsp;delimiter&amp;nbsp;with&amp;nbsp;[TAB]<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$buffer&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>strtoupper</span><span style='color: #007700'>(</span><span style='color: #0000BB'>str_replace</span><span style='color: #007700'>(</span><span style='color: #DD0000'>','</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\t'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>));<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>strlen</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$buffer</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;}<br /><br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Input:\n'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_set_local_infile_handler</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'callme'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'LOAD&amp;nbsp;DATA&amp;nbsp;LOCAL&amp;nbsp;INFILE&amp;nbsp;'input.txt'&amp;nbsp;INTO&amp;nbsp;TABLE&amp;nbsp;t1'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_set_local_infile_default</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>);<br /><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'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;t1'</span><span style='color: #007700'>);<br /><br /><br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'\nResult:\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'>mysqli_fetch_assoc</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;echo&amp;nbsp;</span><span style='color: #0000BB'>join</span><span style='color: #007700'>(</span><span style='color: #DD0000'>','</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row</span><span style='color: #007700'>).</span><span style='color: #DD0000'>'\n'</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 class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Input: 23,foo 42,bar Output: 23,FOO 42,BAR </pre></div> </div> </div> <a name='mysqli.set-local-infile-handler.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/mysqli.set-local-infile-default.php' class='function' rel='rdfs-seeAlso'>mysqli_set_local_infile_default()</a> - Unsets user defined handler for load local infile 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="mysqli_set_local_infile_default" value="<div id='mysqli.set-local-infile-default' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.set-local-infile-default.php'>mysqli::set_local_infile_default</a></h1> <h1 class='refname'>mysqli_set_local_infile_default</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::set_local_infile_default</span> -- <span class='refname'>mysqli_set_local_infile_default</span> &amp;mdash; <span class='dc-title'>Unsets user defined handler for load local infile command</span></p> </div> <a name='mysqli.set-local-infile-default.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>mysqli_set_local_infile_default</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Deactivates a <i>LOAD DATA INFILE LOCAL</i> handler previously set with <a href='http://www.php.net/manual/pt_BR/mysqli.set-local-infile-handler.php' class='function'>mysqli_set_local_infile_handler()</a>. </p> </div> <a name='mysqli.set-local-infile-default.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.set-local-infile-default.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='mysqli.set-local-infile-default.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'>See <a href='http://www.php.net/manual/pt_BR/mysqli.set-local-infile-handler.php' class='function'>mysqli_set_local_infile_handler()</a> examples</p> </div> <a name='mysqli.set-local-infile-default.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/mysqli.set-local-infile-handler.php' class='function' rel='rdfs-seeAlso'>mysqli_set_local_infile_handler()</a> - Set callback function for LOAD DATA LOCAL INFILE 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="mysqli_set_charset" value="<div id='mysqli.set-charset' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.set-charset.php'>mysqli::set_charset</a></h1> <h1 class='refname'>mysqli_set_charset</h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.0.5)</p><p class='refpurpose'><span class='refname'>mysqli::set_charset</span> -- <span class='refname'>mysqli_set_charset</span> &amp;mdash; <span class='dc-title'>Sets the default client character set</span></p> </div> <a name='mysqli.set-charset.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::set_charset</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_set_charset</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> )</div> <p class='para rdfs-comment'> Sets the default character set to be used when sending data from and to the database server. </p> </div> <a name='mysqli.set-charset.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>charset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The charset to be set as default. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.set-charset.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='mysqli.set-charset.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: To use this function on a Windows platform you need MySQL client library version 4.1.11 or above (for MySQL 5.0 you need 5.0.6 or above). <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: This is the preferred way to change the charset. Using <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli::query()</a> to execute <i>SET NAMES ..</i> is not recommended. <br /> </p></blockquote> </div> <a name='mysqli.set-charset.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;change&amp;nbsp;character&amp;nbsp;set&amp;nbsp;to&amp;nbsp;utf8&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>set_charset</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'utf8'</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;loading&amp;nbsp;character&amp;nbsp;set&amp;nbsp;utf8:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</span><span style='color: #007700'>);<br />}&amp;nbsp;else&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'>'Current&amp;nbsp;character&amp;nbsp;set:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>character_set_name</span><span style='color: #007700'>());<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;change&amp;nbsp;character&amp;nbsp;set&amp;nbsp;to&amp;nbsp;utf8&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_set_charset</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'utf8'</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;loading&amp;nbsp;character&amp;nbsp;set&amp;nbsp;utf8:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}&amp;nbsp;else&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'>'Current&amp;nbsp;character&amp;nbsp;set:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_character_set_name</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Current character set: utf8 </pre></div> </div> </div> <a name='mysqli.set-charset.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/mysqli.character-set-name.php' class='function' rel='rdfs-seeAlso'>mysqli_character_set_name()</a> - Retorna o conjunto de caracteres padr&amp;atilde;o para a conex&amp;atilde;o com o banco de dados</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.real-escape-string.php' class='function' rel='rdfs-seeAlso'>mysqli_real_escape_string()</a> - Escapes special characters in a string for use in a SQL statement, taking into account the current charset of the connection</li> <li class='member'><a href='http://dev.mysql.com/doc/refman/5.1/en/charset-charsets.html' class='link external'>&amp;raquo; List of character sets that MySQL supports</a></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="mysqli_send_query" value="<div id='function.mysqli-send-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-send-query.php'>mysqli_send_query</a></h1> <h1 class='refname'>mysqli-&amp;gt;send_query</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_send_query</span> -- <span class='refname'>mysqli-&amp;gt;send_query</span> &amp;mdash; <span class='dc-title'>Send the query and return</span></p> </div> <a name='function.mysqli-send-query.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_send_query</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'>Object oriented style (method)</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>send_query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> </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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_send_long_data" value="<div id='function.mysqli-send-long-data' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-send-long-data.php'>mysqli_send_long_data</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_send_long_data</span> &amp;mdash; <span class='dc-title'>Alias for <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php' class='function'>mysqli_stmt_send_long_data()</a></span></p> </div> <a name='function.mysqli-send-long-data.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'> This function is an alias of <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.send-long-data.php' class='function'>mysqli_stmt_send_long_data()</a>. </p> </div> <a name='function.mysqli-send-long-data.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>mysqli_send_long_data()</b> is deprecated and will be removed. <br /> </p></blockquote> </div> <a name='function.mysqli-send-long-data.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/mysqli-stmt.send-long-data.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_send_long_data()</a> - Send data in blocks</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="mysqli_select_db" value="<div id='mysqli.select-db' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.select-db.php'>mysqli::select_db</a></h1> <h1 class='refname'>mysqli_select_db</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::select_db</span> -- <span class='refname'>mysqli_select_db</span> &amp;mdash; <span class='dc-title'>Selects the default database for database queries</span></p> </div> <a name='mysqli.select-db.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::select_db</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_select_db</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> )</div> <p class='para rdfs-comment'> Selects the default database to be used when performing queries against the database connection. </p> <blockquote><p><b class='note'>Nota</b>: This function should only be used to change the default database for the connection. You can select the default database with 4th parameter in <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>. <br /> </p></blockquote> </div> <a name='mysqli.select-db.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dbname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The database name. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.select-db.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='mysqli.select-db.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;return&amp;nbsp;name&amp;nbsp;of&amp;nbsp;current&amp;nbsp;default&amp;nbsp;database&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;DATABASE()'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>'Default&amp;nbsp;database&amp;nbsp;is&amp;nbsp;%s.\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;change&amp;nbsp;db&amp;nbsp;to&amp;nbsp;world&amp;nbsp;db&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>select_db</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;return&amp;nbsp;name&amp;nbsp;of&amp;nbsp;current&amp;nbsp;default&amp;nbsp;database&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;DATABASE()'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>'Default&amp;nbsp;database&amp;nbsp;is&amp;nbsp;%s.\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;return&amp;nbsp;name&amp;nbsp;of&amp;nbsp;current&amp;nbsp;default&amp;nbsp;database&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;DATABASE()'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Default&amp;nbsp;database&amp;nbsp;is&amp;nbsp;%s.\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;change&amp;nbsp;db&amp;nbsp;to&amp;nbsp;world&amp;nbsp;db&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_select_db</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;return&amp;nbsp;name&amp;nbsp;of&amp;nbsp;current&amp;nbsp;default&amp;nbsp;database&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;DATABASE()'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Default&amp;nbsp;database&amp;nbsp;is&amp;nbsp;%s.\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Default database is test. Default database is world. </pre></div> </div> </div> <a name='mysqli.select-db.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/mysqli.connect.php' class='function' rel='rdfs-seeAlso'>mysqli_connect()</a> - Abre uma nova conex&amp;atilde;o com o servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function' rel='rdfs-seeAlso'>mysqli_real_connect()</a> - Opens a connection to a mysql 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="mysqli_rpl_query_type" value="<div id='function.mysqli-rpl-query-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-rpl-query-type.php'>mysqli_rpl_query_type</a></h1> <h1 class='refname'>mysqli-&amp;gt;rpl_query_type</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_rpl_query_type</span> -- <span class='refname'>mysqli-&amp;gt;rpl_query_type</span> &amp;mdash; <span class='dc-title'>Returns RPL query type</span></p> </div> <a name='function.mysqli-rpl-query-type.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_rpl_query_type</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'>Object oriented style (method)</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>rpl_query_type</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> </div> <p class='para'> Returns <b><tt class='constant'>MYSQLI_RPL_MASTER</tt></b>, <b><tt class='constant'>MYSQLI_RPL_SLAVE</tt></b> or <b><tt class='constant'>MYSQLI_RPL_ADMIN</tt></b> depending on a query type. <i>INSERT</i>, <i>UPDATE</i> and similar are <em class='emphasis'>master</em> queries, <i>SELECT</i> is <em class='emphasis'>slave</em>, and <i>FLUSH</i>, <i>REPAIR</i> and similar are <em class='emphasis'>admin</em>. </p> <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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_rpl_probe" value="<div id='function.mysqli-rpl-probe' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-rpl-probe.php'>mysqli_rpl_probe</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_rpl_probe</span> &amp;mdash; <span class='dc-title'>RPL probe</span></p> </div> <a name='function.mysqli-rpl-probe.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>mysqli_rpl_probe</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_rpl_parse_enabled" value="<div id='function.mysqli-rpl-parse-enabled' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-rpl-parse-enabled.php'>mysqli_rpl_parse_enabled</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_rpl_parse_enabled</span> &amp;mdash; <span class='dc-title'>Check if RPL parse is enabled</span></p> </div> <a name='function.mysqli-rpl-parse-enabled.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>mysqli_rpl_parse_enabled</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_rollback" value="<div id='mysqli.rollback' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.rollback.php'>mysqli::rollback</a></h1> <h1 class='refname'>mysqli_rollback</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::rollback</span> -- <span class='refname'>mysqli_rollback</span> &amp;mdash; <span class='dc-title'>Rolls back current transaction</span></p> </div> <a name='mysqli.rollback.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::rollback</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_rollback</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Rollbacks the current transaction for the database. </p> </div> <a name='mysqli.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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.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='mysqli.rollback.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;disable&amp;nbsp;autocommit&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>FALSE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'ALTER&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;Type=InnoDB'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;LIMIT&amp;nbsp;50'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;commit&amp;nbsp;insert&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>commit</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;delete&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;COUNT(*)&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>'%d&amp;nbsp;rows&amp;nbsp;in&amp;nbsp;table&amp;nbsp;myCity.\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Free&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Rollback&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>rollback</span><span style='color: #007700'>();<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;COUNT(*)&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>'%d&amp;nbsp;rows&amp;nbsp;in&amp;nbsp;table&amp;nbsp;myCity&amp;nbsp;(after&amp;nbsp;rollback).\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Free&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Drop&amp;nbsp;table&amp;nbsp;myCity&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;disable&amp;nbsp;autocommit&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>FALSE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ALTER&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;Type=InnoDB'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;LIMIT&amp;nbsp;50'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;commit&amp;nbsp;insert&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_commit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;delete&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;COUNT(*)&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%d&amp;nbsp;rows&amp;nbsp;in&amp;nbsp;table&amp;nbsp;myCity.\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Free&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Rollback&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_rollback</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;COUNT(*)&amp;nbsp;FROM&amp;nbsp;myCity'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%d&amp;nbsp;rows&amp;nbsp;in&amp;nbsp;table&amp;nbsp;myCity&amp;nbsp;(after&amp;nbsp;rollback).\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Free&amp;nbsp;result&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Drop&amp;nbsp;table&amp;nbsp;myCity&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> 0 rows in table myCity. 50 rows in table myCity (after rollback). </pre></div> </div> </div> <a name='mysqli.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/mysqli.commit.php' class='function' rel='rdfs-seeAlso'>mysqli_commit()</a> - Salva a transa&amp;ccedil;&amp;atilde;o atual</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.autocommit.php' class='function' rel='rdfs-seeAlso'>mysqli_autocommit()</a> - Ativa ou desativa o salvar automaticamente as modifica&amp;ccedil;&amp;otilde;es no banco de dados</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="MySQLi_Result" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.mysqli-result.php'>A classe MySQLi_Result</a></h1> <div class='partintro'> <div id='mysqli-result.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Representa o conjunto de resultados da consulta feit ao banco de dados. </p> </div> <div id='mysqli-result.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>MySQLi_Result</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>MySQLi_Result</b> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Propriedades */</div> <div class='fieldsynopsis'> <span class='type'>int</span> <var class='varname'>$current_field</var> ;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$field_count</var>;</div> <div class='fieldsynopsis'><span class='type'>array</span> <var class='varname'>$lengths</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$num_rows</var>;</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* M&amp;eacute;todos */</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.current-field.php' class='function'>mysqli_field_tell</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.data-seek.php' class='function'>mysqli_result::data_seek</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-all.php' class='function'>mysqli_result::fetch_all</a></span> ([ <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$resulttype</tt></span> ] )</div> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php' class='function'>mysqli_result::fetch_assoc</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function'>mysqli_result::fetch_field</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-fields.php' class='function'>mysqli_result::fetch_fields</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function'>mysqli_result::fetch_row</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-count.php' class='function'>mysqli_num_fields</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_result::field_seek</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fieldnr</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function'>mysqli_result::free</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.lengths.php' class='function'>mysqli_fetch_lengths</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-result.num-rows.php' class='function'>mysqli_num_rows</a></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.current-field.php'>mysqli_result->current_field</a> &amp;mdash; Get current field offset of a result pointer</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.data-seek.php'>mysqli_result::data_seek</a> &amp;mdash; Ajusta o ponteiro do resultado para uma linha arbritaria no conjunto de resutados</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-all.php'>mysqli_result::fetch_all</a> &amp;mdash; Fetches all result rows as an associative array, a numeric array, or both</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-array.php'>mysqli_fetch_array</a> &amp;mdash; Obtem uma linha do resultado como uma matriz associativa, num&amp;eacute;rica, ou ambas</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php'>mysqli_result::fetch_assoc</a> &amp;mdash; Obtem uma linha do conjunto de resultados como uma matriz associativa</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field-direct.php'>mysqli_fetch_field_direct</a> &amp;mdash; Obtem meta dados para um &amp;uacute;nico campo</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php'>mysqli_result::fetch_field</a> &amp;mdash; Retorna o pr&amp;oacute;ximo campo no conjunto de resultados</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-fields.php'>mysqli_result::fetch_fields</a> &amp;mdash; Retorna uma matriz de objetos representando os campos em um conjunto de resultados</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-object.php'>mysqli_fetch_object</a> &amp;mdash; Retorna a linha atual do conjunto de resultados como um objeto</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php'>mysqli_result::fetch_row</a> &amp;mdash; Obt&amp;eacute;m uma linha do resultado como uma matriz numerada</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-count.php'>mysqli_result->field_count</a> &amp;mdash; Get the number of fields in a result</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-seek.php'>mysqli_field_seek</a> &amp;mdash; Move o ponteiro do resultado para um campo especificado</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php'>mysqli_result::free</a> &amp;mdash; Frees the memory associated with a result</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.lengths.php'>mysqli_result->lengths</a> &amp;mdash; Returns the lengths of the columns of the current row in the result set</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-result.num-rows.php'>mysqli_result->num_rows</a> &amp;mdash; Gets the number of rows in a result</li></ul> </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="mysqli_report" value="<div id='function.mysqli-report' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-report.php'>mysqli_report</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_report</span> &amp;mdash; <span class='dc-title'>Enables or disables internal report functions</span></p> </div> <a name='function.mysqli-report.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>mysqli_report</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$flags</tt></span> )</div> <p class='para rdfs-comment'> <b>mysqli_report()</b> is a powerful function to improve your queries and code during development and testing phase. Depending on the flags it reports errors from mysqli function calls or queries which don&amp;#039;t use an index (or use a bad index). </p> </div> <a name='function.mysqli-report.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'>flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><table class='doctable table'> <caption><b>Supported flags</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_REPORT_OFF</tt></b></td> <td align='left'>Turns reporting off</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_REPORT_ERROR</tt></b></td> <td align='left'>Report errors from mysqli function calls</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_REPORT_STRICT</tt></b></td> <td align='left'>Report warnings from mysqli function calls</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_REPORT_INDEX</tt></b></td> <td align='left'>Report if no index or bad index was used in a query</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_REPORT_ALL</tt></b></td> <td align='left'>Set all options (report all)</td> </tr> </tbody> </table> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.mysqli-report.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.mysqli-report.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Object oriented style</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;activate&amp;nbsp;reporting&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_report</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_REPORT_ALL</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;query&amp;nbsp;should&amp;nbsp;report&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Nonexistingtable&amp;nbsp;WHERE&amp;nbsp;population&amp;nbsp;&amp;gt;&amp;nbsp;50000'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;query&amp;nbsp;should&amp;nbsp;report&amp;nbsp;a&amp;nbsp;warning&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;WHERE&amp;nbsp;population&amp;nbsp;&amp;gt;&amp;nbsp;50000'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</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.mysqli-report.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/mysqli.debug.php' class='function' rel='rdfs-seeAlso'>mysqli_debug()</a> - Realiza opera&amp;ccedil;&amp;otilde;es de debug</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.dump-debug-info.php' class='function' rel='rdfs-seeAlso'>mysqli_dump_debug_info()</a> - Descarrega informa&amp;ccedil;&amp;atilde;o de debug no log</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="mysqli_real_query" value="<div id='mysqli.real-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.real-query.php'>mysqli::real_query</a></h1> <h1 class='refname'>mysqli_real_query</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::real_query</span> -- <span class='refname'>mysqli_real_query</span> &amp;mdash; <span class='dc-title'>Execute an SQL query</span></p> </div> <a name='mysqli.real-query.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::real_query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'>Procedural style</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_real_query</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> Executes a single query against the database whose result can then be retrieved or stored using the <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a> functions. </p> <p class='para'> In order to determine if a given query should return a result set or not, see <a href='http://www.php.net/manual/pt_BR/mysqli.field-count.php' class='function'>mysqli_field_count()</a>. </p> </div> <a name='mysqli.real-query.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</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 query, as a string. </p> <p class='para'> Data inside the query should be <a href='http://www.php.net/manual/pt_BR/mysqli.real-escape-string.php' class='link'>properly escaped</a>. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.real-query.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='mysqli.real-query.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/mysqli.query.php' class='function' rel='rdfs-seeAlso'>mysqli_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</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="mysqli_real_escape_string" value="<div id='mysqli.real-escape-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.real-escape-string.php'>mysqli::real_escape_string</a></h1> <h1 class='refname'>mysqli_real_escape_string</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::real_escape_string</span> -- <span class='refname'>mysqli_real_escape_string</span> &amp;mdash; <span class='dc-title'>Escapes special characters in a string for use in a SQL statement, taking into account the current charset of the connection</span></p> </div> <a name='mysqli.real-escape-string.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (both methods are equivalent):</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/function.mysqli-escape-string.php' class='function'>mysqli::escape_string</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$escapestr</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli::real_escape_string</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$escapestr</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_real_escape_string</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$escapestr</tt></span> )</div> <p class='para rdfs-comment'> This function is used to create a legal SQL string that you can use in an SQL statement. The given string is encoded to an escaped SQL string, taking into account the current character set of the connection. </p> </div> <a name='mysqli.real-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>escapestr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to be escaped. </p> <p class='para'> Characters encoded are <i>NUL (ASCII 0), \n, \r, \, &amp;#039;, &amp;quot;, and Control-Z</i>. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.real-escape-string.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an escaped string. </p> </div> <a name='mysqli.real-escape-string.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$city&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>''s&amp;nbsp;Hertogenbosch'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;query&amp;nbsp;will&amp;nbsp;fail,&amp;nbsp;cause&amp;nbsp;we&amp;nbsp;didn't&amp;nbsp;escape&amp;nbsp;$city&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;into&amp;nbsp;myCity&amp;nbsp;(Name)&amp;nbsp;VALUES&amp;nbsp;('</span><span style='color: #0000BB'>$city</span><span style='color: #DD0000'>')'</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;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>sqlstate</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>$city&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>real_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$city</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;query&amp;nbsp;with&amp;nbsp;escaped&amp;nbsp;$city&amp;nbsp;will&amp;nbsp;work&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;into&amp;nbsp;myCity&amp;nbsp;(Name)&amp;nbsp;VALUES&amp;nbsp;('</span><span style='color: #0000BB'>$city</span><span style='color: #DD0000'>')'</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'>'%d&amp;nbsp;Row&amp;nbsp;inserted.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$city&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>''s&amp;nbsp;Hertogenbosch'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;query&amp;nbsp;will&amp;nbsp;fail,&amp;nbsp;cause&amp;nbsp;we&amp;nbsp;didn't&amp;nbsp;escape&amp;nbsp;$city&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;into&amp;nbsp;myCity&amp;nbsp;(Name)&amp;nbsp;VALUES&amp;nbsp;('</span><span style='color: #0000BB'>$city</span><span style='color: #DD0000'>')'</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;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_sqlstate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #0000BB'>$city&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_real_escape_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$city</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;query&amp;nbsp;with&amp;nbsp;escaped&amp;nbsp;$city&amp;nbsp;will&amp;nbsp;work&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;into&amp;nbsp;myCity&amp;nbsp;(Name)&amp;nbsp;VALUES&amp;nbsp;('</span><span style='color: #0000BB'>$city</span><span style='color: #DD0000'>')'</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'>'%d&amp;nbsp;Row&amp;nbsp;inserted.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error: 42000 1 Row inserted. </pre></div> </div> </div> <a name='mysqli.real-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/mysqli.character-set-name.php' class='function' rel='rdfs-seeAlso'>mysqli_character_set_name()</a> - Retorna o conjunto de caracteres padr&amp;atilde;o para a conex&amp;atilde;o com o banco de dados</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="mysqli_real_connect" value="<div id='mysqli.real-connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.real-connect.php'>mysqli::real_connect</a></h1> <h1 class='refname'>mysqli_real_connect</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::real_connect</span> -- <span class='refname'>mysqli_real_connect</span> &amp;mdash; <span class='dc-title'>Opens a connection to a mysql server</span></p> </div> <a name='mysqli.real-connect.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method)</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::real_connect</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$host</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'>$passwd</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$port</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$socket</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$flags</tt></span> ]]]]]]] )</div> <p class='para rdfs-comment'>Procedural style</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_real_connect</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$host</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'>$passwd</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$port</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$socket</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$flags</tt></span> ]]]]]]] )</div> <p class='para rdfs-comment'> Establish a connection to a MySQL database engine. </p> <p class='para'> This function differs from <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>: </p> <ul class='itemizedlist'> <li class='listitem'> <p class='para'> <b>mysqli_real_connect()</b> needs a valid object which has to be created by function <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a>. </p> </li> <li class='listitem'> <p class='para'> With the <a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function'>mysqli_options()</a> function you can set various options for connection. </p> </li> <li class='listitem'> <p class='para'> There is a <i><tt class='parameter'>flags</tt></i> parameter. </p> </li> </ul> </div> <a name='mysqli.real-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>host</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Can be either a host name or an IP address. Passing the <b><tt class='constant'>NULL</tt></b> value or the string &amp;quot;localhost&amp;quot; to this parameter, the local host is assumed. When possible, pipes will be used instead of the TCP/IP protocol. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>username</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The MySQL user name. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>passwd</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If provided or <b><tt class='constant'>NULL</tt></b>, the MySQL server will attempt to authenticate the user against those user records which have no password only. This allows one username to be used with different permissions (depending on if a password as provided or not). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dbname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If provided will specify the default database to be used when performing queries. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>port</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the port number to attempt to connect to the MySQL server. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>socket</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specifies the socket or named pipe that should be used. </p> <blockquote><p><b class='note'>Nota</b>: Specifying the <i><tt class='parameter'>socket</tt></i> parameter will not explicitly determine the type of connection to be used when connecting to the MySQL server. How the connection is made to the MySQL database is determined by the <i><tt class='parameter'>host</tt></i> parameter. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> With the parameter <i><tt class='parameter'>flags</tt></i> you can set different connection options: </p> <table class='doctable table'> <caption><b>Supported flags</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_CLIENT_COMPRESS</tt></b></td> <td align='left'>Use compression protocol</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_CLIENT_FOUND_ROWS</tt></b></td> <td align='left'>return number of matched rows, not the number of affected rows</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_CLIENT_IGNORE_SPACE</tt></b></td> <td align='left'>Allow spaces after function names. Makes all function names reserved words.</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_CLIENT_INTERACTIVE</tt></b></td> <td align='left'> Allow <i>interactive_timeout</i> seconds (instead of <i>wait_timeout</i> seconds) of inactivity before closing the connection </td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_CLIENT_SSL</tt></b></td> <td align='left'>Use SSL (encryption)</td> </tr> </tbody> </table> <blockquote><p><b class='note'>Nota</b>: For security reasons the <b><tt class='constant'>MULTI_STATEMENT</tt></b> flag is not supported in PHP. If you want to execute multiple queries use the <a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli_multi_query()</a> function. <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='mysqli.real-connect.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='mysqli.real-connect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_init</span><span style='color: #007700'>();<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'mysqli_init&amp;nbsp;failed'</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>options</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_INIT_COMMAND</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;AUTOCOMMIT&amp;nbsp;=&amp;nbsp;0'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Setting&amp;nbsp;MYSQLI_INIT_COMMAND&amp;nbsp;failed'</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>options</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_OPT_CONNECT_TIMEOUT</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Setting&amp;nbsp;MYSQLI_OPT_CONNECT_TIMEOUT&amp;nbsp;failed'</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>real_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_db'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Connect&amp;nbsp;Error&amp;nbsp;('&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_errno</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>')&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;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />}<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Success...&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>host_info&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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Object oriented style when extending mysqli class</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: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>foo_mysqli&amp;nbsp;</span><span style='color: #007700'>extends&amp;nbsp;</span><span style='color: #0000BB'>mysqli&amp;nbsp;</span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>__construct</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$host</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'>$pass</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$db</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'>parent</span><span style='color: #007700'>::</span><span style='color: #0000BB'>init</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'>parent</span><span style='color: #007700'>::</span><span style='color: #0000BB'>options</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_INIT_COMMAND</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;AUTOCOMMIT&amp;nbsp;=&amp;nbsp;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;die(</span><span style='color: #DD0000'>'Setting&amp;nbsp;MYSQLI_INIT_COMMAND&amp;nbsp;failed'</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</span><span style='color: #0000BB'>parent</span><span style='color: #007700'>::</span><span style='color: #0000BB'>options</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_OPT_CONNECT_TIMEOUT</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</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;die(</span><span style='color: #DD0000'>'Setting&amp;nbsp;MYSQLI_OPT_CONNECT_TIMEOUT&amp;nbsp;failed'</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(!</span><span style='color: #0000BB'>parent</span><span style='color: #007700'>::</span><span style='color: #0000BB'>real_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$host</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'>$pass</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$db</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;die(</span><span style='color: #DD0000'>'Connect&amp;nbsp;Error&amp;nbsp;('&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_errno</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>')&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: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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;}<br />}<br /><br /></span><span style='color: #0000BB'>$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>foo_mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_db'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Success...&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>host_info&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'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #3 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_init</span><span style='color: #007700'>();<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'mysqli_init&amp;nbsp;failed'</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_options</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>MYSQLI_INIT_COMMAND</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;AUTOCOMMIT&amp;nbsp;=&amp;nbsp;0'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Setting&amp;nbsp;MYSQLI_INIT_COMMAND&amp;nbsp;failed'</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_options</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>MYSQLI_OPT_CONNECT_TIMEOUT</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Setting&amp;nbsp;MYSQLI_OPT_CONNECT_TIMEOUT&amp;nbsp;failed'</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_real_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_db'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Connect&amp;nbsp;Error&amp;nbsp;('&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_errno</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>')&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;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />}<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Success...&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_host_info</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Success... MySQL host info: localhost via TCP/IP </pre></div> </div> </div> <a name='mysqli.real-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/mysqli.connect.php' class='function' rel='rdfs-seeAlso'>mysqli_connect()</a> - Abre uma nova conex&amp;atilde;o com o servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function' rel='rdfs-seeAlso'>mysqli_init()</a> - Inicializa a MySQLi e retorna um resource para usar com mysqli_real_connect()</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function' rel='rdfs-seeAlso'>mysqli_options()</a> - Set options</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.ssl-set.php' class='function' rel='rdfs-seeAlso'>mysqli_ssl_set()</a> - Used for establishing secure connections using SSL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.close.php' class='function' rel='rdfs-seeAlso'>mysqli_close()</a> - Fecha uma conex&amp;atilde;o aberta anteriormente com o banco de dados</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="mysqli_query" value="<div id='mysqli.query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.query.php'>mysqli::query</a></h1> <h1 class='refname'>mysqli_query</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::query</span> -- <span class='refname'>mysqli_query</span> &amp;mdash; <span class='dc-title'>Performs a query on the database</span></p> </div> <a name='mysqli.query.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <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>mysqli::query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$resultmode</tt></span> ] )</div> <p class='para rdfs-comment'>Procedural style:</p> <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>mysqli_query</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$resultmode</tt></span> ] )</div> <p class='para rdfs-comment'> Performs a <i><tt class='parameter'>query</tt></i> against the database. </p> <p class='para'> Functionally, using this function is identical to calling <a href='http://www.php.net/manual/pt_BR/mysqli.real-query.php' class='function'>mysqli_real_query()</a> followed either by <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a>. </p> </div> <a name='mysqli.query.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</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 query string. </p> <p class='para'> Data inside the query should be <a href='http://www.php.net/manual/pt_BR/mysqli.real-escape-string.php' class='link'>properly escaped</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>resultmode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Either the constant <b><tt class='constant'>MYSQLI_USE_RESULT</tt></b> or <b><tt class='constant'>MYSQLI_STORE_RESULT</tt></b> depending on the desired behavior. By default, <b><tt class='constant'>MYSQLI_STORE_RESULT</tt></b> is used. </p> <p class='para'> If you use <b><tt class='constant'>MYSQLI_USE_RESULT</tt></b> all subsequent calls will return error <i>Commands out of sync</i> unless you call <a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function'>mysqli_free_result()</a> </p> <p class='para'> With <b><tt class='constant'>MYSQLI_ASYNC</tt></b> (available with mysqlnd), it is possible to perform query asynchronously. <a href='http://www.php.net/manual/pt_BR/mysqli.poll.php' class='function'>mysqli_poll()</a> is then used to get results from such queries. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.query.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. For <i>SELECT, SHOW, DESCRIBE</i> or <i>EXPLAIN</i> <b>mysqli_query()</b> will return a result object. </p> </div> <a name='mysqli.query.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.3.0</td> <td align='left'> Added the ability of async queries. </td> </tr> </tbody> </table> <p> </p> </div> <a name='mysqli.query.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;table&amp;nbsp;doesn't&amp;nbsp;return&amp;nbsp;a&amp;nbsp;resultset&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>)&amp;nbsp;===&amp;nbsp;</span><span style='color: #0000BB'>TRUE</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'>'Table&amp;nbsp;myCity&amp;nbsp;successfully&amp;nbsp;created.\n'</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Select&amp;nbsp;queries&amp;nbsp;return&amp;nbsp;a&amp;nbsp;resultset&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;LIMIT&amp;nbsp;10'</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'>'Select&amp;nbsp;returned&amp;nbsp;%d&amp;nbsp;rows.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>num_rows</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;If&amp;nbsp;we&amp;nbsp;have&amp;nbsp;to&amp;nbsp;retrieve&amp;nbsp;large&amp;nbsp;amount&amp;nbsp;of&amp;nbsp;data&amp;nbsp;we&amp;nbsp;use&amp;nbsp;MYSQLI_USE_RESULT&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>MYSQLI_USE_RESULT</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Note,&amp;nbsp;that&amp;nbsp;we&amp;nbsp;can't&amp;nbsp;execute&amp;nbsp;any&amp;nbsp;functions&amp;nbsp;which&amp;nbsp;interact&amp;nbsp;with&amp;nbsp;the<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;server&amp;nbsp;until&amp;nbsp;result&amp;nbsp;set&amp;nbsp;was&amp;nbsp;closed.&amp;nbsp;All&amp;nbsp;calls&amp;nbsp;will&amp;nbsp;return&amp;nbsp;an<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'out&amp;nbsp;of&amp;nbsp;sync'&amp;nbsp;error&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SET&amp;nbsp;@a:='this&amp;nbsp;will&amp;nbsp;not&amp;nbsp;work''</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;table&amp;nbsp;doesn't&amp;nbsp;return&amp;nbsp;a&amp;nbsp;resultset&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>)&amp;nbsp;===&amp;nbsp;</span><span style='color: #0000BB'>TRUE</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'>'Table&amp;nbsp;myCity&amp;nbsp;successfully&amp;nbsp;created.\n'</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Select&amp;nbsp;queries&amp;nbsp;return&amp;nbsp;a&amp;nbsp;resultset&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;LIMIT&amp;nbsp;10'</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'>'Select&amp;nbsp;returned&amp;nbsp;%d&amp;nbsp;rows.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>));<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;If&amp;nbsp;we&amp;nbsp;have&amp;nbsp;to&amp;nbsp;retrieve&amp;nbsp;large&amp;nbsp;amount&amp;nbsp;of&amp;nbsp;data&amp;nbsp;we&amp;nbsp;use&amp;nbsp;MYSQLI_USE_RESULT&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>MYSQLI_USE_RESULT</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Note,&amp;nbsp;that&amp;nbsp;we&amp;nbsp;can't&amp;nbsp;execute&amp;nbsp;any&amp;nbsp;functions&amp;nbsp;which&amp;nbsp;interact&amp;nbsp;with&amp;nbsp;the<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;server&amp;nbsp;until&amp;nbsp;result&amp;nbsp;set&amp;nbsp;was&amp;nbsp;closed.&amp;nbsp;All&amp;nbsp;calls&amp;nbsp;will&amp;nbsp;return&amp;nbsp;an<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;'out&amp;nbsp;of&amp;nbsp;sync'&amp;nbsp;error&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;@a:='this&amp;nbsp;will&amp;nbsp;not&amp;nbsp;work''</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Table myCity successfully created. Select returned 10 rows. Error: Commands out of sync; You can&amp;#039;t run this command now </pre></div> </div> </div> <a name='mysqli.query.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/mysqli.real-query.php' class='function' rel='rdfs-seeAlso'>mysqli_real_query()</a> - Execute an SQL query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function' rel='rdfs-seeAlso'>mysqli_multi_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.free.php' class='function' rel='rdfs-seeAlso'>mysqli_free_result()</a> - Frees the memory associated with a 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="mysqli_prepare" value="<div id='mysqli.prepare' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.prepare.php'>mysqli::prepare</a></h1> <h1 class='refname'>mysqli_prepare</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::prepare</span> -- <span class='refname'>mysqli_prepare</span> &amp;mdash; <span class='dc-title'>Prepare a SQL statement for execution</span></p> </div> <a name='mysqli.prepare.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method)</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <span class='methodname'><b>mysqli::prepare</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'>Procedure style:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <span class='methodname'><b>mysqli_prepare</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> Prepares the SQL query pointed to by the null-terminated string query, and returns a statement handle to be used for further operations on the statement. The query must consist of a single SQL statement. </p> <p class='para'> The parameter markers must be bound to application variables using <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function'>mysqli_stmt_bind_param()</a> and/or <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function'>mysqli_stmt_bind_result()</a> before executing the statement or fetching rows. </p> </div> <a name='mysqli.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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</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 query, as a string. </p> <blockquote><p><b class='note'>Nota</b>: You should not add a terminating semicolon or <i>\g</i> to the statement. <br /> </p></blockquote> <p class='para'> This parameter can include one or more parameter markers in the SQL statement by embedding question mark (<i>?</i>) characters at the appropriate positions. </p> <blockquote><p><b class='note'>Nota</b>: The markers are legal only in certain places in SQL statements. For example, they are allowed in the <i>VALUES()</i> list of an <i>INSERT</i> statement (to specify column values for a row), or in a comparison with a column in a <i>WHERE</i> clause to specify a comparison value. <br /> However, they are not allowed for identifiers (such as table or column names), in the select list that names the columns to be returned by a <i>SELECT</i> statement, or to specify both operands of a binary operator such as the <i>=</i> equal sign. The latter restriction is necessary because it would be impossible to determine the parameter type. It&amp;#039;s not allowed to compare marker with <i>NULL</i> by <i>? IS NULL</i> too. In general, parameters are legal only in Data Manipulation Language (DML) statements, and not in Data Definition Language (DDL) statements. <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='mysqli.prepare.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>mysqli_prepare()</b> returns a statement object or <b><tt class='constant'>FALSE</tt></b> if an error occurred. </p> </div> <a name='mysqli.prepare.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$city&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Amersfoort'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;create&amp;nbsp;a&amp;nbsp;prepared&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>prepare</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;District&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;WHERE&amp;nbsp;Name=?'</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&amp;nbsp;parameters&amp;nbsp;for&amp;nbsp;markers&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_param</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$city</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>execute</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;result&amp;nbsp;variables&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$district</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;value&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch</span><span style='color: #007700'>();<br /><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'>'%s&amp;nbsp;is&amp;nbsp;in&amp;nbsp;district&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$city</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$district</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$city&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Amersfoort'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;create&amp;nbsp;a&amp;nbsp;prepared&amp;nbsp;statement&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$stmt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_prepare</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;District&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;WHERE&amp;nbsp;Name=?'</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&amp;nbsp;parameters&amp;nbsp;for&amp;nbsp;markers&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_param</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$city</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;query&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_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: #FF8000'>/*&amp;nbsp;bind&amp;nbsp;result&amp;nbsp;variables&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_bind_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$district</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;value&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_fetch</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;is&amp;nbsp;in&amp;nbsp;district&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$city</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$district</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;statement&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_stmt_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$stmt</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Amersfoort is in district Utrecht </pre></div> </div> </div> <a name='mysqli.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/mysqli-stmt.execute.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_execute()</a> - Executa uma preparada query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.fetch.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_fetch()</a> - Obt&amp;eacute;m resultados de um preparado comando e os coloca nas determinadas vari&amp;aacute;veis</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-param.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_param()</a> - Passa vari&amp;aacute;veis para um preparado comando como par&amp;acirc;metros</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.bind-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_bind_result()</a> - Passa vari&amp;aacute;veis para um preparado comando por resultado armazenado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.close.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_close()</a> - Closes a prepared 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="mysqli_ping" value="<div id='mysqli.ping' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.ping.php'>mysqli::ping</a></h1> <h1 class='refname'>mysqli_ping</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::ping</span> -- <span class='refname'>mysqli_ping</span> &amp;mdash; <span class='dc-title'>Pings a server connection, or tries to reconnect if the connection has gone down</span></p> </div> <a name='mysqli.ping.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::ping</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_ping</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Checks whether the connection to the server is working. If it has gone down, and global option <i>mysqli.reconnect</i> is enabled an automatic reconnection is attempted. </p> <p class='para'> This function can be used by clients that remain idle for a long while, to check whether the server has closed the connection and reconnect if necessary. </p> </div> <a name='mysqli.ping.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.ping.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='mysqli.ping.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;if&amp;nbsp;server&amp;nbsp;is&amp;nbsp;alive&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>ping</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'>'Our&amp;nbsp;connection&amp;nbsp;is&amp;nbsp;ok!\n'</span><span style='color: #007700'>);<br />}&amp;nbsp;else&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'>'Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;if&amp;nbsp;server&amp;nbsp;is&amp;nbsp;alive&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_ping</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>'Our&amp;nbsp;connection&amp;nbsp;is&amp;nbsp;ok!\n'</span><span style='color: #007700'>);<br />}&amp;nbsp;else&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'>'Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Our connection is ok! </pre></div> </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="mysqli_param_count" value="<div id='function.mysqli-param-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-param-count.php'>mysqli_param_count</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_param_count</span> &amp;mdash; <span class='dc-title'>Alias for <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.param-count.php' class='function'>mysqli_stmt_param_count()</a></span></p> </div> <a name='function.mysqli-param-count.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'> This function is an alias of <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.param-count.php' class='function'>mysqli_stmt_param_count()</a>. </p> </div> <a name='function.mysqli-param-count.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>mysqli_param_count()</b> is deprecated and will be removed. <br /> </p></blockquote> </div> <a name='function.mysqli-param-count.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/mysqli-stmt.param-count.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_param_count()</a> - Returns the number of parameter for the given 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="mysqli_options" value="<div id='mysqli.options' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.options.php'>mysqli::options</a></h1> <h1 class='refname'>mysqli_options</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::options</span> -- <span class='refname'>mysqli_options</span> &amp;mdash; <span class='dc-title'>Set options</span></p> </div> <a name='mysqli.options.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (method)</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::options</b></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'>$value</tt></span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_options</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</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'>$value</tt></span> )</div> <p class='para rdfs-comment'> Used to set extra connect options and affect behavior for a connection. </p> <p class='para'> This function may be called multiple times to set several options. </p> <p class='para'> <b>mysqli_options()</b> should be called after <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> and before <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</a>. </p> </div> <a name='mysqli.options.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</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 option that you want to set. It can be one of the following values: </p><table class='doctable table'> <caption><b>Valid options</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Name</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_OPT_CONNECT_TIMEOUT</tt></b></td> <td align='left'>connection timeout in seconds</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_OPT_LOCAL_INFILE</tt></b></td> <td align='left'>enable/disable use of <i>LOAD LOCAL INFILE</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_INIT_COMMAND</tt></b></td> <td align='left'>command to execute after when connecting to MySQL server</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_READ_DEFAULT_FILE</tt></b></td> <td align='left'> Read options from named option file instead of <var class='filename'>my.cnf</var> </td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>MYSQLI_READ_DEFAULT_GROUP</tt></b></td> <td align='left'> Read options from the named group from <var class='filename'>my.cnf</var> or the file specified with <b><tt class='constant'>MYSQL_READ_DEFAULT_FILE</tt></b>. </td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>value</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The value for the option. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.options.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='mysqli.options.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> See <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</a>. </p> </div> <a name='mysqli.options.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/mysqli.init.php' class='function' rel='rdfs-seeAlso'>mysqli_init()</a> - Inicializa a MySQLi e retorna um resource para usar com mysqli_real_connect()</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function' rel='rdfs-seeAlso'>mysqli_real_connect()</a> - Opens a connection to a mysql 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="mysqli_num_rows" value="<div id='mysqli-result.num-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.num-rows.php'>mysqli_result-&amp;gt;num_rows</a></h1> <h1 class='refname'>mysqli_num_rows</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result-&amp;gt;num_rows</span> -- <span class='refname'>mysqli_num_rows</span> &amp;mdash; <span class='dc-title'>Gets the number of rows in a result</span></p> </div> <a name='mysqli-result.num-rows.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_result</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$num_rows</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_num_rows</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of rows in the result set. </p> <p class='para'> The use of <b>mysqli_num_rows()</b> depends on whether you use buffered or unbuffered result sets. In case you use unbuffered resultsets <b>mysqli_num_rows()</b> will not return the correct number of rows until all the rows in the result have been retrieved. </p> </div> <a name='mysqli-result.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.num-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns number of rows in the result set. </p> <blockquote><p><b class='note'>Nota</b>: If the number of rows is greater than maximal int value, the number will be returned as a string. <br /> </p></blockquote> </div> <a name='mysqli-result.num-rows.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Code,&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;number&amp;nbsp;of&amp;nbsp;rows&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row_cnt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>num_rows</span><span style='color: #007700'>;<br /><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'>'Result&amp;nbsp;set&amp;nbsp;has&amp;nbsp;%d&amp;nbsp;rows.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row_cnt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Code,&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;number&amp;nbsp;of&amp;nbsp;rows&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row_cnt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_num_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><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'>'Result&amp;nbsp;set&amp;nbsp;has&amp;nbsp;%d&amp;nbsp;rows.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$row_cnt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Result set has 239 rows. </pre></div> </div> </div> <a name='mysqli-result.num-rows.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/mysqli.affected-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_affected_rows()</a> - Retorna o n&amp;uacute;mero de linhas afetadas pela opera&amp;ccedil;&amp;atilde;o MySQL anterior</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function' rel='rdfs-seeAlso'>mysqli_query()</a> - Performs a query on the 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="mysqli_num_fields" value="<div id='mysqli-result.field-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.field-count.php'>mysqli_result-&amp;gt;field_count</a></h1> <h1 class='refname'>mysqli_num_fields</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result-&amp;gt;field_count</span> -- <span class='refname'>mysqli_num_fields</span> &amp;mdash; <span class='dc-title'>Get the number of fields in a result</span></p> </div> <a name='mysqli-result.field-count.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_result</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$field_count</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_num_fields</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Returns the number of fields from specified result set. </p> </div> <a name='mysqli-result.field-count.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'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.field-count.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The number of fields from a result set. </p> </div> <a name='mysqli-result.field-count.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;1'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;number&amp;nbsp;of&amp;nbsp;fields&amp;nbsp;in&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$field_cnt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>field_count</span><span style='color: #007700'>;<br /><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'>'Result&amp;nbsp;set&amp;nbsp;has&amp;nbsp;%d&amp;nbsp;fields.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$field_cnt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;1'</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;number&amp;nbsp;of&amp;nbsp;fields&amp;nbsp;in&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$field_cnt&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_num_fields</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><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'>'Result&amp;nbsp;set&amp;nbsp;has&amp;nbsp;%d&amp;nbsp;fields.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$field_cnt</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Result set has 5 fields. </pre></div> </div> </div> <a name='mysqli-result.field-count.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/mysqli-result.fetch-field.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_field()</a> - Retorna o pr&amp;oacute;ximo campo no conjunto de resultados</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="mysqli_next_result" value="<div id='mysqli.next-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.next-result.php'>mysqli::next_result</a></h1> <h1 class='refname'>mysqli_next_result</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::next_result</span> -- <span class='refname'>mysqli_next_result</span> &amp;mdash; <span class='dc-title'>Prepara o pr&amp;oacute;ximo resultado de multi_query</span></p> </div> <a name='mysqli.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>mysqli::next_result</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_next_result</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Prepara o pr&amp;oacute;ximo conjunto de resultado de uma chamada anterior para <a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli_multi_query()</a> que pode ser recuperado por <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>. </p> </div> <a name='mysqli.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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.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> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. </p> </div> <a name='mysqli.next-result.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> Veja <a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli_multi_query()</a>. </p> </div> <a name='mysqli.next-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/mysqli.multi-query.php' class='function' rel='rdfs-seeAlso'>mysqli_multi_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.more-results.php' class='function' rel='rdfs-seeAlso'>mysqli_more_results()</a> - Verifica se h&amp;aacute; mais algum resultado de uma multi query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</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="mysqli_multi_query" value="<div id='mysqli.multi-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.multi-query.php'>mysqli::multi_query</a></h1> <h1 class='refname'>mysqli_multi_query</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::multi_query</span> -- <span class='refname'>mysqli_multi_query</span> &amp;mdash; <span class='dc-title'>Performs a query on the database</span></p> </div> <a name='mysqli.multi-query.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::multi_query</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_multi_query</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <p class='para rdfs-comment'> Executa um ou m&amp;uacute;ltiplas queries que s&amp;atilde;o concatenadas com ponto-e-v&amp;iacute;rgula. </p> <p class='para'> Para recuperar o conjunto de resultado da primeira query, voc&amp;ecirc; pode usar <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a>. Todos os resultados de queries subseq&amp;uuml;entes podem ser processados usando <a href='http://www.php.net/manual/pt_BR/mysqli.more-results.php' class='function'>mysqli_more_results()</a> e <a href='http://www.php.net/manual/pt_BR/mysqli.next-result.php' class='function'>mysqli_next_result()</a>. </p> </div> <a name='mysqli.multi-query.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>query</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A query, como uma string. </p> </dd> </dl> <p> </p> </div> <a name='mysqli.multi-query.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>FALSE</tt></b> se o primeiro comando falhar. Para recuperar erros subseq&amp;uuml;entes de outros comandos, voc&amp;ecirc; ter&amp;aacute; que chamar <a href='http://www.php.net/manual/pt_BR/mysqli.next-result.php' class='function'>mysqli_next_result()</a> primeiro. </p> </div> <a name='mysqli.multi-query.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;CURRENT_USER();'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;20,&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;multi&amp;nbsp;query&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>multi_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;do&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;first&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>store_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;&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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s\n'</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'>]);<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;}<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;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>free</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'>/*&amp;nbsp;print&amp;nbsp;divider&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>more_results</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;</span><span style='color: #0000BB'>printf</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>next_result</span><span style='color: #007700'>());<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$query&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;CURRENT_USER();'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;20,&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;execute&amp;nbsp;multi&amp;nbsp;query&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_multi_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;do&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;store&amp;nbsp;first&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_store_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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;while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_row</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;&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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s\n'</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'>]);<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;}<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;</span><span style='color: #0000BB'>mysqli_free_result</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;&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'>/*&amp;nbsp;print&amp;nbsp;divider&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_more_results</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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;</span><span style='color: #0000BB'>printf</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}&amp;nbsp;while&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_next_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir algo similar a:</p> <div class='example-contents screen'> <div class='cdata'><pre> my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer </pre></div> </div> </div> <a name='mysqli.multi-query.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/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.next-result.php' class='function' rel='rdfs-seeAlso'>mysqli_next_result()</a> - Prepara o pr&amp;oacute;ximo resultado de multi_query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.more-results.php' class='function' rel='rdfs-seeAlso'>mysqli_more_results()</a> - Verifica se h&amp;aacute; mais algum resultado de uma multi 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="mysqli_more_results" value="<div id='mysqli.more-results' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.more-results.php'>mysqli::more_results</a></h1> <h1 class='refname'>mysqli_more_results</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::more_results</span> -- <span class='refname'>mysqli_more_results</span> &amp;mdash; <span class='dc-title'>Verifica se h&amp;aacute; mais algum resultado de uma multi query</span></p> </div> <a name='mysqli.more-results.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>mysqli::more_results</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_more_results</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Indica se um ou mais conjunto de resultados est&amp;atilde;o dispon&amp;iacute;veis de uma chamada anterior a <a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli_multi_query()</a>. </p> </div> <a name='mysqli.more-results.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.more-results.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='mysqli.more-results.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'>Veja <a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli_multi_query()</a>.</p> </div> <a name='mysqli.more-results.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/mysqli.multi-query.php' class='function' rel='rdfs-seeAlso'>mysqli_multi_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.next-result.php' class='function' rel='rdfs-seeAlso'>mysqli_next_result()</a> - Prepara o pr&amp;oacute;ximo resultado de multi_query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</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="mysqli_master_query" value="<div id='function.mysqli-master-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-master-query.php'>mysqli_master_query</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_master_query</span> &amp;mdash; <span class='dc-title'>For&amp;ccedil;a execu&amp;ccedil;&amp;atilde;o de uma query no master numa configura&amp;ccedil;&amp;atilde;o master/slave</span></p> </div> <a name='function.mysqli-master-query.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>mysqli_master_query</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_kill" value="<div id='mysqli.kill' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.kill.php'>mysqli::kill</a></h1> <h1 class='refname'>mysqli_kill</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::kill</span> -- <span class='refname'>mysqli_kill</span> &amp;mdash; <span class='dc-title'>Solicita ao servidor o encerramento de um thread do MySQL</span></p> </div> <a name='mysqli.kill.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo)</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::kill</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$processid</tt></span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_kill</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$processid</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; usado para solicitar ao servidor o encerramento de uma espec&amp;iacute;fica thread do MySQL pelo par&amp;acirc;metro <i><tt class='parameter'>processid</tt></i> . Este valor precisa ser recuperado chamando a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.thread-id.php' class='function'>mysqli_thread_id()</a>. </p> <p class='para'> Para encerrar a execu&amp;ccedil;&amp;atilde;o de uma query, voc&amp;ecirc; deve usar o comando SQL <i>KILL QUERY processid</i>. </p> </div> <a name='mysqli.kill.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.kill.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='mysqli.kill.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;our&amp;nbsp;thread&amp;nbsp;id&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$thread_id&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>thread_id</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Kill&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>kill</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$thread_id</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;This&amp;nbsp;should&amp;nbsp;produce&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</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;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;determine&amp;nbsp;our&amp;nbsp;thread&amp;nbsp;id&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$thread_id&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_thread_id</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Kill&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_kill</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$thread_id</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;This&amp;nbsp;should&amp;nbsp;produce&amp;nbsp;an&amp;nbsp;error&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</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;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Error: MySQL server has gone away </pre></div> </div> </div> <a name='mysqli.kill.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/mysqli.thread-id.php' class='function' rel='rdfs-seeAlso'>mysqli_thread_id()</a> - Returns the thread ID for the current connection</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="mysqli_insert_id" value="<div id='mysqli.insert-id' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.insert-id.php'>mysqli_insert_id</a></h1> <h1 class='refname'>mysqli-&amp;gt;insert_id</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_insert_id</span> -- <span class='refname'>mysqli-&amp;gt;insert_id</span> &amp;mdash; <span class='dc-title'>Retorna o id gerado automaticamente na &amp;uacute;ltima consulta</span></p> </div> <a name='mysqli.insert-id.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_insert_id</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'>Modo orientado a objeto (propriedade):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$insert_id</var>;</div> </div> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_insert_id()</b> retorna o ID gerado pela consulta em uma tabela com uma coluna com o atributo AUTO_INCREMENT. Se a &amp;uacute;ltima consulta n&amp;atilde;o foi um INSERT ou UPDATE ou se a tabela modificada n&amp;atilde;o tem uma coluna com o atributo AUTO_INCREMENT, esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar zero. </p> <blockquote><p><b class='note'>Nota</b>: Executar uma consulta INSERT ou UPDATE usando a fun&amp;ccedil;&amp;atilde;o LAST_INSERT_ID() ir&amp;aacute; tamb&amp;eacute;m modificar o valor retornado pela fun&amp;ccedil;&amp;atilde;o <b>mysqli_insert_id()</b>. <br /> </p></blockquote> </div> <a name='mysqli.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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.insert-id.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O valor do campo <i>AUTO_INCREMENT</i> que foi atualizado pela consulta anterior. Retorna zero se n&amp;atilde;o houve uma consulta anterior na conex&amp;atilde;o ou se a consulta n&amp;atilde;o atualizou um valor <i>AUTO_INCREMENT</i>. </p> <blockquote><p><b class='note'>Nota</b>: Se o n&amp;uacute;mero for maior do que o maior valor inteiro poss&amp;iacute;vel, <b>mysqli_insert_id()</b> ir&amp;aacute; retornar uma string. <br /> </p></blockquote> </div> <a name='mysqli.insert-id.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</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'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;VALUES&amp;nbsp;(NULL,&amp;nbsp;'Stuttgart',&amp;nbsp;'DEU',&amp;nbsp;'Stuttgart',&amp;nbsp;617000)'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'New&amp;nbsp;Record&amp;nbsp;has&amp;nbsp;id&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>insert_id</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;myCity&amp;nbsp;LIKE&amp;nbsp;City'</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'>'INSERT&amp;nbsp;INTO&amp;nbsp;myCity&amp;nbsp;VALUES&amp;nbsp;(NULL,&amp;nbsp;'Stuttgart',&amp;nbsp;'DEU',&amp;nbsp;'Stuttgart',&amp;nbsp;617000)'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'New&amp;nbsp;Record&amp;nbsp;has&amp;nbsp;id&amp;nbsp;%d.\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_insert_id</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;myCity'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> New Record has id 1. </pre></div> </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="mysqli_init" value="<div id='mysqli.init' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.init.php'>mysqli_init</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_init</span> &amp;mdash; <span class='dc-title'>Inicializa a MySQLi e retorna um resource para usar com mysqli_real_connect()</span></p> </div> <a name='mysqli.init.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <span class='methodname'><b>mysqli_init</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli</span> <span class='methodname'><b>init</b></span> ( <span class='methodparam'>void</span> )</div> </div> <p class='para'> Aloca ou inicializa um objeto MYSQL destinado para <a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function'>mysqli_options()</a> e <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</a>. </p> <blockquote><p><b class='note'>Nota</b>: Chamadas subseq&amp;uuml;entes para alguma fun&amp;ccedil;&amp;atilde;o mysqli (exceto <a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function'>mysqli_options()</a>) ir&amp;aacute; falhar se <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</a> n&amp;atilde;o for chamado. <br /> </p></blockquote> </div> <a name='mysqli.init.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um objeto. </p> </div> <a name='mysqli.init.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/mysqli.options.php' class='function' rel='rdfs-seeAlso'>mysqli_options()</a> - Set options</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.close.php' class='function' rel='rdfs-seeAlso'>mysqli_close()</a> - Fecha uma conex&amp;atilde;o aberta anteriormente com o banco de dados</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function' rel='rdfs-seeAlso'>mysqli_real_connect()</a> - Opens a connection to a mysql server</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function' rel='rdfs-seeAlso'>mysqli_connect()</a> - Abre uma nova conex&amp;atilde;o com o servidor MySQL</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="mysqli_info" value="<div id='mysqli.info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.info.php'>mysqli_info</a></h1> <h1 class='refname'>mysqli-&amp;gt;info</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_info</span> -- <span class='refname'>mysqli-&amp;gt;info</span> &amp;mdash; <span class='dc-title'>Recupera informa&amp;ccedil;&amp;atilde;o sobre a mais recente query executada</span></p> </div> <a name='mysqli.info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_info</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'>Modo orientado a objeto (propriedade)</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$info</var>;</div> </div> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_info()</b> retorna uma string contendo informa&amp;ccedil;&amp;atilde;o sobre a &amp;uacute;ltima query executada. Normalmente a informa&amp;ccedil;&amp;atilde;o &amp;eacute; como visto abaixo: </p> <p class='para'> </p><table class='doctable table'> <caption><b>Poss&amp;iacute;veis valores de retorno da mysqli_info</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Tipo de query</th> <th>Exemplo de resultado</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>INSERT INTO...SELECT...</td> <td align='left'>Records: 100 Duplicates: 0 Warnings: 0</td> </tr> <tr valign='middle'> <td align='left'>INSERT INTO...VALUES (...),(...),(...)</td> <td align='left'>Records: 3 Duplicates: 0 Warnings: 0</td> </tr> <tr valign='middle'> <td align='left'>LOAD DATA INFILE ...</td> <td align='left'>Records: 1 Deleted: 0 Skipped: 0 Warnings: 0</td> </tr> <tr valign='middle'> <td align='left'>ALTER TABLE ...</td> <td align='left'>Records: 3 Duplicates: 0 Warnings: 0</td> </tr> <tr valign='middle'> <td align='left'>UPDATE ...</td> <td align='left'>Rows matched: 40 Changed: 40 Warnings: 0</td> </tr> </tbody> </table> <p> </p> <blockquote><p><b class='note'>Nota</b>: Queries que n&amp;atilde;o d&amp;atilde;o um dos formatos acima n&amp;atilde;o s&amp;atilde;o suportadas. Nesta situa&amp;ccedil;&amp;atilde;o, <b>mysqli_info()</b> ir&amp;aacute; retornar uma string vazia. <br /> </p></blockquote> </div> <a name='mysqli.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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Uma string representando informa&amp;ccedil;&amp;atilde;o adicional sobre a mais recente query executada. </p> </div> <a name='mysqli.info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;t1&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;INSERT&amp;nbsp;INTO&amp;nbsp;..&amp;nbsp;SELECT&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;t1&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;150'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>info</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TEMPORARY&amp;nbsp;TABLE&amp;nbsp;t1&amp;nbsp;LIKE&amp;nbsp;City'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;INSERT&amp;nbsp;INTO&amp;nbsp;..&amp;nbsp;SELECT&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;t1&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;150'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_info</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Records: 150 Duplicates: 0 Warnings: 0 </pre></div> </div> </div> <a name='mysqli.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/mysqli.affected-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_affected_rows()</a> - Retorna o n&amp;uacute;mero de linhas afetadas pela opera&amp;ccedil;&amp;atilde;o MySQL anterior</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.warning-count.php' class='function' rel='rdfs-seeAlso'>mysqli_warning_count()</a> - Returns the number of warnings from the last query for the given link</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.num-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_num_rows()</a> - Gets the number of rows in a 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="mysqli_get_warnings" value="<div id='mysqli.get-warnings' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-warnings.php'>mysqli::get_warnings</a></h1> <h1 class='refname'>mysqli_get_warnings</h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>mysqli::get_warnings</span> -- <span class='refname'>mysqli_get_warnings</span> &amp;mdash; <span class='dc-title'>Get result of SHOW WARNINGS</span></p> </div> <a name='mysqli.get-warnings.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>mysqli::get_warnings</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>mysqli_get_warnings</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></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="mysqli_get_server_version" value="<div id='mysqli.get-server-version' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-server-version.php'>mysqli-&amp;gt;server_version</a></h1> <h1 class='refname'>mysqli_get_server_version</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;server_version</span> -- <span class='refname'>mysqli_get_server_version</span> &amp;mdash; <span class='dc-title'>Retorna a vers&amp;atilde;o do servidor MySQL como um integer</span></p> </div> <a name='mysqli.get-server-version.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (propriedade):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$server_version</var>;</div> </div> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_get_server_version</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_get_server_version()</b> retorna a vers&amp;atilde;o do servidor a qual se esta conectado (representado pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> parameter) como um integer. </p> </div> <a name='mysqli.get-server-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.get-server-version.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um integer representando a vers&amp;atilde;o do servidor. </p> <p class='para'> A forma deste n&amp;uacute;mero de vers&amp;atilde;o &amp;eacute; <i>vers&amp;atilde;o_principal * 10000 + vers&amp;atilde;o_menor * 100 + sub_vers&amp;atilde;o</i> (ex. a vers&amp;atilde;o 4.1.0 &amp;eacute; 40100). </p> </div> <a name='mysqli.get-server-version.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;server&amp;nbsp;version&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Server&amp;nbsp;version:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>server_version</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;server&amp;nbsp;version&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Server&amp;nbsp;version:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_server_version</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Server version: 40102 </pre></div> </div> </div> <a name='mysqli.get-server-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/mysqli.get-client-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_client_info()</a> - Retorna a vers&amp;atilde;o do cliente MySQL como uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-version.php' class='function' rel='rdfs-seeAlso'>mysqli_get_client_version()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre o cliente MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_info()</a> - Retorna a vers&amp;atilde;o do servidor MySQL</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="mysqli_get_server_info" value="<div id='mysqli.get-server-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-server-info.php'>mysqli-&amp;gt;server_info</a></h1> <h1 class='refname'>mysqli_get_server_info</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;server_info</span> -- <span class='refname'>mysqli_get_server_info</span> &amp;mdash; <span class='dc-title'>Retorna a vers&amp;atilde;o do servidor MySQL</span></p> </div> <a name='mysqli.get-server-info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (propriedade):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$server_info</var>;</div> </div> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_get_server_info</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma string representando a vers&amp;atilde;o do servidor MySQL que a extens&amp;atilde;o MySQLi esta conectada (representado pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> ). </p> </div> <a name='mysqli.get-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.get-server-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Ums string de caracteres representando a vers&amp;atilde;o do servidor. </p> </div> <a name='mysqli.get-server-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;server&amp;nbsp;version&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Server&amp;nbsp;version:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>server_info</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;server&amp;nbsp;version&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Server&amp;nbsp;version:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_server_info</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Server version: 4.1.2-alpha-debug </pre></div> </div> </div> <a name='mysqli.get-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/mysqli.get-client-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_client_info()</a> - Retorna a vers&amp;atilde;o do cliente MySQL como uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-version.php' class='function' rel='rdfs-seeAlso'>mysqli_get_client_version()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre o cliente MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-version.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_version()</a> - Retorna a vers&amp;atilde;o do servidor MySQL como um integer</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="mysqli_get_proto_info" value="<div id='mysqli.get-proto-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-proto-info.php'>mysqli-&amp;gt;protocol_version</a></h1> <h1 class='refname'>mysqli_get_proto_info</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;protocol_version</span> -- <span class='refname'>mysqli_get_proto_info</span> &amp;mdash; <span class='dc-title'>Retorna a vers&amp;atilde;o do protocolo MySQL usada</span></p> </div> <a name='mysqli.get-proto-info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (propriedade):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$protocol_version</var>;</div> </div> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_get_proto_info</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Retorna um integer representando a vers&amp;atilde;o do protocolo MySQL usada pela conex&amp;atilde;o representada pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . </p> </div> <a name='mysqli.get-proto-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.get-proto-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um integer representando a vers&amp;atilde;o do protocolo. </p> </div> <a name='mysqli.get-proto-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;protocol&amp;nbsp;version&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Protocol&amp;nbsp;version:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>protocol_version</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;protocol&amp;nbsp;version&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Protocol&amp;nbsp;version:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_proto_info</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Protocol version: 10 </pre></div> </div> </div> <a name='mysqli.get-proto-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/mysqli.get-host-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_host_info()</a> - Retorna uma string representando o tipo da conex&amp;atilde;o usada</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="mysqli_get_host_info" value="<div id='mysqli.get-host-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-host-info.php'>mysqli_get_host_info</a></h1> <h1 class='refname'>mysqli-&amp;gt;host_info</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_get_host_info</span> -- <span class='refname'>mysqli-&amp;gt;host_info</span> &amp;mdash; <span class='dc-title'>Retorna uma string representando o tipo da conex&amp;atilde;o usada</span></p> </div> <a name='mysqli.get-host-info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_get_host_info</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'>Estilo orientado a objeto (propriedade):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$host_info</var>;</div> </div> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_get_host_info()</b> retorna uma string descrevendo a conex&amp;atilde;o representada pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> que esta sendo usada (incluindo o nome do servidor). </p> </div> <a name='mysqli.get-host-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.get-host-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Uma string de caracteres representando o nome do servidor e o tipo de conex&amp;atilde;o. </p> </div> <a name='mysqli.get-host-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;host&amp;nbsp;information&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Host&amp;nbsp;info:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>host_info</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;print&amp;nbsp;host&amp;nbsp;information&amp;nbsp;*/<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Host&amp;nbsp;info:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_host_info</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Host info: Localhost via UNIX socket </pre></div> </div> </div> <a name='mysqli.get-host-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/mysqli.get-proto-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_proto_info()</a> - Retorna a vers&amp;atilde;o do protocolo MySQL usada</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="mysqli_get_client_version" value="<div id='mysqli.get-client-version' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-client-version.php'>mysqli::get_client_version</a></h1> <h1 class='refname'>mysqli_get_client_version</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::get_client_version</span> -- <span class='refname'>mysqli_get_client_version</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre o cliente MySQL</span></p> </div> <a name='mysqli.get-client-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'>int</span> <span class='methodname'><b>mysqli::get_client_version</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_get_client_version</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Retorna a vers&amp;atilde;o do cliente como um inteiro. </p> </div> <a name='mysqli.get-client-version.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um n&amp;uacute;mero que representa a vers&amp;atilde;o da biblioteca de cliente MySQL no formato: <i>vers&amp;atilde;o_principal*10000 + vers&amp;atilde;o_menor *100 + sub_vers&amp;atilde;o</i>. Por exemplo, 4.1.0 &amp;eacute; retornado como 40100. </p> <p class='para'> Isto &amp;eacute; &amp;uacute;til para determinar rapidamente a vers&amp;atilde;o da biblioteca de cliente para saber se alguma funcionalidade existe. </p> </div> <a name='mysqli.get-client-version.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 mysqli_get_client_version</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;We&amp;nbsp;don't&amp;nbsp;need&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;to&amp;nbsp;determine<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;the&amp;nbsp;version&amp;nbsp;of&amp;nbsp;mysql&amp;nbsp;client&amp;nbsp;library&amp;nbsp;*/<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Client&amp;nbsp;library&amp;nbsp;version:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_client_version</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='mysqli.get-client-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/mysqli.get-client-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_client_info()</a> - Retorna a vers&amp;atilde;o do cliente MySQL como uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_info()</a> - Retorna a vers&amp;atilde;o do servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-version.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_version()</a> - Retorna a vers&amp;atilde;o do servidor MySQL como um integer</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="mysqli_get_client_info" value="<div id='mysqli.get-client-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-client-info.php'>mysqli::get_client_info</a></h1> <h1 class='refname'>mysqli_get_client_info</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::get_client_info</span> -- <span class='refname'>mysqli_get_client_info</span> &amp;mdash; <span class='dc-title'>Retorna a vers&amp;atilde;o do cliente MySQL como uma string</span></p> </div> <a name='mysqli.get-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'>string</span> <span class='methodname'><b>mysqli::get_client_info</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_get_client_info</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_get_client_info()</b> &amp;eacute; usada para retornar uma string representando a vers&amp;atilde;o de cliente usada na extens&amp;atilde;o MySQLi. </p> </div> <a name='mysqli.get-client-info.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Uma string que representa a vers&amp;atilde;o da biblioteca de cliente do MySQL. </p> </div> <a name='mysqli.get-client-info.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 mysqli_get_client_info</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;We&amp;nbsp;don't&amp;nbsp;need&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;to&amp;nbsp;determine<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;the&amp;nbsp;version&amp;nbsp;of&amp;nbsp;mysql&amp;nbsp;client&amp;nbsp;library&amp;nbsp;*/<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Client&amp;nbsp;library&amp;nbsp;version:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_client_info</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='mysqli.get-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/mysqli.get-client-version.php' class='function' rel='rdfs-seeAlso'>mysqli_get_client_version()</a> - Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre o cliente MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-info.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_info()</a> - Retorna a vers&amp;atilde;o do servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-version.php' class='function' rel='rdfs-seeAlso'>mysqli_get_server_version()</a> - Retorna a vers&amp;atilde;o do servidor MySQL como um integer</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="mysqli_get_charset" value="<div id='mysqli.get-charset' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.get-charset.php'>mysqli::get_charset</a></h1> <h1 class='refname'>mysqli_get_charset</h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>mysqli::get_charset</span> -- <span class='refname'>mysqli_get_charset</span> &amp;mdash; <span class='dc-title'>Returns a character set object</span></p> </div> <a name='mysqli.get-charset.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>mysqli::get_charset</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>mysqli_get_charset</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Returns a character set object providing several properties of the current active character set. </p> </div> <a name='mysqli.get-charset.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.get-charset.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The function returns a character set object with the following properties: </p><dl> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>charset</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Character set name</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>collation</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Collation name</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dir</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Directory the charset description was fetched from (?) or &amp;quot;&amp;quot; for built-in character sets</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>min_length</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Minimum character length in bytes</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>max_length</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Maximum character length in bytes</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>number</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Internal character set number</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>state</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Character set status (?)</p></dd> </dl> <p> </p> </div> <a name='mysqli.get-charset.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</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;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_init</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>real_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'root'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>get_charset</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</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;$db&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_init</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_real_connect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'root'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>get_charset</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> object(stdClass)#2 (7) { [&amp;quot;charset&amp;quot;]=&amp;gt; string(6) &amp;quot;latin1&amp;quot; [&amp;quot;collation&amp;quot;]=&amp;gt; string(17) &amp;quot;latin1_swedish_ci&amp;quot; [&amp;quot;dir&amp;quot;]=&amp;gt; string(0) &amp;quot;&amp;quot; [&amp;quot;min_length&amp;quot;]=&amp;gt; int(1) [&amp;quot;max_length&amp;quot;]=&amp;gt; int(1) [&amp;quot;number&amp;quot;]=&amp;gt; int(8) [&amp;quot;state&amp;quot;]=&amp;gt; int(801) } </pre></div> </div> </div> <a name='mysqli.get-charset.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/mysqli.character-set-name.php' class='function' rel='rdfs-seeAlso'>mysqli_character_set_name()</a> - Retorna o conjunto de caracteres padr&amp;atilde;o para a conex&amp;atilde;o com o banco de dados</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.set-charset.php' class='function' rel='rdfs-seeAlso'>mysqli_set_charset()</a> - Sets the default client character 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="mysqli_free_result" value="<div id='mysqli-stmt.free-result' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-stmt.free-result.php'>mysqli_free_result</a></h1> <h1 class='refname'>result-&amp;gt;free</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_free_result</span> -- <span class='refname'>result-&amp;gt;free</span> &amp;mdash; <span class='dc-title'>Libera a mem&amp;oacute;ria associada ao resultado</span></p> </div> <a name='mysqli-stmt.free-result.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_stmt::free_result</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_stmt_free_result</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_stmt'>mysqli_stmt</span></span> <tt class='parameter'>$stmt</tt></span> )</div> <p class='para rdfs-comment'> Libera o resultado da mem&amp;oacute;ria associado com o comando, que foi alocado por <a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function'>mysqli_stmt_store_result()</a>. </p> </div> <a name='mysqli-stmt.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'>Apenas para estilo de procedimento: Um identificador de statement retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php' class='function'>mysqli_stmt_init()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-stmt.free-result.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='mysqli-stmt.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/mysqli-stmt.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_store_result()</a> - Transfers a result set from a prepared 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="mysqli_free_result" value="<div id='mysqli-result.free' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.free.php'>mysqli_result::free</a></h1> <h1 class='refname'>mysqli_free_result</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result::free</span> -- <span class='refname'>mysqli_free_result</span> &amp;mdash; <span class='dc-title'>Frees the memory associated with a result</span></p> </div> <a name='mysqli-result.free.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (all methods are equivalent):</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_result::free</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_result::close</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_result::free_result</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_free_result</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Frees the memory associated with the result. </p> <blockquote><p><b class='note'>Nota</b>: You should always free your result with <b>mysqli_free_result()</b>, when your result object is not needed anymore. <br /> </p></blockquote> </div> <a name='mysqli-result.free.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'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.free.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='mysqli-result.free.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/mysqli.query.php' class='function' rel='rdfs-seeAlso'>mysqli_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-stmt.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_stmt_store_result()</a> - Transfers a result set from a prepared statement</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function' rel='rdfs-seeAlso'>mysqli_use_result()</a> - Initiate a result set retrieval</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="mysqli_field_tell" value="<div id='mysqli-result.current-field' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.current-field.php'>mysqli_result-&amp;gt;current_field</a></h1> <h1 class='refname'>mysqli_field_tell</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result-&amp;gt;current_field</span> -- <span class='refname'>mysqli_field_tell</span> &amp;mdash; <span class='dc-title'>Get current field offset of a result pointer</span></p> </div> <a name='mysqli-result.current-field.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_result</b></div> <div class='fieldsynopsis'> <span class='type'>int</span> <var class='varname'>$current_field</var> ;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_field_tell</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Returns the position of the field cursor used for the last <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function'>mysqli_fetch_field()</a> call. This value can be used as an argument to <a href='http://www.php.net/manual/pt_BR/mysqli-result.field-seek.php' class='function'>mysqli_field_seek()</a>. </p> </div> <a name='mysqli-result.current-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'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.current-field.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns current offset of field cursor. </p> </div> <a name='mysqli-result.current-field.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;all&amp;nbsp;columns&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_field</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;get&amp;nbsp;fieldpointer&amp;nbsp;offset&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$currentfield&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>current_field</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Column&amp;nbsp;%d:\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$currentfield</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;all&amp;nbsp;fields&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_field</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</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;get&amp;nbsp;fieldpointer&amp;nbsp;offset&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$currentfield&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_field_tell</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Column&amp;nbsp;%d:\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$currentfield</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Column 1: Name: Name Table: Country max. Len: 11 Flags: 1 Type: 254 Column 2: Name: SurfaceArea Table: Country max. Len: 10 Flags: 32769 Type: 4 </pre></div> </div> </div> <a name='mysqli-result.current-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/mysqli-result.fetch-field.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_field()</a> - Retorna o pr&amp;oacute;ximo campo no conjunto de resultados</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-seek.php' class='function' rel='rdfs-seeAlso'>mysqli_field_seek()</a> - Move o ponteiro do resultado para um campo especificado</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="mysqli_field_seek" value="<div id='mysqli-result.field-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.field-seek.php'>mysqli_field_seek</a></h1> <h1 class='refname'>result-&amp;gt;field_seek</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_field_seek</span> -- <span class='refname'>result-&amp;gt;field_seek</span> &amp;mdash; <span class='dc-title'>Move o ponteiro do resultado para um campo especificado</span></p> </div> <a name='mysqli-result.field-seek.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_result::field_seek</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fieldnr</tt></span> )</div> <p class='para rdfs-comment'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_field_seek</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fieldnr</tt></span> )</div> <p class='para rdfs-comment'> Define o cursor dos campo para o &amp;iacute;ndice indicado. A pr&amp;oacute;xima chamada a <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function'>mysqli_fetch_field()</a> ir&amp;aacute; retornar as informa&amp;ccedil;&amp;otilde;es da defini&amp;ccedil;&amp;atilde;o do campo com este &amp;iacute;ndice. </p> <blockquote><p><b class='note'>Nota</b>: Para mover para o in&amp;iacute;cio da linha, passe um &amp;iacute;ndice de valor zero.<br /> </p></blockquote> </div> <a name='mysqli-result.field-seek.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'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>fieldnr</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do campo. Este valor precisa estar num intervalo de <i>0</i> a <i>num&amp;eacute;ro de campos - 1</i>. </p> </dd> </dl> <p> </p> </div> <a name='mysqli-result.field-seek.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='mysqli-result.field-seek.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Modo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;2nd&amp;nbsp;column&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>field_seek</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_field</span><span style='color: #007700'>();<br /><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'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Modo procedural</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;2nd&amp;nbsp;column&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_field_seek</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 />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_field</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><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'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Name: SurfaceArea Table: Country max. Len: 10 Flags: 32769 Type: 4 </pre></div> </div> </div> <a name='mysqli-result.field-seek.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/mysqli-result.fetch-field.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_field()</a> - Retorna o pr&amp;oacute;ximo campo no conjunto de resultados</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="mysqli_field_count" value="<div id='mysqli.field-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.field-count.php'>mysqli_field_count</a></h1> <h1 class='refname'>mysqli-&amp;gt;field_count</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_field_count</span> -- <span class='refname'>mysqli-&amp;gt;field_count</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero de colunas para a consulta mais recente</span></p> </div> <a name='mysqli.field-count.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_field_count</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'>Estilo orientado a objeto (metodo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysql</b></div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>field_count</b></span> ( <span class='methodparam'>void</span> )</div> </div> <p class='para'> Retorna o n&amp;uacute;mero de colunas para a consulta mais recente na conex&amp;atilde;o representada pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . Esta fun&amp;ccedil;&amp;atilde;o pode ser &amp;uacute;til ao usar a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> para determinar se a consulta produziu um conjunto de resultados vazio ou n&amp;atilde;o sem conhecer a natureza da consulta. </p> </div> <a name='mysqli.field-count.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'>Um inteiro representando o n&amp;uacute;mero de campos no conjunto de resultados</p> </div> <a name='mysqli.field-count.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;IF&amp;nbsp;EXISTS&amp;nbsp;friends'</span><span style='color: #007700'>);&amp;nbsp;<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;friends&amp;nbsp;(id&amp;nbsp;int,&amp;nbsp;name&amp;nbsp;varchar(20))'</span><span style='color: #007700'>);&amp;nbsp;<br />&amp;nbsp;<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;friends&amp;nbsp;VALUES&amp;nbsp;(1,'Hartmut'),&amp;nbsp;(2,&amp;nbsp;'Ulf')'</span><span style='color: #007700'>);<br /><br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>real_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$HTTP_POST_VARS</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'query'</span><span style='color: #007700'>]);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_field_count</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;was&amp;nbsp;a&amp;nbsp;select/show&amp;nbsp;or&amp;nbsp;describe&amp;nbsp;query&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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>store_result</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;process&amp;nbsp;resultset&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;resultset&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;IF&amp;nbsp;EXISTS&amp;nbsp;friends'</span><span style='color: #007700'>);&amp;nbsp;<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;friends&amp;nbsp;(id&amp;nbsp;int,&amp;nbsp;name&amp;nbsp;varchar(20))'</span><span style='color: #007700'>);&amp;nbsp;<br />&amp;nbsp;<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;friends&amp;nbsp;VALUES&amp;nbsp;(1,'Hartmut'),&amp;nbsp;(2,&amp;nbsp;'Ulf')'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_real_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$HTTP_POST_VARS</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'query'</span><span style='color: #007700'>]);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_field_count</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;was&amp;nbsp;a&amp;nbsp;select/show&amp;nbsp;or&amp;nbsp;describe&amp;nbsp;query&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'>mysqli_store_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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;process&amp;nbsp;resultset&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;resultset&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</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="mysqli_fetch_row" value="<div id='mysqli-result.fetch-row' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-row.php'>mysqli_result::fetch_row</a></h1> <h1 class='refname'>mysqli_fetch_row</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result::fetch_row</span> -- <span class='refname'>mysqli_fetch_row</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m uma linha do resultado como uma matriz numerada</span></p> </div> <a name='mysqli-result.fetch-row.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo):</p> <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>mysqli_result::fetch_row</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <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>mysqli_fetch_row</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma matriz que corresponde a linha obtida, <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas. </p> <p class='para'> <b>mysqli_fetch_row()</b> obt&amp;eacute;m uma linha de dados do conjunto de resultados representado pelo par&amp;acirc;metro <i><tt class='parameter'>result</tt></i> &amp;eacute; retorna-a como uma matriz numerada, onde cada coluna &amp;eacute; guardada em um &amp;iacute;ndice da matriz come&amp;ccedil;ando de 0 (zero). Cada utiliza&amp;ccedil;&amp;atilde;o subseq&amp;uuml;ente de <b>mysqli_fetch_row()</b> ir&amp;aacute; retornar a pr&amp;oacute;xima linha do conjunto de resultados, ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houverem mais linhas. </p> </div> <a name='mysqli-result.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.fetch-row.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>mysqli_fetch_row()</b> retorna uma matriz que corresponde a linha obtida ou <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas no conjunto de resultados. </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='mysqli-result.fetch-row.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br />&amp;nbsp;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;50,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;object&amp;nbsp;array&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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: #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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;50,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;associative&amp;nbsp;array&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_row</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;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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: #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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA) </pre></div> </div> </div> <a name='mysqli-result.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/mysqli-result.fetch-array.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_array()</a> - Obtem uma linha do resultado como uma matriz associativa, num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_assoc()</a> - Obtem uma linha do conjunto de resultados como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-object.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_object()</a> - Retorna a linha atual do conjunto de resultados como um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function' rel='rdfs-seeAlso'>mysqli_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.data-seek.php' class='function' rel='rdfs-seeAlso'>mysqli_data_seek()</a> - Ajusta o ponteiro do resultado para uma linha arbritaria no conjunto de resutados</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="mysqli_fetch_object" value="<div id='mysqli-result.fetch-object' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-object.php'>mysqli_fetch_object</a></h1> <h1 class='refname'>result-&amp;gt;fetch_object</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_fetch_object</span> -- <span class='refname'>result-&amp;gt;fetch_object</span> &amp;mdash; <span class='dc-title'>Retorna a linha atual do conjunto de resultados como um objeto</span></p> </div> <a name='mysqli-result.fetch-object.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento:</p> <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>mysqli_fetch_object</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'>Estilo orientado a objeto (metodo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>result</b></div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><b>fetch_object</b></span> ( <span class='methodparam'>void</span> )</div> </div> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_fetch_object()</b> ir&amp;aacute; retornar a linha atual do conjunto de resultados como um objeto aonde os atributos do objeto representam os nomes dos campos encontrados no conjunto de resultados. Se n&amp;atilde;o existirem mais linhas no conjunto de resultados atual, &amp;eacute; retornado <b><tt class='constant'>NULL</tt></b>. </p> </div> <a name='mysqli-result.fetch-object.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'> Retorna um objeto que corresponde a linha obtida ou <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas no conjunto de resultados. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <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='mysqli-result.fetch-object.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-array.php' class='function'>mysqli_fetch_array()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php' class='function'>mysqli_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function'>mysqli_fetch_row()</a>. </p> </div> <a name='mysqli-result.fetch-object.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br />&amp;nbsp;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;50,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;object&amp;nbsp;array&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$obj&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_object</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'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$obj</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$obj</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CountryCode</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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;50,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;associative&amp;nbsp;array&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$obj&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_object</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;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$obj</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$obj</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>CountryCode</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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> Os exemplos acima devem produzir a seguinte sa&amp;iacute;da: </p> <div class='example-contents screen'> <div class='cdata'><pre> Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA) </pre></div> </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="mysqli_fetch_lengths" value="<div id='mysqli-result.lengths' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.lengths.php'>mysqli_result-&amp;gt;lengths</a></h1> <h1 class='refname'>mysqli_fetch_lengths</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result-&amp;gt;lengths</span> -- <span class='refname'>mysqli_fetch_lengths</span> &amp;mdash; <span class='dc-title'>Returns the lengths of the columns of the current row in the result set</span></p> </div> <a name='mysqli-result.lengths.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli_result</b></div> <div class='fieldsynopsis'><span class='type'>array</span> <var class='varname'>$lengths</var>;</div> </div> <p class='para'>Procedural style:</p> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>mysqli_fetch_lengths</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> The <b>mysqli_fetch_lengths()</b> function returns an array containing the lengths of every column of the current row within the result set. </p> </div> <a name='mysqli-result.lengths.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'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.lengths.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An array of integers representing the size of each column (not including any terminating null characters). <b><tt class='constant'>FALSE</tt></b> if an error occurred. </p> <p class='para'> <b>mysqli_fetch_lengths()</b> is valid only for the current row of the result set. It returns <b><tt class='constant'>FALSE</tt></b> if you call it before calling mysqli_fetch_row/array/object or after retrieving all rows in the result. </p> </div> <a name='mysqli-result.lengths.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Object oriented style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;1'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;display&amp;nbsp;column&amp;nbsp;lengths&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>foreach&amp;nbsp;(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>lengths&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$val</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Field&amp;nbsp;%2d&amp;nbsp;has&amp;nbsp;Length&amp;nbsp;%2d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>+</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Procedural style</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;1'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;display&amp;nbsp;column&amp;nbsp;lengths&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>foreach&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_fetch_lengths</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>)&amp;nbsp;as&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$val</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Field&amp;nbsp;%2d&amp;nbsp;has&amp;nbsp;Length&amp;nbsp;%2d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>+</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</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'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Field 1 has Length 3 Field 2 has Length 5 Field 3 has Length 13 Field 4 has Length 9 Field 5 has Length 6 Field 6 has Length 1 Field 7 has Length 6 Field 8 has Length 4 Field 9 has Length 6 Field 10 has Length 6 Field 11 has Length 5 Field 12 has Length 44 Field 13 has Length 7 Field 14 has Length 3 Field 15 has Length 2 </pre></div> </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="mysqli_fetch_field_direct" value="<div id='mysqli-result.fetch-field-direct' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-field-direct.php'>mysqli_fetch_field_direct</a></h1> <h1 class='refname'>result-&amp;gt;fetch_field_direct</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_fetch_field_direct</span> -- <span class='refname'>result-&amp;gt;fetch_field_direct</span> &amp;mdash; <span class='dc-title'> Obtem meta dados para um &amp;uacute;nico campo </span></p> </div> <a name='mysqli-result.fetch-field-direct.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento:</p> <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>mysqli_fetch_field_direct</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$result</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fieldnr</tt></span> )</div> <p class='para rdfs-comment'>Estilo orientado a objeto (metodo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>result</b></div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><b>fetch_field_direct</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$fieldnr</tt></span> )</div> </div> <p class='para'> <b>mysqli_fetch_field_direct()</b> retorna um objeto o qual cont&amp;eacute;m informa&amp;ccedil;&amp;otilde;es da defini&amp;ccedil;&amp;atilde;o de um campo do conjunto de resultados especificado. O valor de <i><tt class='parameter'>fieldnr</tt></i> deve estar no intervalo entre <i>0</i> e <i>n&amp;uacute;mero de campos - 1</i>. </p> </div> <a name='mysqli-result.fetch-field-direct.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'> Retorna um objeto o qual cont&amp;eacute;m informa&amp;ccedil;&amp;otilde;es das defini&amp;ccedil;&amp;otilde;es de um campo ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houver informa&amp;ccedil;&amp;otilde;es sobre o campo especificado com <i>fieldnr</i> dispon&amp;iacute;veis. </p> <p class='para'> </p><table class='doctable table'> <caption><b>Atributos do objeto</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Atibuto</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>name</td> <td align='left'>O nome da coluna</td> </tr> <tr valign='middle'> <td align='left'>orgname</td> <td align='left'>Nome original da coluna se foi especificado um alias</td> </tr> <tr valign='middle'> <td align='left'>table</td> <td align='left'>O nome da tabela a qual este campo pertence (se n&amp;atilde;o for calculada)</td> </tr> <tr valign='middle'> <td align='left'>orgtable</td> <td align='left'>Nome da tabela original se foi especificado um alias</td> </tr> <tr valign='middle'> <td align='left'>def</td> <td align='left'>O valor padr&amp;atilde;o para este campo, representado por uma string</td> </tr> <tr valign='middle'> <td align='left'>max_length</td> <td align='left'>O limite de tamanho para o campo no conjunto de resultados.</td> </tr> <tr valign='middle'> <td align='left'>flags</td> <td align='left'>Um inteiro representando bit-flags para o campo.</td> </tr> <tr valign='middle'> <td align='left'>type</td> <td align='left'>O tipo de dados para este campo</td> </tr> <tr valign='middle'> <td align='left'>decimals</td> <td align='left'>O n&amp;uacute;mero de casas decimais usadas (para campos integer)</td> </tr> </tbody> </table> <p> </p> </div> <a name='mysqli-result.fetch-field-direct.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli-result.field-count.php' class='function'>mysqli_num_fields()</a> <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function'>mysqli_fetch_field()</a> <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-fields.php' class='function'>mysqli_fetch_fields()</a> </p> </div> <a name='mysqli-result.fetch-field-direct.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;column&amp;nbsp;'SurfaceArea'&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_field_direct</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br />&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'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;column&amp;nbsp;'SurfaceArea'&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_field_direct</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 />&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'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> Os exemplos acima devem produzir a seguinte sa&amp;iacute;da: </p> <div class='example-contents screen'> <div class='cdata'><pre> Name: SurfaceArea Table: Country max. Len: 10 Flags: 32769 Type: 4 </pre></div> </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="mysqli_fetch_fields" value="<div id='mysqli-result.fetch-fields' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-fields.php'>mysqli_result::fetch_fields</a></h1> <h1 class='refname'>mysqli_fetch_fields</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result::fetch_fields</span> -- <span class='refname'>mysqli_fetch_fields</span> &amp;mdash; <span class='dc-title'>Retorna uma matriz de objetos representando os campos em um conjunto de resultados</span></p> </div> <a name='mysqli-result.fetch-fields.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo):</p> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>mysqli_result::fetch_fields</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>mysqli_fetch_fields</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o serve para o mesmo prop&amp;oacute;sito que a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function'>mysqli_fetch_field()</a> com uma simples diferen&amp;ccedil;a, ao inv&amp;eacute;s de retornar um objeto de cada vez para cada campo, as colunas s&amp;atilde;o retornadas como uma matriz de objetos. </p> </div> <a name='mysqli-result.fetch-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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.fetch-fields.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma matriz de objetos o quais cont&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre as defini&amp;ccedil;&amp;otilde;es dos campo ou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houver infor&amp;ccedil;&amp;otilde;es dos campos dispon&amp;iacute;veis. </p> <p class='para'> </p><table class='doctable table'> <caption><b>Propriedades dos objetos</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Propriedade</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>name</td> <td align='left'>O nome da coluna</td> </tr> <tr valign='middle'> <td align='left'>orgname</td> <td align='left'>O nome original da coluna se foi especificado um alias</td> </tr> <tr valign='middle'> <td align='left'>table</td> <td align='left'>O nome da tabela a qual o campo pertence (se n&amp;atilde;o for calculado)</td> </tr> <tr valign='middle'> <td align='left'>orgtable</td> <td align='left'>Nome da tabela original se foi especificado um alias</td> </tr> <tr valign='middle'> <td align='left'>def</td> <td align='left'>O valor padr&amp;atilde;o para este campo, representado como um string</td> </tr> <tr valign='middle'> <td align='left'>max_length</td> <td align='left'>A largura m&amp;aacute;xima do campo no conjunto de resultados.</td> </tr> <tr valign='middle'> <td align='left'>length</td> <td align='left'>O tamanho do campo, como espec&amp;iacute;ficado na defini&amp;ccedil;&amp;atilde;o da tabela.</td> </tr> <tr valign='middle'> <td align='left'>charsetnr</td> <td align='left'>O n&amp;uacute;mero do conjunto de caracteres do campo.</td> </tr> <tr valign='middle'> <td align='left'>flags</td> <td align='left'>Um inteiro representando bit-flags para o campo.</td> </tr> <tr valign='middle'> <td align='left'>type</td> <td align='left'>O tipo de dados usado para este campo</td> </tr> <tr valign='middle'> <td align='left'>decimals</td> <td align='left'>O n&amp;uacute;mero de decimais usados (para campos integer)</td> </tr> </tbody> </table> <p> </p> </div> <a name='mysqli-result.fetch-fields.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;all&amp;nbsp;columns&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_fields</span><span style='color: #007700'>();<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;foreach&amp;nbsp;(</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$val</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;all&amp;nbsp;columns&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_fields</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;foreach&amp;nbsp;(</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$val</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Name: Name Table: Country max. Len: 11 Flags: 1 Type: 254 Name: SurfaceArea Table: Country max. Len: 10 Flags: 32769 Type: 4 </pre></div> </div> </div> <a name='mysqli-result.fetch-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/mysqli-result.field-count.php' class='function' rel='rdfs-seeAlso'>mysqli_num_fields()</a> - Get the number of fields in a result</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field-direct.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_field_direct()</a> - Obtem meta dados para um &amp;uacute;nico campo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_field()</a> - Retorna o pr&amp;oacute;ximo campo no conjunto de resultados</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="mysqli_fetch_field" value="<div id='mysqli-result.fetch-field' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-field.php'>mysqli_result::fetch_field</a></h1> <h1 class='refname'>mysqli_fetch_field</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result::fetch_field</span> -- <span class='refname'>mysqli_fetch_field</span> &amp;mdash; <span class='dc-title'>Retorna o pr&amp;oacute;ximo campo no conjunto de resultados</span></p> </div> <a name='mysqli-result.fetch-field.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo):</p> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>mysqli_result::fetch_field</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>mysqli_fetch_field</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_fetch_field()</b> retorna a defini&amp;ccedil;&amp;atilde;o de uma coluna do conjunto de resultados como um objeto. Utilize esta fun&amp;ccedil;&amp;atilde;o repetidamente para obter sobre todas as colunas no conjunto de resultados. <b>mysqli_fetch_field()</b> retorna <b><tt class='constant'>FALSE</tt></b> quando n&amp;atilde;o houverem mais campos. </p> </div> <a name='mysqli-result.fetch-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'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.fetch-field.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um objeto o qual cont&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre a defini&amp;ccedil;&amp;atilde;o do campoou <b><tt class='constant'>FALSE</tt></b> se n&amp;atilde;o houver informa&amp;ccedil;&amp;atilde;o sobre campos dispon&amp;iacute;vel. </p> <p class='para'> </p><table class='doctable table'> <caption><b>Propriedades do objeto</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Propriedade</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>name</td> <td align='left'>O nome da coluna</td> </tr> <tr valign='middle'> <td align='left'>orgname</td> <td align='left'>Nome original da coluna se foi especificado um alias</td> </tr> <tr valign='middle'> <td align='left'>table</td> <td align='left'>O nome da tabela a qual este campo pertence (se n&amp;atilde;o for calculada)</td> </tr> <tr valign='middle'> <td align='left'>orgtable</td> <td align='left'>Nome da tabela original se foi especificado um alias</td> </tr> <tr valign='middle'> <td align='left'>def</td> <td align='left'>O valor padr&amp;atilde;o para este campo, representando como uma string</td> </tr> <tr valign='middle'> <td align='left'>max_length</td> <td align='left'>O tamanho m&amp;aacute;ximo do campo no conjunto de resultados.</td> </tr> <tr valign='middle'> <td align='left'>flags</td> <td align='left'>Um inteiro representando bit-flags para o campo.</td> </tr> <tr valign='middle'> <td align='left'>type</td> <td align='left'>O tipo de dados usado para este campo</td> </tr> <tr valign='middle'> <td align='left'>decimals</td> <td align='left'>O n&amp;uacute;mero de decimais usados (par campos integer)</td> </tr> </tbody> </table> <p> </p> </div> <a name='mysqli-result.fetch-field.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;all&amp;nbsp;columns&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_field</span><span style='color: #007700'>())&amp;nbsp;{<br />&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;SurfaceArea&amp;nbsp;from&amp;nbsp;Country&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Code&amp;nbsp;LIMIT&amp;nbsp;5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Get&amp;nbsp;field&amp;nbsp;information&amp;nbsp;for&amp;nbsp;all&amp;nbsp;fields&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$finfo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_field</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Name:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>name</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Table:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>table</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'max.&amp;nbsp;Len:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>max_length</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Flags:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>flags</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Type:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;%d\n\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$finfo</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>type</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'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Name: Name Table: Country max. Len: 11 Flags: 1 Type: 254 Name: SurfaceArea Table: Country max. Len: 10 Flags: 32769 Type: 4 </pre></div> </div> </div> <a name='mysqli-result.fetch-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/mysqli-result.field-count.php' class='function' rel='rdfs-seeAlso'>mysqli_num_fields()</a> - Get the number of fields in a result</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-field-direct.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_field_direct()</a> - Obtem meta dados para um &amp;uacute;nico campo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-fields.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_fields()</a> - Retorna uma matriz de objetos representando os campos em um conjunto de resultados</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.field-seek.php' class='function' rel='rdfs-seeAlso'>mysqli_field_seek()</a> - Move o ponteiro do resultado para um campo especificado</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="mysqli_fetch_assoc" value="<div id='mysqli-result.fetch-assoc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-assoc.php'>mysqli_result::fetch_assoc</a></h1> <h1 class='refname'>mysqli_fetch_assoc</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result::fetch_assoc</span> -- <span class='refname'>mysqli_fetch_assoc</span> &amp;mdash; <span class='dc-title'>Obtem uma linha do conjunto de resultados como uma matriz associativa</span></p> </div> <a name='mysqli-result.fetch-assoc.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo):</p> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>mysqli_result::fetch_assoc</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>mysqli_fetch_assoc</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></span> <tt class='parameter'>$result</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma matriz associativa que corresponde a linha obtida, ou <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas. </p> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_fetch_assoc()</b> &amp;eacute; usada para retornar uma matriz associativa representando a pr&amp;oacute;xima linha no conjunto de resultados representado pelo par&amp;acirc;metro <i><tt class='parameter'>result</tt></i> , aonde cada chave representa o nome de uma coluna do conjunto de resultados. </p> <p class='para'> Se duas ou mais colunas do resultado tiverem o mesmo nome do campo, a ultima coluna ter&amp;aacute; precedencia, Paa acessar as outra coluna(s) com o mesmo nome, voc&amp;ecirc; pode acessar o resultados com &amp;iacute;ndices n&amp;uacute;mericos usando a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function'>mysqli_fetch_row()</a> ou adicionar apelidos. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <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='mysqli-result.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'> result</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de um conjunto de resultados retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli_use_result()</a>.</p></dd> </dl> <p> </p> </div> <a name='mysqli-result.fetch-assoc.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma matriz que corresponde a linha obtida <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas no conjunto de resultados. </p> </div> <a name='mysqli-result.fetch-assoc.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br />&amp;nbsp;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;50,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;associative&amp;nbsp;array&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_assoc</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'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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'>'CountryCode'</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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;DESC&amp;nbsp;LIMIT&amp;nbsp;50,5'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;associative&amp;nbsp;array&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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'>'CountryCode'</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: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA) </pre></div> </div> </div> <a name='mysqli-result.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/mysqli-result.fetch-array.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_array()</a> - Obtem uma linha do resultado como uma matriz associativa, num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_row()</a> - Obt&amp;eacute;m uma linha do resultado como uma matriz numerada</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-object.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_object()</a> - Retorna a linha atual do conjunto de resultados como um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function' rel='rdfs-seeAlso'>mysqli_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.data-seek.php' class='function' rel='rdfs-seeAlso'>mysqli_data_seek()</a> - Ajusta o ponteiro do resultado para uma linha arbritaria no conjunto de resutados</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="mysqli_fetch_array" value="<div id='mysqli-result.fetch-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.fetch-array.php'>mysqli_fetch_array</a></h1> <h1 class='refname'>result-&amp;gt;fetch_array</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_fetch_array</span> -- <span class='refname'>result-&amp;gt;fetch_array</span> &amp;mdash; <span class='dc-title'>Obtem uma linha do resultado como uma matriz associativa, num&amp;eacute;rica, ou ambas</span></p> </div> <a name='mysqli-result.fetch-array.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento:</p> <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>mysqli_fetch_array</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$result</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$resulttype</tt></span> ] )</div> <p class='para rdfs-comment'>Estilo orientado a objetos (metodo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>result</b></div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><b>fetch_array</b></span> ([ <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$resulttype</tt></span> ] )</div> </div> <p class='para'> Retorna uma matriz que corresponde a linha obtida ou <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas para o conjunto deresultados representado pelo par&amp;acirc;metro <i><tt class='parameter'>result</tt></i> . </p> <p class='para'> <b>mysqli_fetch_array()</b> &amp;eacute; uma vers&amp;atilde;o extendida da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function'>mysqli_fetch_row()</a>. Alem de guardar os dados em &amp;iacute;ndices num&amp;eacute;ricos na matriz do resultado, a fun&amp;ccedil;&amp;atilde;o <b>mysqli_fetch_array()</b> pode tamb&amp;eacute;m guardar os dados em &amp;iacute;ndices associativos, usando os nomes dos campos do conjunto de resultado como chave. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Nomes de campos nesta fun&amp;ccedil;&amp;atilde;o <em class='emphasis'>diferenciam mai&amp;uacute;sculas e minusculas</em>.</span></p></blockquote> <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> <p class='para'> Se duas ou mais colunas do resultado tiverem o mesmo nome do campo, a ultima coluna ter&amp;aacute; precedencia e ir&amp;aacute; sobrescrever os dados anteriores. Para poder acessar m&amp;uacute;ltiplas colunas com o mesmo nome, deve ser usada a vers&amp;atilde;o com os &amp;iacute;ndices num&amp;eacute;ricos. </p> <p class='para'> O segundo arqumento, que &amp;eacute; opcional, <i><tt class='parameter'>resulttype</tt></i> &amp;eacute; uma constante indicando qual tipo de matriz deve ser produzido da linha atual do resultado. Os valores poss&amp;iacute;veis para este par&amp;acirc;metro s&amp;atilde;o as constantes MYSQLI_ASSOC, MYSQLI_NUM, ou MYSQLI_BOTH. Pos padr&amp;atilde;o, a fun&amp;ccedil;&amp;atilde;o <b>mysqli_fetch_array()</b> ir&amp;aacute; assumir MYSQLI_BOTH para este par&amp;acirc;metro. </p> <p class='para'> Usando a constante MYSQLI_ASSOC esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; funcionar de modo identico a <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php' class='function'>mysqli_fetch_assoc()</a>, enquando MYSQLI_NUM ir&amp;aacute; funcionar de modo identico a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function'>mysqli_fetch_row()</a>. A op&amp;ccedil;&amp;atilde;o final MYSQLI_BOTH ir&amp;aacute; criar uma &amp;uacute;nica matriz com os atributos de ambas. </p> </div> <a name='mysqli-result.fetch-array.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'> Retorna uma matriz que corresponde a linha obtida ou <b><tt class='constant'>NULL</tt></b> se n&amp;atilde;o houverem mais linhas no conjunto de resultados. </p> </div> <a name='mysqli-result.fetch-array.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php' class='function'>mysqli_fetch_assoc()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function'>mysqli_fetch_row()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-object.php' class='function'>mysqli_fetch_object()</a>. </p> </div> <a name='mysqli-result.fetch-array.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br />&amp;nbsp;<br /></span><span style='color: #0000BB'>$query&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;3'</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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;numeric&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_NUM</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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: #0000BB'>1</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;associative&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_ASSOC</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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'>'CountryCode'</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;associative&amp;nbsp;and&amp;nbsp;numeric&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>MYSQLI_BOTH</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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'>'CountryCode'</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;by&amp;nbsp;ID&amp;nbsp;LIMIT&amp;nbsp;3'</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'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;numeric&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>MYSQLI_NUM</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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: #0000BB'>1</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;associative&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>MYSQLI_ASSOC</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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'>'CountryCode'</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;associative&amp;nbsp;and&amp;nbsp;numeric&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>MYSQLI_BOTH</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%s&amp;nbsp;(%s)\n'</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'>'CountryCode'</span><span style='color: #007700'>]);&amp;nbsp;&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> Os exemplos acima devem produzir a seguinte sa&amp;iacute;da: </p> <div class='example-contents screen'> <div class='cdata'><pre> Kabul (AFG) Qandahar (AFG) Herat (AFG) </pre></div> </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="mysqli_error" value="<div id='mysqli.error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.error.php'>mysqli-&amp;gt;error</a></h1> <h1 class='refname'>mysqli_error</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;error</span> -- <span class='refname'>mysqli_error</span> &amp;mdash; <span class='dc-title'>Retorna uma string descrevendo o ultimo erro</span></p> </div> <a name='mysqli.error.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Object oriented style (property)</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$error</var>;</div> </div> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_error</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_error()</b> &amp;eacute; identica a fun&amp;ccedil;&amp;atilde;o correspondente <a href='http://www.php.net/manual/pt_BR/mysqli.errno.php' class='function'>mysqli_errno()</a> de todas as maneiras, exceto que ao inv&amp;eacute;s de retornar um c&amp;oacute;digo de erro inteiro, a fun&amp;ccedil;&amp;atilde;o <b>mysqli_error()</b> ir&amp;aacute; retornar uma string representando o ultimo erro que aconteceu na conex&amp;atilde;o com o banco de dados representado pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . Se n&amp;atilde;o houve erro, esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar uma string vazia. </p> </div> <a name='mysqli.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.error.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Uma string que descreve o erro. Uma string vazia se n&amp;atilde;o houve erro. </p> </div> <a name='mysqli.error.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SET&amp;nbsp;a=1'</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'>'Errormessage:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>error</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;a=1'</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'>'Errormessage:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_error</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Errormessage: Unknown system variable &amp;#039;a&amp;#039; </pre></div> </div> </div> <a name='mysqli.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/mysqli.connect-errno.php' class='function' rel='rdfs-seeAlso'>mysqli_connect_errno()</a> - Retorna o c&amp;oacute;digo de erro da ultima chamada a fun&amp;ccedil;&amp;atilde;o connect</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.connect-error.php' class='function' rel='rdfs-seeAlso'>mysqli_connect_error()</a> - Retorna uma string descrevendo o ultimo erro da fun&amp;ccedil;&amp;atilde;o connect</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.errno.php' class='function' rel='rdfs-seeAlso'>mysqli_errno()</a> - Retorna o c&amp;oacute;digo de erro para a chamada de fun&amp;ccedil;&amp;atilde;o mais recente</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php' class='function' rel='rdfs-seeAlso'>mysqli_sqlstate()</a> - Returns the SQLSTATE error from previous MySQL operation</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="mysqli_errno" value="<div id='mysqli.errno' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.errno.php'>mysqli-&amp;gt;errno</a></h1> <h1 class='refname'>mysqli_errno</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;errno</span> -- <span class='refname'>mysqli_errno</span> &amp;mdash; <span class='dc-title'>Retorna o c&amp;oacute;digo de erro para a chamada de fun&amp;ccedil;&amp;atilde;o mais recente</span></p> </div> <a name='mysqli.errno.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (propriedade):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$errno</var>;</div> </div> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_errno</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_errno()</b> ir&amp;aacute; retornar o ultimo c&amp;oacute;digo de erro para a fun&amp;ccedil;&amp;atilde;o mais recente do MySQLi usada que possa ser bem sucedida ou falhar com respeito a conex&amp;atilde;o com o banco de dados definido pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . Se n&amp;atilde;o houveram erros, esta fun&amp;ccedil;&amp;atilde;o retorna zero. </p> <p class='para'> N&amp;uacute;meros de erros das mensagens do cliente s&amp;atilde;o listados no arquivo de cabe&amp;ccedil;alho do MySQL <var class='filename'>errmsg.h</var>, n&amp;uacute;meros de erros das mensagens do servidor s&amp;atilde;o listados em <var class='filename'>mysqld_error.h</var>. Na distribui&amp;ccedil;&amp;atilde;o da fonte do MySQL voc&amp;ecirc; pode encontrar uma lista completa das mensagens de erros no arquivo <var class='filename'>Docs/mysqld_error.txt</var>. </p> </div> <a name='mysqli.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.errno.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um c&amp;oacute;digo de erro para a ultima chamada, se tiver falhado. Zero indica que n&amp;atilde;o houve erro. </p> </div> <a name='mysqli.errno.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SET&amp;nbsp;a=1'</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'>'Errorcode:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>errno</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</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'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;a=1'</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'>'Errorcode:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_errno</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Errorcode: 1193 </pre></div> </div> </div> <a name='mysqli.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/mysqli.connect-errno.php' class='function' rel='rdfs-seeAlso'>mysqli_connect_errno()</a> - Retorna o c&amp;oacute;digo de erro da ultima chamada a fun&amp;ccedil;&amp;atilde;o connect</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.connect-error.php' class='function' rel='rdfs-seeAlso'>mysqli_connect_error()</a> - Retorna uma string descrevendo o ultimo erro da fun&amp;ccedil;&amp;atilde;o connect</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function' rel='rdfs-seeAlso'>mysqli_error()</a> - Retorna uma string descrevendo o ultimo erro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php' class='function' rel='rdfs-seeAlso'>mysqli_sqlstate()</a> - Returns the SQLSTATE error from previous MySQL operation</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="mysqli_enable_rpl_parse" value="<div id='function.mysqli-enable-rpl-parse' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-enable-rpl-parse.php'>mysqli_enable_rpl_parse</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_enable_rpl_parse</span> &amp;mdash; <span class='dc-title'>Habilita an&amp;aacute;lise RPL</span></p> </div> <a name='function.mysqli-enable-rpl-parse.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>mysqli_enable_rpl_parse</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_enable_reads_from_master" value="<div id='function.mysqli-enable-reads-from-master' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-enable-reads-from-master.php'>mysqli_enable_reads_from_master</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_enable_reads_from_master</span> &amp;mdash; <span class='dc-title'>Habilita leitura do master</span></p> </div> <a name='function.mysqli-enable-reads-from-master.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>mysqli_enable_reads_from_master</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_embedded_server_start" value="<div id='mysqli-driver.embedded-server-start' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-driver.embedded-server-start.php'>mysqli_driver::embedded_server_start</a></h1> <h1 class='refname'>mysqli_embedded_server_start</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_driver::embedded_server_start</span> -- <span class='refname'>mysqli_embedded_server_start</span> &amp;mdash; <span class='dc-title'>Initialize and start embedded server</span></p> </div> <a name='mysqli-driver.embedded-server-start.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>mysqli_driver::embedded_server_start</b></span> ( <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$start</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$arguments</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$groups</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_embedded_server_start</b></span> ( <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$start</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$arguments</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$groups</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="mysqli_embedded_server_end" value="<div id='mysqli-driver.embedded-server-end' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-driver.embedded-server-end.php'>mysqli_driver::embedded_server_end</a></h1> <h1 class='refname'>mysqli_embedded_server_end</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_driver::embedded_server_end</span> -- <span class='refname'>mysqli_embedded_server_end</span> &amp;mdash; <span class='dc-title'>Stop embedded server</span></p> </div> <a name='mysqli-driver.embedded-server-end.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>mysqli_driver::embedded_server_end</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>mysqli_embedded_server_end</b></span> ( <span class='methodparam'>void</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="mysqli_dump_debug_info" value="<div id='mysqli.dump-debug-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.dump-debug-info.php'>mysqli::dump_debug_info</a></h1> <h1 class='refname'>mysqli_dump_debug_info</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::dump_debug_info</span> -- <span class='refname'>mysqli_dump_debug_info</span> &amp;mdash; <span class='dc-title'>Descarrega informa&amp;ccedil;&amp;atilde;o de debug no log</span></p> </div> <a name='mysqli.dump-debug-info.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::dump_debug_info</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_dump_debug_info</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o foi criada para ser executada por um usu&amp;aacute;rio com privil&amp;eacute;gio SUPER e &amp;eacute; usada para descaregar informa&amp;ccedil;&amp;otilde;es no log para o servidor MySQL relacionado a conex&amp;atilde;o especificada pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . </p> </div> <a name='mysqli.dump-debug-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.dump-debug-info.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='mysqli.dump-debug-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/mysqli.debug.php' class='function' rel='rdfs-seeAlso'>mysqli_debug()</a> - Realiza opera&amp;ccedil;&amp;otilde;es de debug</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="MySQLi_Driver" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.mysqli-driver.php'>A classe MySQLi_Driver</a></h1> <div class='partintro'> <div id='mysqli-driver.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Driver MySQLi. </p> </div> <div id='mysqli-driver.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>MySQLi_Driver</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>MySQLi_Driver</b> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* M&amp;eacute;todos */</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-driver.embedded-server-end.php' class='function'>mysqli_driver::embedded_server_end</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli-driver.embedded-server-start.php' class='function'>mysqli_driver::embedded_server_start</a></span> ( <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$start</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$arguments</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$groups</tt></span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/mysqli-driver.embedded-server-end.php'>mysqli_driver::embedded_server_end</a> &amp;mdash; Stop embedded server</li><li><a href='http://www.php.net/manual/pt_BR/mysqli-driver.embedded-server-start.php'>mysqli_driver::embedded_server_start</a> &amp;mdash; Initialize and start embedded server</li></ul> </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="mysqli_disable_rpl_parse" value="<div id='function.mysqli-disable-rpl-parse' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-disable-rpl-parse.php'>mysqli_disable_rpl_parse</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_disable_rpl_parse</span> &amp;mdash; <span class='dc-title'>Desabilita an&amp;aacute;lise RPL</span></p> </div> <a name='function.mysqli-disable-rpl-parse.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>mysqli_disable_rpl_parse</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_disable_reads_from_master" value="<div id='function.mysqli-disable-reads-from-master' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mysqli-disable-reads-from-master.php'>mysqli_disable_reads_from_master</a></h1> <h1 class='refname'>mysqli-&amp;gt;disable_reads_from_master()</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_disable_reads_from_master</span> -- <span class='refname'>mysqli-&amp;gt;disable_reads_from_master()</span> &amp;mdash; <span class='dc-title'>Desabilita leitura do master</span></p> </div> <a name='function.mysqli-disable-reads-from-master.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Modo procedural:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_disable_reads_from_master</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'>Modo orientado a objeto (m&amp;eacute;todo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><b>disable_reads_from_master</b></span> ( <span class='methodparam'>void</span> )</div> </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 class='warning'><b class='warning'>Aviso</b> <p class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o tornou-se <em class='emphasis'>OBSOLETA</em> e <em class='emphasis'>REMOVIDA</em> do PHP 5.3.0.</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="mysqli_debug" value="<div id='mysqli.debug' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.debug.php'>mysqli_debug</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_debug</span> &amp;mdash; <span class='dc-title'>Realiza opera&amp;ccedil;&amp;otilde;es de debug</span></p> </div> <a name='mysqli.debug.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 void'>void</span></span> <span class='methodname'><b>mysqli_debug</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$debug</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_debug()</b> &amp;eacute; usada para realizar opera&amp;ccedil;&amp;otilde;es de debug usando a biblioteca de debug Fred Fish. O par&amp;acirc;metro <i><tt class='parameter'>debug</tt></i> &amp;eacute; uma string representando a opera&amp;ccedil;&amp;atilde;o de debug a realizar. </p> <blockquote><p><b class='note'>Nota</b>: Para usar a fun&amp;ccedil;&amp;atilde;o <b>mysqli_debug()</b> voc&amp;ecirc; deve compilar a biblioteca de cliente do MySQL para suportar debug. <br /> </p></blockquote> </div> <a name='mysqli.debug.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'><b>mysqli_debug()</b> n&amp;atilde;o retorna nenhum valor.</p> </div> <a name='mysqli.debug.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli.dump-debug-info.php' class='function'>mysqli_dump_debug_info()</a>, <a href='http://www.php.net/manual/pt_BR/function.mysqli-report.php' class='function'>mysqli_report()</a> </p> </div> <a name='mysqli.debug.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Gerando um arquivo de Trace</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;<br /></span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;trace&amp;nbsp;file&amp;nbsp;in&amp;nbsp;'/tmp/client.trace'&amp;nbsp;on&amp;nbsp;the&amp;nbsp;local&amp;nbsp;(client)&amp;nbsp;machine:&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_debug</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'d:t:0,/tmp/client.trace'</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> </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="mysqli_data_seek" value="<div id='mysqli-result.data-seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli-result.data-seek.php'>mysqli_result::data_seek</a></h1> <h1 class='refname'>mysqli_data_seek</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_result::data_seek</span> -- <span class='refname'>mysqli_data_seek</span> &amp;mdash; <span class='dc-title'>Ajusta o ponteiro do resultado para uma linha arbritaria no conjunto de resutados</span></p> </div> <a name='mysqli-result.data-seek.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objetos (metodo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_result::data_seek</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_data_seek</b></span> ( <span class='methodparam'><span class='type'><span class='type mysqli_result'>mysqli_result</span></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'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_data_seek()</b> move para um resultado arbritario especificado por <i><tt class='parameter'>offset</tt></i> no conjunto de resultados especificado por <i><tt class='parameter'>result</tt></i> . O par&amp;acirc;metro <i><tt class='parameter'>offset</tt></i> deve estar entre zero e o n&amp;uacute;mero total de linhas menos uma (0..<a href='http://www.php.net/manual/pt_BR/mysqli-result.num-rows.php' class='function'>mysqli_num_rows()</a> - 1). </p> </div> <a name='mysqli-result.data-seek.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='mysqli-result.data-seek.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 s&amp;oacute; pode ser usadas para consultas n&amp;atilde;o guardadas em buffer guardadas com o uso de <a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli_store_result()</a> ou <a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli_query()</a>. <br /> </p></blockquote> </div> <a name='mysqli-result.data-seek.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/&amp;nbsp;<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;seek&amp;nbsp;to&amp;nbsp;row&amp;nbsp;no.&amp;nbsp;400&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>data_seek</span><span style='color: #007700'>(</span><span style='color: #0000BB'>399</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;row&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</span><span style='color: #007700'>();<br /><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'>'City:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Countrycode:&amp;nbsp;%s\n'</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: #0000BB'>1</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;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/&amp;nbsp;<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<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;Name,&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;City&amp;nbsp;ORDER&amp;nbsp;BY&amp;nbsp;Name'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$query</span><span style='color: #007700'>))&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;seek&amp;nbsp;to&amp;nbsp;row&amp;nbsp;no.&amp;nbsp;400&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_data_seek</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>399</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;fetch&amp;nbsp;row&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_fetch_row</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><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'>'City:&amp;nbsp;%s&amp;nbsp;&amp;nbsp;Countrycode:&amp;nbsp;%s\n'</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: #0000BB'>1</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;</span><span style='color: #FF8000'>/*&amp;nbsp;free&amp;nbsp;result&amp;nbsp;set*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> City: Benin City Countrycode: NGA </pre></div> </div> </div> <a name='mysqli-result.data-seek.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/mysqli.store-result.php' class='function' rel='rdfs-seeAlso'>mysqli_store_result()</a> - Transfers a result set from the last query</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-row.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_row()</a> - Obt&amp;eacute;m uma linha do resultado como uma matriz numerada</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-array.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_array()</a> - Obtem uma linha do resultado como uma matriz associativa, num&amp;eacute;rica, ou ambas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-assoc.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_assoc()</a> - Obtem uma linha do conjunto de resultados como uma matriz associativa</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.fetch-object.php' class='function' rel='rdfs-seeAlso'>mysqli_fetch_object()</a> - Retorna a linha atual do conjunto de resultados como um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function' rel='rdfs-seeAlso'>mysqli_query()</a> - Performs a query on the database</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli-result.num-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_num_rows()</a> - Gets the number of rows in a 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="mysqli_connect_error" value="<div id='mysqli.connect-error' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.connect-error.php'>mysqli_connect_error</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_connect_error</span> &amp;mdash; <span class='dc-title'>Retorna uma string descrevendo o ultimo erro da fun&amp;ccedil;&amp;atilde;o connect</span></p> </div> <a name='mysqli.connect-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>mysqli_connect_error</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_connect_error()</b> &amp;eacute; identica a fun&amp;ccedil;&amp;atilde;o correspondente <a href='http://www.php.net/manual/pt_BR/mysqli.connect-errno.php' class='function'>mysqli_connect_errno()</a> de todas as maneiras, exceto que ao inv&amp;eacute;s de retornar um n&amp;uacute;mero inteiro como c&amp;oacute;digo de erro, a fun&amp;ccedil;&amp;atilde;o <b>mysqli_connect_error()</b> ir&amp;aacute; retornar uma string representando o ultimo erro que aconteceu com a ultima chamada a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>. Se n&amp;atilde;o houve erro, esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar uma string vazia. </p> </div> <a name='mysqli.connect-error.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'> Uma string que descreve o erro. Uma string vazia se n&amp;atilde;o houve erro. </p> </div> <a name='mysqli.connect-error.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.connect-errno.php' class='function'>mysqli_connect_errno()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.errno.php' class='function'>mysqli_errno()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function'>mysqli_error()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php' class='function'>mysqli_sqlstate()</a> </p> </div> <a name='mysqli.connect-error.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 mysqli_connect_error sample</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'nonexisting_user'</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'>$link</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'>'Can't&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;localhost.&amp;nbsp;Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />}<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="mysqli_connect_errno" value="<div id='mysqli.connect-errno' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.connect-errno.php'>mysqli_connect_errno</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_connect_errno</span> &amp;mdash; <span class='dc-title'>Retorna o c&amp;oacute;digo de erro da ultima chamada a fun&amp;ccedil;&amp;atilde;o connect</span></p> </div> <a name='mysqli.connect-errno.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>mysqli_connect_errno</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_connect_errno()</b> ir&amp;aacute; retornar o n&amp;uacute;mero do c&amp;oacute;digo de erro da ultima chamada a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>. Se n&amp;atilde;o houve erro, esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar zero. </p> <blockquote><p><b class='note'>Nota</b>: As mensagens de erro do cliente s&amp;atilde;o listados no arquivo de cabe&amp;ccedil;alho do MySQL <var class='filename'>errmsg.h</var>, mensagens de erro do servidor s&amp;atilde;o listadas em <var class='filename'>mysqld_error.h</var>. Na distribui&amp;ccedil;&amp;atilde;o da fonte do MySQL voc&amp;ecirc; pode encontrar uma lista completa das mensagens de erro e n&amp;uacute;meros de erro no arquivo <var class='filename'>Docs/mysqld_error.txt</var>. <br /> </p></blockquote> </div> <a name='mysqli.connect-errno.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'> O valor do c&amp;oacute;digo de erro para a ultima chamada a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>, se tiver falhado. Zero indica que n&amp;atilde;o houve erro. </p> </div> <a name='mysqli.connect-errno.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.connect-error.php' class='function'>mysqli_connect_error()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.errno.php' class='function'>mysqli_errno()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function'>mysqli_error()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php' class='function'>mysqli_sqlstate()</a> </p> </div> <a name='mysqli.connect-errno.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Examplo</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 mysqli_connect_errno sample</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'nonexisting_user'</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'>$link</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'>'Can't&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;localhost.&amp;nbsp;Errorcode:&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_errno</span><span style='color: #007700'>());<br />}<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="mysqli_connect" value="<div id='mysqli.connect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.connect.php'>mysqli_connect</a></h1> <h1 class='refname'>mysqli()</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_connect</span> -- <span class='refname'>mysqli()</span> &amp;mdash; <span class='dc-title'>Abre uma nova conex&amp;atilde;o com o servidor MySQL</span></p> </div> <a name='mysqli.connect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento</p> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><b>mysqli_connect</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$host</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'>$passwd</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$port</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$socket</tt></span> ]]]]]] )</div> <p class='para rdfs-comment'>Estilo orientado a objeto (construtor):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='constructorsynopsis dc-description'> <span class='methodname'><b>__construct</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$host</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'>$passwd</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$port</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$socket</tt></span> ]]]]]] )</div> </div> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_connect()</b> tenta abrir uma conex&amp;atilde;o com o servidor MySQL que esteja rodando em <i><tt class='parameter'>host</tt></i> o qual pode ser um nome de servidor ou um endere&amp;ccedil;o IP. Passando <b><tt class='constant'>NULL</tt></b> ou a string &amp;quot;localhost&amp;quot; para este par&amp;acirc;metro, &amp;eacute; assumido o servidor local. Quando poss&amp;iacute;vel, ser&amp;atilde;o usados pipes ao inv&amp;eacute;s do protocolo TCP/IP. Se for bem sucedida, a fun&amp;ccedil;&amp;atilde;o <b>mysqli_connect()</b> ir&amp;aacute; retornar um objeto representando a conex&amp;atilde;o com o banco de dados, ou <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <p class='para'> Os par&amp;acirc;metros <i><tt class='parameter'>username</tt></i> e <i><tt class='parameter'>password</tt></i> especificam o nome de usu&amp;aacute;rio e a senha para usar ao conectar com o servidor MySQL. Se a senha n&amp;atilde;o for dada (&amp;eacute; passado o valor <b><tt class='constant'>NULL</tt></b>), the MySQL server will attempt to authenticate the user against those user records which have no password only. This allows one username to be used with different permissions (depending on if a password as provided or not). </p> <p class='para'> Se for dao o par&amp;acirc;metro <i><tt class='parameter'>dbname</tt></i> , ir&amp;aacute; especificar o banco de dados padr&amp;atilde;o a ser usado ao se executar consultas. </p> <p class='para'> Os par&amp;acirc;metros <i><tt class='parameter'>port</tt></i> e <i><tt class='parameter'>socket</tt></i> s&amp;atilde;o usados em conjunto com o par&amp;acirc;metro <i><tt class='parameter'>host</tt></i> para maior controle de como conectar com o servidor de banc de dados. O par&amp;acirc;metro <i><tt class='parameter'>port</tt></i> especifica o n&amp;uacute;mero da porta a ser usada ao tentar conectar com o servidor MySQL, enquanto o par&amp;acirc;metro <i><tt class='parameter'>socket</tt></i> especifica um socket ou named pipe que deve ser usado. </p> <blockquote><p><b class='note'>Nota</b>: especificar o par&amp;acirc;metro <i><tt class='parameter'>socket</tt></i> n&amp;atilde;o ir&amp;aacute; determinar explicitamente o tipo de conex&amp;atilde;o a ser usada ao conectar com o servidor MySQL. Como a conex&amp;atilde;o &amp;eacute; feita com o banco de dados MySQL &amp;eacute; determinada pelo par&amp;acirc;metro <i><tt class='parameter'>host</tt></i> . <br /> </p></blockquote> </div> <a name='mysqli.connect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</h3> <p class='para'> Retorna um objeto que representa a conex&amp;atilde;o com o servidor MySQL ou <b><tt class='constant'>FALSE</tt></b> se a conex&amp;atilde;o falhar. </p> </div> <a name='mysqli.connect.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Exemplo</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/&amp;nbsp;<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Host&amp;nbsp;information:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>host_info</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/&amp;nbsp;<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Host&amp;nbsp;information:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_get_host_info</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> Os exemplos acimas devem produzir a seguinte sa&amp;iacute;da: </p> <div class='example-contents screen'> <div class='cdata'><pre> Host information: Localhost via UNIX socket </pre></div> </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="mysqli_commit" value="<div id='mysqli.commit' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.commit.php'>mysqli::commit</a></h1> <h1 class='refname'>mysqli_commit</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::commit</span> -- <span class='refname'>mysqli_commit</span> &amp;mdash; <span class='dc-title'>Salva a transa&amp;ccedil;&amp;atilde;o atual</span></p> </div> <a name='mysqli.commit.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo)</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::commit</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_commit</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Grava a transa&amp;ccedil;&amp;atilde;o atual para a conex&amp;atilde;o com o banco de dados especificada pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . </p> </div> <a name='mysqli.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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.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='mysqli.commit.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;Language&amp;nbsp;LIKE&amp;nbsp;CountryLanguage&amp;nbsp;Type=InnoDB'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;set&amp;nbsp;autocommit&amp;nbsp;to&amp;nbsp;off&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>FALSE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Insert&amp;nbsp;some&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;Language&amp;nbsp;VALUES&amp;nbsp;('DEU',&amp;nbsp;'Bavarian',&amp;nbsp;'F',&amp;nbsp;11.2)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;Language&amp;nbsp;VALUES&amp;nbsp;('DEU',&amp;nbsp;'Swabian',&amp;nbsp;'F',&amp;nbsp;9.4)'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;commit&amp;nbsp;transaction&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>commit</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;drop&amp;nbsp;table&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;Language'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;set&amp;nbsp;autocommit&amp;nbsp;to&amp;nbsp;off&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>FALSE</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;Language&amp;nbsp;LIKE&amp;nbsp;CountryLanguage&amp;nbsp;Type=InnoDB'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Insert&amp;nbsp;some&amp;nbsp;values&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;Language&amp;nbsp;VALUES&amp;nbsp;('DEU',&amp;nbsp;'Bavarian',&amp;nbsp;'F',&amp;nbsp;11.2)'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'INSERT&amp;nbsp;INTO&amp;nbsp;Language&amp;nbsp;VALUES&amp;nbsp;('DEU',&amp;nbsp;'Swabian',&amp;nbsp;'F',&amp;nbsp;9.4)'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;commit&amp;nbsp;transaction&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_commit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='mysqli.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/mysqli.autocommit.php' class='function' rel='rdfs-seeAlso'>mysqli_autocommit()</a> - Ativa ou desativa o salvar automaticamente as modifica&amp;ccedil;&amp;otilde;es no banco de dados</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.rollback.php' class='function' rel='rdfs-seeAlso'>mysqli_rollback()</a> - Rolls back current 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="mysqli_close" value="<div id='mysqli.close' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.close.php'>mysqli_close</a></h1> <h1 class='refname'>mysqli-&amp;gt;close</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli_close</span> -- <span class='refname'>mysqli-&amp;gt;close</span> &amp;mdash; <span class='dc-title'>Fecha uma conex&amp;atilde;o aberta anteriormente com o banco de dados</span></p> </div> <a name='mysqli.close.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_close</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'>Estilo orientado a objeto (metodo):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>close</b></span> ( <span class='methodparam'>void</span> )</div> </div> <p class='para'> A fun&amp;ccedil;&amp;atilde;o <b>mysqli_close()</b> fecha uma conex&amp;atilde;o com um banco de dados aberto anteriormente especificado pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . </p> </div> <a name='mysqli.close.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Valores de retorno</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='mysqli.close.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Veja tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a>, <a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli_real_connect()</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="mysqli_character_set_name" value="<div id='mysqli.character-set-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.character-set-name.php'>mysqli::character_set_name</a></h1> <h1 class='refname'>mysqli_character_set_name</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::character_set_name</span> -- <span class='refname'>mysqli_character_set_name</span> &amp;mdash; <span class='dc-title'>Retorna o conjunto de caracteres padr&amp;atilde;o para a conex&amp;atilde;o com o banco de dados</span></p> </div> <a name='mysqli.character-set-name.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto(metodo)</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli::character_set_name</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><b>mysqli_character_set_name</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> Retorna o conjunto de caracteres para a conex&amp;atilde;o com o banco de dados especificada pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> . </p> </div> <a name='mysqli.character-set-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.character-set-name.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'>O conjunto de caracteres padr&amp;atilde;o para a conex&amp;atilde;o atual</p> </div> <a name='mysqli.character-set-name.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</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;&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 /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Print&amp;nbsp;current&amp;nbsp;character&amp;nbsp;set&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$charset&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>character_set_name</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Current&amp;nbsp;character&amp;nbsp;set&amp;nbsp;is&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$charset</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</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;Open&amp;nbsp;a&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</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;&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 /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Print&amp;nbsp;current&amp;nbsp;character&amp;nbsp;set&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$charset&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_character_set_name</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Current&amp;nbsp;character&amp;nbsp;set&amp;nbsp;is&amp;nbsp;%s\n'</span><span style='color: #007700'>,</span><span style='color: #0000BB'>$charset</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Current character set is latin1_swedish_ci </pre></div> </div> </div> <a name='mysqli.character-set-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.mysqli-client-encoding.php' class='function' rel='rdfs-seeAlso'>mysqli_client_encoding()</a> - Apelido para mysqli_character_set_name</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.real-escape-string.php' class='function' rel='rdfs-seeAlso'>mysqli_real_escape_string()</a> - Escapes special characters in a string for use in a SQL statement, taking into account the current charset of the connection</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="mysqli_change_user" value="<div id='mysqli.change-user' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.change-user.php'>mysqli::change_user</a></h1> <h1 class='refname'>mysqli_change_user</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::change_user</span> -- <span class='refname'>mysqli_change_user</span> &amp;mdash; <span class='dc-title'>Modifica o usu&amp;aacute;rio para a conex&amp;atilde;o com o banco de dados especificada</span></p> </div> <a name='mysqli.change-user.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto (metodo):</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::change_user</b></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'>string</span> <tt class='parameter'>$database</tt></span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_change_user</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</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'>string</span> <tt class='parameter'>$database</tt></span> )</div> <p class='para rdfs-comment'> <b>mysqli_change_user()</b> &amp;eacute; usado para mudar o usu&amp;aacute;rio na conex&amp;atilde;o com o banco de dados especificado como indicado pelo par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> e definido para o banco de dados atual para o especificado pelo par&amp;acirc;metro <i><tt class='parameter'>database</tt></i> . </p> <p class='para'> Se desejado, o valor <b><tt class='constant'>NULL</tt></b> pode ser passado no lugar do par&amp;acirc;metro <i><tt class='parameter'>database</tt></i> fazendo com que seja apenas mudado o usu&amp;aacute;rio e n&amp;atilde;o seja escolhido tamb&amp;eacute;m um banco de dados. Para escolher um banco de dados neste caso, use a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/mysqli.select-db.php' class='function'>mysqli_select_db()</a>. </p> <p class='para'> Para poder mudar usu&amp;aacute;rios de maneira correta, os par&amp;acirc;metors <i><tt class='parameter'>username</tt></i> e <i><tt class='parameter'>password</tt></i> devem ser v&amp;aacute;lidos e este usu&amp;aacute;rio deve ter permiss&amp;otilde;es suficinte para acessar o banco de dados desejado. Se por alguma raz&amp;atilde;o a autentica&amp;ccedil;&amp;atilde;o falhar, o usu&amp;aacute;rio atualmente autenticado ir&amp;aacute; permanecer. </p> </div> <a name='mysqli.change-user.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='mysqli.change-user.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Usar este comando far&amp;aacute; sempre que a conex&amp;atilde;o atual com o banco de dados funcione como se fosse completamente uma nova conex&amp;atilde;o, n&amp;atilde;o importando se a opera&amp;ccedil;&amp;atilde;o foi completada de maneira correta. Este re&amp;iacute;nicio inclu&amp;iacute; desfazer quaisquer transa&amp;ccedil;&amp;otilde;es ativas, fechar todas as tabelas temporarias e destravar todas as tabelas travadas. <br /> </p></blockquote> </div> <a name='mysqli.change-user.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objetos</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;connect&amp;nbsp;database&amp;nbsp;test&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Set&amp;nbsp;Variable&amp;nbsp;a&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SET&amp;nbsp;@a:=1'</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;&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 /></span><span style='color: #FF8000'>/*&amp;nbsp;reset&amp;nbsp;all&amp;nbsp;and&amp;nbsp;select&amp;nbsp;a&amp;nbsp;new&amp;nbsp;database&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>change_user</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;DATABASE()'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>'Default&amp;nbsp;database:&amp;nbsp;%s\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;@a'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&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;===&amp;nbsp;</span><span style='color: #0000BB'>NULL</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Value&amp;nbsp;of&amp;nbsp;variable&amp;nbsp;a&amp;nbsp;is&amp;nbsp;NULL\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'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimentos</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;database&amp;nbsp;test&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'test'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Set&amp;nbsp;Variable&amp;nbsp;a&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SET&amp;nbsp;@a:=1'</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;&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 /></span><span style='color: #FF8000'>/*&amp;nbsp;reset&amp;nbsp;all&amp;nbsp;and&amp;nbsp;select&amp;nbsp;a&amp;nbsp;new&amp;nbsp;database&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_change_user</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;DATABASE()'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Default&amp;nbsp;database:&amp;nbsp;%s\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;@a'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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;if&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;===&amp;nbsp;</span><span style='color: #0000BB'>NULL</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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Value&amp;nbsp;of&amp;nbsp;variable&amp;nbsp;a&amp;nbsp;is&amp;nbsp;NULL\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'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Default database: world Value of variable a is NULL </pre></div> </div> </div> <a name='mysqli.change-user.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/mysqli.connect.php' class='function' rel='rdfs-seeAlso'>mysqli_connect()</a> - Abre uma nova conex&amp;atilde;o com o servidor MySQL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.select-db.php' class='function' rel='rdfs-seeAlso'>mysqli_select_db()</a> - Selects the default database for database queries</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="mysqli_autocommit" value="<div id='mysqli.autocommit' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.autocommit.php'>mysqli::autocommit</a></h1> <h1 class='refname'>mysqli_autocommit</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli::autocommit</span> -- <span class='refname'>mysqli_autocommit</span> &amp;mdash; <span class='dc-title'>Ativa ou desativa o salvar automaticamente as modifica&amp;ccedil;&amp;otilde;es no banco de dados</span></p> </div> <a name='mysqli.autocommit.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objeto(metodo)</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli::autocommit</b></span> ( <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$mode</tt></span> )</div> <p class='para rdfs-comment'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>mysqli_autocommit</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$mode</tt></span> )</div> <p class='para rdfs-comment'> <b>mysqli_autocommit()</b> &amp;eacute; usado para ativar ou desativar o modo de salvar automaticamente as consultas para a conex&amp;atilde;o com o banco dedados representado por <i><tt class='parameter'>link</tt></i> . object. </p> <blockquote><p><b class='note'>Nota</b>: Para determinar o estado do salvar automaticamente use o comando SQL &amp;#039;SELECT @@autocommit&amp;#039;. <br /> </p></blockquote> </div> <a name='mysqli.autocommit.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='mysqli.autocommit.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>mysqli_autocommit()</b> N&amp;atilde;o funciona com tabelas de tipos n&amp;atilde;o baseadas em transa&amp;ccedil;&amp;otilde;es (como MyISAM ou ISAM). <br /> </p></blockquote> </div> <a name='mysqli.autocommit.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;turn&amp;nbsp;autocommit&amp;nbsp;on&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>TRUE</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;@@autocommit'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>fetch_row</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'>'Autocommit&amp;nbsp;is&amp;nbsp;%s\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>free</span><span style='color: #007700'>();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Can't&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;localhost.&amp;nbsp;Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;turn&amp;nbsp;autocommit&amp;nbsp;on&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_autocommit</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>TRUE</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;@@autocommit'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$row&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_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'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Autocommit&amp;nbsp;is&amp;nbsp;%s\n'</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'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Autocommit is 1 </pre></div> </div> </div> <a name='mysqli.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/mysqli.commit.php' class='function' rel='rdfs-seeAlso'>mysqli_commit()</a> - Salva a transa&amp;ccedil;&amp;atilde;o atual</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.rollback.php' class='function' rel='rdfs-seeAlso'>mysqli_rollback()</a> - Rolls back current 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="mysqli_affected_rows" value="<div id='mysqli.affected-rows' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/mysqli.affected-rows.php'>mysqli-&amp;gt;affected_rows</a></h1> <h1 class='refname'>mysqli_affected_rows</h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mysqli-&amp;gt;affected_rows</span> -- <span class='refname'>mysqli_affected_rows</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero de linhas afetadas pela opera&amp;ccedil;&amp;atilde;o MySQL anterior</span></p> </div> <a name='mysqli.affected-rows.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='para'>Estilo orientado a objetos (propriedades):</p> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>mysqli</b></div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$affected_rows</var>;</div> </div> <p class='para'>Estilo de procedimento:</p> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mysqli_affected_rows</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <p class='para rdfs-comment'> <b>mysqli_affected_rows()</b> retorna o n&amp;uacute;mero de linhas afetadas pela ultima consulta <i>INSERT</i>, <i>UPDATE</i>, <i>REPLACE</i> ou <i>DELETE</i> associada ao par&amp;acirc;metro <i><tt class='parameter'>link</tt></i> indicado. Se a ultima consulta foi invalida, esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retornar -1. </p> <p class='para'> Para comandos SELECT <b>mysqli_affected_rows()</b> funciona como <a href='http://www.php.net/manual/pt_BR/mysqli-result.num-rows.php' class='function'>mysqli_num_rows()</a>. </p> </div> <a name='mysqli.affected-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'> link</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Apenas para estilo de procedimento: Um identificador de conex&amp;atilde;o retornado por <a href='http://www.php.net/manual/pt_BR/mysqli.connect.php' class='function'>mysqli_connect()</a> or <a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init()</a> </p></dd> </dl> <p> </p> </div> <a name='mysqli.affected-rows.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um inteiro maior do que zero indica o n&amp;uacute;mero de linhas afetadas ou obtidas. Zero indica que nenhum registro foi atualizado por um UPDATE, n&amp;atilde;o foram encontradas linhas em uma cla&amp;uacute;sula <i>WHERE</i> na consulta ou que a consulta ainda n&amp;atilde;o foi executada. -1 indica que a consulta retornou com erro. </p> <blockquote><p><b class='note'>Nota</b>: Se o n&amp;uacute;mero de linhas afetadas for maior do que o maior valor inteiro poss&amp;iacute;vel, o n&amp;uacute;mero de linhas afetadas ser&amp;aacute; retornado como uma string. <br /> </p></blockquote> </div> <a name='mysqli.affected-rows.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Estilo orientado a objeto</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$mysqli&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>mysqli</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;check&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>mysqli_connect_errno</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'>'Connect&amp;nbsp;failed:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Insert&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;Language&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;from&amp;nbsp;CountryLanguage'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(INSERT):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'ALTER&amp;nbsp;TABLE&amp;nbsp;Language&amp;nbsp;ADD&amp;nbsp;Status&amp;nbsp;int&amp;nbsp;default&amp;nbsp;0'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;update&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'UPDATE&amp;nbsp;Language&amp;nbsp;SET&amp;nbsp;Status=1&amp;nbsp;WHERE&amp;nbsp;Percentage&amp;nbsp;&amp;gt;&amp;nbsp;50'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(UPDATE):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;delete&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;Language&amp;nbsp;WHERE&amp;nbsp;Percentage&amp;nbsp;&amp;lt;&amp;nbsp;50'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(DELETE):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;select&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'SELECT&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;Language'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(SELECT):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>affected_rows</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$result</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Delete&amp;nbsp;table&amp;nbsp;Language&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>query</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;Language'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$mysqli</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>close</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 Estilo de procedimento</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'my_password'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'world'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(!</span><span style='color: #0000BB'>$link</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'>'Can't&amp;nbsp;connect&amp;nbsp;to&amp;nbsp;localhost.&amp;nbsp;Error:&amp;nbsp;%s\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_connect_error</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit();<br />}<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Insert&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'CREATE&amp;nbsp;TABLE&amp;nbsp;Language&amp;nbsp;SELECT&amp;nbsp;*&amp;nbsp;from&amp;nbsp;CountryLanguage'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(INSERT):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ALTER&amp;nbsp;TABLE&amp;nbsp;Language&amp;nbsp;ADD&amp;nbsp;Status&amp;nbsp;int&amp;nbsp;default&amp;nbsp;0'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;update&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'UPDATE&amp;nbsp;Language&amp;nbsp;SET&amp;nbsp;Status=1&amp;nbsp;WHERE&amp;nbsp;Percentage&amp;nbsp;&amp;gt;&amp;nbsp;50'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(UPDATE):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;delete&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DELETE&amp;nbsp;FROM&amp;nbsp;Language&amp;nbsp;WHERE&amp;nbsp;Percentage&amp;nbsp;&amp;lt;&amp;nbsp;50'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(DELETE):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;select&amp;nbsp;all&amp;nbsp;rows&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$result&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SELECT&amp;nbsp;CountryCode&amp;nbsp;FROM&amp;nbsp;Language'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>printf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Affected&amp;nbsp;rows&amp;nbsp;(SELECT):&amp;nbsp;%d\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mysqli_affected_rows</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>mysqli_free_result</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$result</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Delete&amp;nbsp;table&amp;nbsp;Language&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'DROP&amp;nbsp;TABLE&amp;nbsp;Language'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;close&amp;nbsp;connection&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mysqli_close</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$link</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'>O exemplo acima ir&amp;aacute; imprimir:</p> <div class='example-contents screen'> <div class='cdata'><pre> Affected rows (INSERT): 984 Affected rows (UPDATE): 168 Affected rows (DELETE): 815 Affected rows (SELECT): 169 </pre></div> </div> </div> <a name='mysqli.affected-rows.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/mysqli-result.num-rows.php' class='function' rel='rdfs-seeAlso'>mysqli_num_rows()</a> - Gets the number of rows in a result</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/mysqli.info.php' class='function' rel='rdfs-seeAlso'>mysqli_info()</a> - Recupera informa&amp;ccedil;&amp;atilde;o sobre a mais recente query executada</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="MySQLi" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.mysqli.php'>A classe MySQLi</a></h1> <div class='partintro'> <div id='mysqli.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Representa uma conex&amp;atilde;o entre o PHP e um banco de dados MySQL. </p> </div> <div id='mysqli.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>MySQLi</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>MySQLi</b> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Propriedades */</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$affected_rows</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$client_info</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$client_version</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$errno</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$error</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$host_info</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$protocol_version</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$server_info</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$server_version</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$info</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$insert_id</var>;</div> <div class='fieldsynopsis'><span class='type'>string</span> <var class='varname'>$sqlstate</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$thread_id</var>;</div> <div class='fieldsynopsis'><span class='type'>int</span> <var class='varname'>$warning_count</var>;</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* M&amp;eacute;todos */</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.affected-rows.php' class='function'>mysqli_affected_rows</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.autocommit.php' class='function'>mysqli::autocommit</a></span> ( <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$mode</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.change-user.php' class='function'>mysqli::change_user</a></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'>string</span> <tt class='parameter'>$database</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.character-set-name.php' class='function'>mysqli::character_set_name</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-info.php' class='function'>mysqli_get_client_info</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-version.php' class='function'>mysqli_get_client_version</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.commit.php' class='function'>mysqli::commit</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.dump-debug-info.php' class='function'>mysqli::dump_debug_info</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.errno.php' class='function'>mysqli_errno</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.error.php' class='function'>mysqli_error</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-cache-stats.php' class='function'>mysqli::get_cache_stats</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-charset.php' class='function'>mysqli::get_charset</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-info.php' class='function'>mysqli::get_client_info</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-stats.php' class='function'>mysqli::get_client_stats</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-version.php' class='function'>mysqli::get_client_version</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-connection-stats.php' class='function'>mysqli::get_connection_stats</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-host-info.php' class='function'>mysqli_get_host_info</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-proto-info.php' class='function'>mysqli_get_proto_info</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-info.php' class='function'>mysqli_get_server_info</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-version.php' class='function'>mysqli_get_server_version</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>object</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.get-warnings.php' class='function'>mysqli::get_warnings</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.info.php' class='function'>mysqli_info</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.init.php' class='function'>mysqli_init</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.insert-id.php' class='function'>mysqli_insert_id</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.kill.php' class='function'>mysqli::kill</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$processid</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.more-results.php' class='function'>mysqli::more_results</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php' class='function'>mysqli::multi_query</a></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'><a href='http://www.php.net/manual/pt_BR/mysqli.next-result.php' class='function'>mysqli::next_result</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.options.php' class='function'>mysqli::options</a></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'>$value</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.ping.php' class='function'>mysqli::ping</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.poll.php' class='function'>mysqli::poll</a></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$read</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$error</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$reject</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$sec</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$usec</tt></span> ] )</div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli_stmt</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php' class='function'>mysqli::prepare</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.query.php' class='function'>mysqli::query</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$resultmode</tt></span> ] )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php' class='function'>mysqli::real_connect</a></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$host</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'>$passwd</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$port</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$socket</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$flags</tt></span> ]]]]]]] )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/function.mysqli-escape-string.php' class='function'>mysqli::escape_string</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$escapestr</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.real-query.php' class='function'>mysqli::real_query</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$query</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>mysqli_result</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.reap-async-query.php' class='function'>mysqli::reap_async_query</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.rollback.php' class='function'>mysqli::rollback</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.select-db.php' class='function'>mysqli::select_db</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$dbname</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.set-charset.php' class='function'>mysqli::set_charset</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.set-local-infile-default.php' class='function'>mysqli_set_local_infile_default</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.set-local-infile-handler.php' class='function'>mysqli_set_local_infile_handler</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.callback' class='type callback'>callback</a></span> <tt class='parameter'>$read_func</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php' class='function'>mysqli_sqlstate</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.ssl-set.php' class='function'>mysqli::ssl_set</a></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$key</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$cert</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$ca</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$capath</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$cipher</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.stat.php' class='function'>mysqli::stat</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli_stmt</span> <span class='methodname'><b>stmt_init</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli_result</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php' class='function'>mysqli::store_result</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.thread-id.php' class='function'>mysqli_thread_id</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.thread-safe.php' class='function'>mysqli_thread_safe</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>mysqli_result</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php' class='function'>mysqli::use_result</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/mysqli.warning-count.php' class='function'>mysqli_warning_count</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.mysqli.php' class='type mysqli'>mysqli</a></span> <tt class='parameter'>$link</tt></span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/mysqli.affected-rows.php'>mysqli->affected_rows</a> &amp;mdash; Retorna o n&amp;uacute;mero de linhas afetadas pela opera&amp;ccedil;&amp;atilde;o MySQL anterior</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.autocommit.php'>mysqli::autocommit</a> &amp;mdash; Ativa ou desativa o salvar automaticamente as modifica&amp;ccedil;&amp;otilde;es no banco de dados</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.change-user.php'>mysqli::change_user</a> &amp;mdash; Modifica o usu&amp;aacute;rio para a conex&amp;atilde;o com o banco de dados especificada</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.character-set-name.php'>mysqli::character_set_name</a> &amp;mdash; Retorna o conjunto de caracteres padr&amp;atilde;o para a conex&amp;atilde;o com o banco de dados</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.client-info.php'>mysqli->client_info</a> &amp;mdash; Returns the MySQL client version as a string</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.client-version.php'>mysqli->client_version</a> &amp;mdash; Get MySQL client info</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.close.php'>mysqli_close</a> &amp;mdash; Fecha uma conex&amp;atilde;o aberta anteriormente com o banco de dados</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.commit.php'>mysqli::commit</a> &amp;mdash; Salva a transa&amp;ccedil;&amp;atilde;o atual</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.connect-errno.php'>mysqli_connect_errno</a> &amp;mdash; Retorna o c&amp;oacute;digo de erro da ultima chamada a fun&amp;ccedil;&amp;atilde;o connect</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.connect-error.php'>mysqli_connect_error</a> &amp;mdash; Retorna uma string descrevendo o ultimo erro da fun&amp;ccedil;&amp;atilde;o connect</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.connect.php'>mysqli_connect</a> &amp;mdash; Abre uma nova conex&amp;atilde;o com o servidor MySQL</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.debug.php'>mysqli_debug</a> &amp;mdash; Realiza opera&amp;ccedil;&amp;otilde;es de debug</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.dump-debug-info.php'>mysqli::dump_debug_info</a> &amp;mdash; Descarrega informa&amp;ccedil;&amp;atilde;o de debug no log</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.errno.php'>mysqli->errno</a> &amp;mdash; Retorna o c&amp;oacute;digo de erro para a chamada de fun&amp;ccedil;&amp;atilde;o mais recente</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.error.php'>mysqli->error</a> &amp;mdash; Retorna uma string descrevendo o ultimo erro</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.field-count.php'>mysqli_field_count</a> &amp;mdash; Retorna o n&amp;uacute;mero de colunas para a consulta mais recente</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-cache-stats.php'>mysqli::get_cache_stats</a> &amp;mdash; Returns client Zval cache statistics</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-charset.php'>mysqli::get_charset</a> &amp;mdash; Returns a character set object</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-info.php'>mysqli::get_client_info</a> &amp;mdash; Retorna a vers&amp;atilde;o do cliente MySQL como uma string</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-stats.php'>mysqli::get_client_stats</a> &amp;mdash; Returns client per-process statistics</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-client-version.php'>mysqli::get_client_version</a> &amp;mdash; Obt&amp;eacute;m informa&amp;ccedil;&amp;atilde;o sobre o cliente MySQL</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-connection-stats.php'>mysqli::get_connection_stats</a> &amp;mdash; Returns statistics about the client connection</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-host-info.php'>mysqli_get_host_info</a> &amp;mdash; Retorna uma string representando o tipo da conex&amp;atilde;o usada</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-proto-info.php'>mysqli->protocol_version</a> &amp;mdash; Retorna a vers&amp;atilde;o do protocolo MySQL usada</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-info.php'>mysqli->server_info</a> &amp;mdash; Retorna a vers&amp;atilde;o do servidor MySQL</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-server-version.php'>mysqli->server_version</a> &amp;mdash; Retorna a vers&amp;atilde;o do servidor MySQL como um integer</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.get-warnings.php'>mysqli::get_warnings</a> &amp;mdash; Get result of SHOW WARNINGS</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.info.php'>mysqli_info</a> &amp;mdash; Recupera informa&amp;ccedil;&amp;atilde;o sobre a mais recente query executada</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.init.php'>mysqli_init</a> &amp;mdash; Inicializa a MySQLi e retorna um resource para usar com mysqli_real_connect()</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.insert-id.php'>mysqli_insert_id</a> &amp;mdash; Retorna o id gerado automaticamente na &amp;uacute;ltima consulta</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.kill.php'>mysqli::kill</a> &amp;mdash; Solicita ao servidor o encerramento de um thread do MySQL</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.more-results.php'>mysqli::more_results</a> &amp;mdash; Verifica se h&amp;aacute; mais algum resultado de uma multi query</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.multi-query.php'>mysqli::multi_query</a> &amp;mdash; Performs a query on the database</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.next-result.php'>mysqli::next_result</a> &amp;mdash; Prepara o pr&amp;oacute;ximo resultado de multi_query</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.options.php'>mysqli::options</a> &amp;mdash; Set options</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.ping.php'>mysqli::ping</a> &amp;mdash; Pings a server connection, or tries to reconnect if the connection has gone down</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.poll.php'>mysqli::poll</a> &amp;mdash; Poll connections</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.prepare.php'>mysqli::prepare</a> &amp;mdash; Prepare a SQL statement for execution</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.query.php'>mysqli::query</a> &amp;mdash; Performs a query on the database</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.real-connect.php'>mysqli::real_connect</a> &amp;mdash; Opens a connection to a mysql server</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.real-escape-string.php'>mysqli::real_escape_string</a> &amp;mdash; Escapes special characters in a string for use in a SQL statement, taking into account the current charset of the connection</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.real-query.php'>mysqli::real_query</a> &amp;mdash; Execute an SQL query</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.reap-async-query.php'>mysqli::reap_async_query</a> &amp;mdash; Get result from async query</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.rollback.php'>mysqli::rollback</a> &amp;mdash; Rolls back current transaction</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.select-db.php'>mysqli::select_db</a> &amp;mdash; Selects the default database for database queries</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.set-charset.php'>mysqli::set_charset</a> &amp;mdash; Sets the default client character set</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.set-local-infile-default.php'>mysqli::set_local_infile_default</a> &amp;mdash; Unsets user defined handler for load local infile command</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.set-local-infile-handler.php'>mysqli::set_local_infile_handler</a> &amp;mdash; Set callback function for LOAD DATA LOCAL INFILE command</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.sqlstate.php'>mysqli->sqlstate</a> &amp;mdash; Returns the SQLSTATE error from previous MySQL operation</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.ssl-set.php'>mysqli::ssl_set</a> &amp;mdash; Used for establishing secure connections using SSL</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.stat.php'>mysqli::stat</a> &amp;mdash; Gets the current system status</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.stmt-init.php'>mysqli::stmt_init</a> &amp;mdash; Initializes a statement and returns an object for use with mysqli_stmt_prepare</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.store-result.php'>mysqli::store_result</a> &amp;mdash; Transfers a result set from the last query</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.thread-id.php'>mysqli::thread_id</a> &amp;mdash; Returns the thread ID for the current connection</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.thread-safe.php'>mysqli::thread_safe</a> &amp;mdash; Returns whether thread safety is given or not</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.use-result.php'>mysqli::use_result</a> &amp;mdash; Initiate a result set retrieval</li><li><a href='http://www.php.net/manual/pt_BR/mysqli.warning-count.php'>mysqli::warning_count</a> &amp;mdash; Returns the number of warnings from the last query for the given link</li></ul> </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="mt_srand" value="<div id='function.mt-srand' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mt-srand.php'>mt_srand</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mt_srand</span> &amp;mdash; <span class='dc-title'>Semeia o gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</span></p> </div> <a name='function.mt-srand.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>mt_srand</b></span> ([ <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$seed</tt></span> ] )</div> <p class='para rdfs-comment'> Semeia o gerador de n&amp;uacute;meros aleat&amp;oacute;rios com <i><tt class='parameter'>seed</tt></i> ou com um valor aleat&amp;oacute;rio se nenhum <i><tt class='parameter'>seed</tt></i> &amp;eacute; dado. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>A partir do PHP 4.2.0, n&amp;atilde;o &amp;eacute; mais necess&amp;aacute;rio semear o gerador de n&amp;uacute;meros aleat&amp;oacute;rios com <a href='http://www.php.net/manual/pt_BR/function.srand.php' class='function'>srand()</a> ou <b>mt_srand()</b> pois isso &amp;eacute; feito automaticamente. </span></p></blockquote> </div> <a name='function.mt-srand.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'>seed</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O opcional valor de seed </p> </dd> </dl> <p> </p> </div> <a name='function.mt-srand.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'>Desde 4.2.0</td> <td align='left'> O <i><tt class='parameter'>seed</tt></i> tornou-se opcional e padr&amp;atilde;o para um valor aleat&amp;oacute;rio se omitido. </td> </tr> <tr valign='middle'> <td align='left'>Desde 5.2.1</td> <td align='left'> A implementa&amp;ccedil;&amp;atilde;o Mersenne Twister em PHP agora sua um novo algoritmo de seeding por Richard Wagner. Id&amp;ecirc;nticos seeds n&amp;atilde;o produzem a mesma seq&amp;uuml;&amp;ecirc;ncia de valores que tinham em vers&amp;otilde;es anteriores. Este comportamento n&amp;atilde;o &amp;eacute; esperado que seja modificado, mas &amp;eacute; considerado n&amp;atilde;o seguro confiar nele. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mt-srand.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>mt_srand()</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;semente&amp;nbsp;de&amp;nbsp;microsegundos<br /></span><span style='color: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>make_seed</span><span style='color: #007700'>()<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;list(</span><span style='color: #0000BB'>$usec</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sec</span><span style='color: #007700'>)&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>explode</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>microtime</span><span style='color: #007700'>());<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;(float)&amp;nbsp;</span><span style='color: #0000BB'>$sec&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;((float)&amp;nbsp;</span><span style='color: #0000BB'>$usec&amp;nbsp;</span><span style='color: #007700'>*&amp;nbsp;</span><span style='color: #0000BB'>100000</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>mt_srand</span><span style='color: #007700'>(</span><span style='color: #0000BB'>make_seed</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>$randval&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mt_rand</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.mt-srand.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.mt-rand.php' class='function' rel='rdfs-seeAlso'>mt_rand()</a> - Gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mt-getrandmax.php' class='function' rel='rdfs-seeAlso'>mt_getrandmax()</a> - Retorna o maior valor alet&amp;oacute;rio poss&amp;iacute;vel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.srand.php' class='function' rel='rdfs-seeAlso'>srand()</a> - Semeia o gerador de n&amp;uacute;meros alet&amp;oacute;rios</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="mt_rand" value="<div id='function.mt-rand' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mt-rand.php'>mt_rand</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mt_rand</span> &amp;mdash; <span class='dc-title'>Gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</span></p> </div> <a name='function.mt-rand.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>mt_rand</b></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>mt_rand</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$min</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$max</tt></span> )</div> <p class='simpara'> Muitos geradores de n&amp;uacute;meros aleat&amp;oacute;rios das libcs antigas s&amp;atilde;o duvidosos ou com caracter&amp;iacute;sticas duvidosas e lentos. Por default, o PHP utiliza o gerador de n&amp;uacute;meros aleat&amp;oacute;rios da libc para a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.rand.php' class='function'>rand()</a>. A fun&amp;ccedil;&amp;atilde;o <b>mt_rand()</b> &amp;eacute; um bom substituto para a primeira. Ela utiliza um gerador de n&amp;uacute;meros aleat&amp;oacute;rios com caracter&amp;iacute;sticas conhecidas, o <a href='http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html' class='link external'>&amp;raquo; Mersenne Twister</a>, que produzir&amp;aacute; n&amp;uacute;meros rand&amp;ocirc;micos quatro vezes mais r&amp;aacute;pido que m&amp;eacute;dia provida pela rand() da libc. </p> <p class='simpara'> Se chamada sem os argumentos opcionais <i><tt class='parameter'>min</tt></i> e <i><tt class='parameter'>max</tt></i> , <b>mt_rand()</b> retorna um pseudo n&amp;uacute;mero alet&amp;oacute;rio enrte 0 e <a href='http://www.php.net/manual/pt_BR/function.mt-getrandmax.php' class='function'>mt_getrandmax()</a>. se voc&amp;ecirc; precisa de um n&amp;uacute;mero rand&amp;ocirc;mico entre 5 e 15 (inclusive), por exemplo, utilize <i>mt_rand (5, 15)</i>. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>A partir do PHP 4.2.0, n&amp;atilde;o &amp;eacute; mais necess&amp;aacute;rio semear o gerador de n&amp;uacute;meros aleat&amp;oacute;rios com <a href='http://www.php.net/manual/pt_BR/function.srand.php' class='function'>srand()</a> ou <a href='http://www.php.net/manual/pt_BR/function.mt-srand.php' class='function'>mt_srand()</a> pois isso &amp;eacute; feito automaticamente. </span></p></blockquote> </div> <a name='function.mt-rand.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'>min</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Menor valor opcional para ser retornado (padr&amp;atilde;o: 0) </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>max</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Maior valor opcional para ser retornado (padr&amp;atilde;o: <a href='http://www.php.net/manual/pt_BR/function.mt-getrandmax.php' class='function'>mt_getrandmax()</a>) </p> </dd> </dl> <p> </p> </div> <a name='function.mt-rand.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um valor inteiro entre <i><tt class='parameter'>min</tt></i> (ou 0) e <i><tt class='parameter'>max</tt></i> (ou <a href='http://www.php.net/manual/pt_BR/function.mt-getrandmax.php' class='function'>mt_getrandmax()</a>, inclusive) </p> </div> <a name='function.mt-rand.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'>Desde o 3.0.7</td> <td align='left'> Em vers&amp;otilde;es anteriores a 3.0.7, o significado do par&amp;acirc;metro <i><tt class='parameter'>max</tt></i> era <i><tt class='parameter'>range</tt></i> . Assim, para obter os mesmos resultados do exemplo acima, voc&amp;ecirc; precisaria utilizar <i>rand (5, 11)</i> para obter um n&amp;uacute;mero aleat&amp;oacute;rio entre 5 e 15. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mt-rand.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mt_rand()</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 /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mt_rand</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #0000BB'>mt_rand</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>mt_rand</span><span style='color: #007700'>(</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>15</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> 1604716014 1478613278 6 </pre></div> </div> </div><p> </p> </div> <a name='function.mt-rand.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.mt-srand.php' class='function' rel='rdfs-seeAlso'>mt_srand()</a> - Semeia o gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mt-getrandmax.php' class='function' rel='rdfs-seeAlso'>mt_getrandmax()</a> - Retorna o maior valor alet&amp;oacute;rio poss&amp;iacute;vel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.rand.php' class='function' rel='rdfs-seeAlso'>rand()</a> - Gera um inteiro aleat&amp;oacute;rio</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="mt_getrandmax" value="<div id='function.mt-getrandmax' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mt-getrandmax.php'>mt_getrandmax</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mt_getrandmax</span> &amp;mdash; <span class='dc-title'>Retorna o maior valor alet&amp;oacute;rio poss&amp;iacute;vel</span></p> </div> <a name='function.mt-getrandmax.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>mt_getrandmax</b></span> ( <span class='methodparam'>void</span> )</div> <p class='simpara'> Retorna o maior valor que pode ser obtido numa chamada a <a href='http://www.php.net/manual/pt_BR/function.mt-rand.php' class='function'>mt_rand()</a>. </p> </div> <a name='function.mt-getrandmax.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o valor m&amp;aacute;ximo aleat&amp;oacute;rio retornado por <a href='http://www.php.net/manual/pt_BR/function.mt-rand.php' class='function'>mt_rand()</a> </p> </div> <a name='function.mt-getrandmax.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.mt-rand.php' class='function' rel='rdfs-seeAlso'>mt_rand()</a> - Gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mt-srand.php' class='function' rel='rdfs-seeAlso'>mt_srand()</a> - Semeia o gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.getrandmax.php' class='function' rel='rdfs-seeAlso'>getrandmax()</a> - Retorna o maior valor alet&amp;oacute;rio poss&amp;iacute;vel</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="move_uploaded_file" value="<div id='function.move-uploaded-file' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.move-uploaded-file.php'>move_uploaded_file</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>move_uploaded_file</span> &amp;mdash; <span class='dc-title'>Move um arquivo enviado para uma nova localiza&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.move-uploaded-file.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>move_uploaded_file</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$destination</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o verifica para ter certeza de que o arquivo designado por <i><tt class='parameter'>filename</tt></i> &amp;eacute; um arquivo de upload v&amp;aacute;lido (que tenha sido enviado pelo mecanismo PHP de envio por POST HTTP). Se o arquivo for v&amp;aacute;lido, ele ser&amp;aacute; movido para o nome de arquivo dado por <i><tt class='parameter'>destination</tt></i> . </p> <p class='para'> Este tipo de verifica&amp;ccedil;&amp;atilde;o &amp;eacute; especialmente imporante se existir alguma change que qualquer coisa feita com os arquivos enviados possa revelar seu conte&amp;uacute;do ao usu&amp;aacute;rio, ou mesmo para outros usu&amp;aacute;rios no memo sistema. </p> </div> <a name='function.move-uploaded-file.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do arquivo enviado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>destination</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O destino do arquivo movido. </p> </dd> </dl> <p> </p> </div> <a name='function.move-uploaded-file.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Se <i><tt class='parameter'>filename</tt></i> n&amp;atilde;o for um arquivo enviado v&amp;aacute;lido, ent&amp;atilde;o nenhuma a&amp;ccedil;&amp;atilde;o ocorrer&amp;aacute; e <b>move_uploaded_file()</b> retornar&amp;aacute; <b><tt class='constant'>FALSE</tt></b>. </p> <p class='para'> Se <i><tt class='parameter'>filename</tt></i> for um arquivo enviado v&amp;aacute;lido, mas n&amp;atilde;o puder ser movido por alguma raz&amp;atilde;o, nenhuma a&amp;ccedil;&amp;atilde;o ocorrer&amp;aacute; e <b>move_uploaded_file()</b> retornar&amp;aacute; <b><tt class='constant'>FALSE</tt></b>. Adicionalmente, um alerta ser&amp;aacute; emitido. </p> </div> <a name='function.move-uploaded-file.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <b>move_uploaded_file()</b> &amp;eacute; afetado tanto por <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.safe-mode' class='link'>safe mode</a> quanto por <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.open-basedir' class='link'>open_basedir</a>. Entretanto, restri&amp;ccedil;&amp;otilde;es s&amp;atilde;o aplicadas apenas no caminho de <i><tt class='parameter'>destination</tt></i> para permitir que arquivos onde <i><tt class='parameter'>filename</tt></i> venha a conflitar com tais restri&amp;ccedil;&amp;otilde;es possam ser movidos. <b>move_uploaded_file()</b> assegura a seguran&amp;ccedil;a desta opera&amp;ccedil;&amp;atilde;o permitindo que apenas arquivos carregados pelo PHP possam ser movidos. <br /> </p></blockquote> <div class='warning'><b class='warning'>Aviso</b> <p class='para'> Se o arquivo de destino j&amp;aacute; existir, ele ser&amp;aacute; sobrescrito. </p> </div> </div> <a name='function.move-uploaded-file.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.is-uploaded-file.php' class='function' rel='rdfs-seeAlso'>is_uploaded_file()</a> - Diz se o arquivo foi enviado por POST HTTP</li> <li class='member'>Veja <a href='http://www.php.net/manual/pt_BR/features.file-upload.php' class='link'>Gerenciar o upload de arquivos</a> para um exemplo de uso simples</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="mktime" value="<div id='function.mktime' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mktime.php'>mktime</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mktime</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m um timestamp Unix para uma data</span></p> </div> <a name='function.mktime.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>mktime</b></span> ([ <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$hora</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$minuto</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$second</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mes</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dia</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$ano</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$is_dst</tt></span> ]]]]]]] )</div> <p class='para rdfs-comment'> Retorna o timestamp Unix correspondente para os argumentos dados. Este timestamp &amp;eacute; um longo inteiro contendo o n&amp;uacute;mero de segundos entre a Era Unix (January 1 1970 00:00:00 GMT) e o tempo especificado. </p> <p class='para'> Argumentos podem ser omitidos da direita para esquerda; quaisquer argumentos assim omitidos ser&amp;atilde;o definidos para o valor atual de acordo com a data e a hora local. </p> </div> <a name='function.mktime.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'>hour</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero da hora. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>minute</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do minuto. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>second</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero de segundos passados do minuto. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>month</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do m&amp;ecirc;s. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>day</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do dia. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>year</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O n&amp;uacute;mero do ano. Pode conter dois ou quatro d&amp;iacute;gitos, com os valores entre 0-69 significando 2000-2069 e 70-100 para 1970-2000. Em sistemas aonde o time_t &amp;eacute; um inteiro assinado de 32 bit, como &amp;eacute; mais comum, o alcance do <i><tt class='parameter'>ano</tt></i> &amp;eacute; algo entre 1901 e 2038. Entretanto, antes do PHP 5.1.0 esse range era limitado para 1970 at&amp;eacute; 2038 em alguns sistemas (ex. Windows). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>is_dst</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Este par&amp;acirc;metro pode ser definido para 1 se est&amp;aacute; durante o hor&amp;aacute;rio de ver&amp;atilde;o (DST), 0 se n&amp;atilde;o est&amp;aacute;, ou -1 (o padr&amp;atilde;o) se &amp;eacute; desconhecido se o tempo est&amp;aacute; dentro do hor&amp;aacute;rio de ver&amp;atilde;o ou n&amp;atilde;o. Se &amp;eacute; desconhecido, o PHP tenta compreender por si mesmo. Isto pode causar inesperado (mas n&amp;atilde;o incorreto) resultados. As vezes &amp;eacute; inv&amp;aacute;lido se DST &amp;eacute; habilitado no sistema em que o PHP est&amp;aacute; executando ou <i><tt class='parameter'>is_dst</tt></i> &amp;eacute; definido para 1. Se DST &amp;eacute; habilitado em e.g. 2:00, todo tempo entre 2:00 e 3:00 s&amp;atilde;o inv&amp;aacute;lidos e <b>mktime()</b> retorna um indefinido (normalmente negativo) valor. Alguns sistemas (e.g. Solaris 8) habilita DST na meia-noite ent&amp;atilde;o tempo 0:30 do dia quando DST est&amp;aacute; habilitado &amp;eacute; avaliado como 23:30 do dia anterior. </p> <blockquote><p><b class='note'>Nota</b>: No PHP 5.1.0, este par&amp;acirc;metro tornou-se obsoleto. Como resultado, o o novo recurso de manuseamento de timezone deve ser usado ao inv&amp;eacute;s dele. <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='function.mktime.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>mktime()</b> retorna o Unix timestamp dos argumentos dado. Se os argumentos s&amp;atilde;o inv&amp;aacute;lidos, a fun&amp;ccedil;&amp;atilde;o retorna <b><tt class='constant'>FALSE</tt></b> (antes do PHP 5.1 retornava <i>-1</i>). </p> </div> <a name='function.mktime.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> Toda a chamada a uma fun&amp;ccedil;&amp;atilde;o de data/hora ir&amp;aacute; gerar um se a zona da hora n&amp;atilde;o for valida, e/ou uma mensagem <b><tt class='constant'>E_STRICT</tt></b> ou <b><tt class='constant'>E_WARNING</tt></b> se estiver usando a defini&amp;ccedil;&amp;atilde;o do sistema ou a vari&amp;aacute;vel de ambiente <var class='varname'>TZ</var>. Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.date-default-timezone-set.php' class='function'>date_default_timezone_set()</a></p> </div> <a name='function.mktime.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'>3.0.10</td> <td align='left'>Adicionado o par&amp;acirc;metro<i><tt class='parameter'>is_dst</tt></i> </td> </tr> <tr valign='middle'> <td align='left'>5.1.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>is_dst</tt></i> tornou-se obsoleto. Fazendo a fun&amp;ccedil;&amp;atilde;o retornar <b><tt class='constant'>FALSE</tt></b> em erro, ao inv&amp;eacute;s de <i>-1</i>. Reparada a fun&amp;ccedil;&amp;atilde;o para aceitar o ano, m&amp;ecirc;s e dia para ser todos passados como zero. </td> </tr> <tr valign='middle'><td align='left'>5.1.0</td><td align='left'><p class='para'> Agora emite <b><tt class='constant'>E_STRICT</tt></b> e <b><tt class='constant'>E_NOTICE</tt></b> em erros da zona de hor&amp;aacute;rio.</p></td></tr> </tbody> </table> <p> </p> </div> <a name='function.mktime.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>mktime()</b></b></p> <div class='example-contents para'><p> <b>mktime()</b> &amp;eacute; &amp;uacute;til durante a aritm&amp;eacute;tica e valida&amp;ccedil;&amp;atilde;o de data, enquanto ela calcular&amp;aacute; automaticamente o valor correto para a entrada fora do intervalo. Por exemplo, cada uma das seguintes linhas produzir&amp;aacute; a string &amp;quot;Jan-01-1998&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 /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>date</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'M-d-Y'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mktime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>32</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1997</span><span style='color: #007700'>));<br />echo&amp;nbsp;</span><span style='color: #0000BB'>date</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'M-d-Y'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mktime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>13</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'>1997</span><span style='color: #007700'>));<br />echo&amp;nbsp;</span><span style='color: #0000BB'>date</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'M-d-Y'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mktime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</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'>0</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'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1998</span><span style='color: #007700'>));<br />echo&amp;nbsp;</span><span style='color: #0000BB'>date</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'M-d-Y'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mktime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</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'>0</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'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>98</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 &amp;Uacute;ltimo dia do pr&amp;oacute;ximo m&amp;ecirc;s</b></p> <div class='example-contents para'><p> O &amp;uacute;ltimo dia de um m&amp;ecirc;s dado pode ser expressado como o dia &amp;quot;0&amp;quot; do m&amp;ecirc;s seguinte, n&amp;atilde;o o dia -1. Os dois exemplos seguintes produzir&amp;atilde;o a string &amp;quot;The last day in Feb 2000 is: 29&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 />$lastday&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mktime&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>2000</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>strftime&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Last&amp;nbsp;day&amp;nbsp;in&amp;nbsp;Feb&amp;nbsp;2000&amp;nbsp;is:&amp;nbsp;%d'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$lastday</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #0000BB'>$lastday&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mktime&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,-</span><span style='color: #0000BB'>31</span><span style='color: #007700'>,</span><span style='color: #0000BB'>2000</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>strftime&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Last&amp;nbsp;day&amp;nbsp;in&amp;nbsp;Feb&amp;nbsp;2000&amp;nbsp;is:&amp;nbsp;%d'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$lastday</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.mktime.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> Antes do PHP 5.1.0, timestamp negativos n&amp;atilde;o eram suportados em nenhuma vers&amp;atilde;o conhecida do Windows e em alguns outros sistemas tamb&amp;eacute;m. Portanto o intervalo v&amp;aacute;lido de anos foi limitado para 1970 at&amp;eacute; 2038. </p> </div> </div> <a name='function.mktime.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.gmmktime.php' class='function' rel='rdfs-seeAlso'>gmmktime()</a> - Obt&amp;eacute;m um timestamp Unix para uma data GMT</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.date.php' class='function' rel='rdfs-seeAlso'>date()</a> - Formata a data e a hora local</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.time.php' class='function' rel='rdfs-seeAlso'>time()</a> - Retorna o timestamp Unix atual</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="mkdir" value="<div id='function.mkdir' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mkdir.php'>mkdir</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mkdir</span> &amp;mdash; <span class='dc-title'>Cria um diret&amp;oacute;rio</span></p> </div> <a name='function.mkdir.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>mkdir</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pathname</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mode</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$recursive</tt></span> [, <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$context</tt></span> ]]] )</div> <p class='para rdfs-comment'> Tenta criar o diret&amp;oacute;rio especificado pelo caminho <i><tt class='parameter'>pathname</tt></i> . </p> </div> <a name='function.mkdir.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'>pathname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O caminho do diret&amp;oacute;rio. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>mode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O modo padr&amp;atilde;o &amp;eacute; 0777, que significa o acesso mais abrangente poss&amp;iacute;vel. Para mais informa&amp;ccedil;&amp;otilde;es sobre os modos, leia os detalhes na p&amp;aacute;gina da <a href='http://www.php.net/manual/pt_BR/function.chmod.php' class='function'>chmod()</a>. </p> <blockquote><p><b class='note'>Nota</b>: O par&amp;acirc;metro <i><tt class='parameter'>mode</tt></i> &amp;eacute; ignorado no Windows. <br /> </p></blockquote> <p class='para'> Note que voc&amp;ecirc; provavelmente quer especificar o mode como um n&amp;uacute;mero octal, o que significa que ele deve ter o zero inicial. O mode &amp;eacute; tamb&amp;eacute;m modificado pela umaks atual, que voc&amp;ecirc; pode mudar usando <a href='http://www.php.net/manual/pt_BR/function.umask.php' class='function'>umask()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>recursive</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O padr&amp;atilde;o &amp;eacute; <b><tt class='constant'>FALSE</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>context</tt></i> </span> </dt><dd class='listitem'> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O suporte ao contexto foi adicionado com o PHP 5.0.0. Para uma descri&amp;ccedil;&amp;atilde;o de <i>contextos</i>, veja <a href='http://www.php.net/manual/pt_BR/ref.stream.php' class='xref'>Stream Fun&amp;ccedil;&amp;otilde;es</a></span></p></blockquote> </dd> </dl> <p> </p> </div> <a name='function.mkdir.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.mkdir.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.0.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>recursive</tt></i> foi adicionado </td> </tr> <tr valign='middle'> <td align='left'>5.0.0</td> <td align='left'> A partir do PHP 5.0.0, <b>mkdir()</b> tamb&amp;eacute;m pode ser usada com <em class='emphasis'>alguns</em> wrappers de URL. Veja em <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> uma lista de quais wrappers suportam <b>mkdir()</b> </td> </tr> <tr valign='middle'> <td align='left'>4.2.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>mode</tt></i> tornou-se opcional. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mkdir.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de <b>mkdir()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mkdir</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'/path/to/my/dir'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0700</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.mkdir.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <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 o diret&amp;oacute;rio no qual o script est&amp;aacute; em 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> </div> <a name='function.mkdir.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.rmdir.php' class='function' rel='rdfs-seeAlso'>rmdir()</a> - Remove um diret&amp;oacute;rio</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="min" value="<div id='function.min' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.min.php'>min</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>min</span> &amp;mdash; <span class='dc-title'>Encontra o menor valor</span></p> </div> <a name='function.min.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>min</b></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$values</tt></span> )</div> <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>min</b></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'>$value1</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'>$value2</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'>$value3...</tt></span> ] )</div> <p class='para rdfs-comment'> Se o primeiro e &amp;uacute;nico argumento &amp;eacute; um array, <b>min()</b> retorna o menor valor no array. Se no m&amp;iacute;nimo dois par&amp;acirc;metros s&amp;atilde;o fornecidos, <b>min()</b> retornar&amp;aacute; o menor deles. </p> <blockquote><p><b class='note'>Nota</b>: O PHP ir&amp;aacute; avaliar uma <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> n&amp;atilde;o num&amp;eacute;rica como <i>0</i> se comparado a <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>, mas ainda retorna a string como se ela fosse numericamente o menor valor. Se v&amp;aacute;rios agumentos forem avaliados como <i>0</i>, <b>min()</b> ir&amp;aacute; retornar o menor valor alfanumericamente se alguma string &amp;eacute; dada, sen&amp;atilde;o um n&amp;uacute;mero <i>0</i> &amp;eacute; retornado. <br /> </p></blockquote> </div> <a name='function.min.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'>values</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Um array contendo os valores. </p> </dd> </dl> <p> </p> </div> <a name='function.min.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>min()</b> retorna o menor numericalmente dos valores dos par&amp;acirc;metros. </p> </div> <a name='function.min.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplos de <b>min()</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: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</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'>6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>7</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;1<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;2<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;0<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;hello<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>,&amp;nbsp;-</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;-1<br /><br />//&amp;nbsp;Com&amp;nbsp;arrays&amp;nbsp;m&amp;uacute;ltiplos,&amp;nbsp;min&amp;nbsp;compara&amp;nbsp;da&amp;nbsp;esquerda&amp;nbsp;para&amp;nbsp;direita,<br />//&amp;nbsp;assim&amp;nbsp;nesse&amp;nbsp;exemplo:&amp;nbsp;2&amp;nbsp;==&amp;nbsp;2,&amp;nbsp;mas&amp;nbsp;4&amp;nbsp;&amp;lt;&amp;nbsp;5<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>8</span><span style='color: #007700'>),&amp;nbsp;array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;array(2,&amp;nbsp;4,&amp;nbsp;8)<br /><br />//&amp;nbsp;Se&amp;nbsp;ambos&amp;nbsp;forem&amp;nbsp;um&amp;nbsp;array&amp;nbsp;e&amp;nbsp;um&amp;nbsp;n&amp;atilde;o&amp;nbsp;array,&amp;nbsp;o&amp;nbsp;array<br />//&amp;nbsp;nunca&amp;nbsp;ser&amp;aacute;&amp;nbsp;retornado&amp;nbsp;porque&amp;nbsp;ele&amp;nbsp;&amp;eacute;&amp;nbsp;sempre&amp;nbsp;considerado&amp;nbsp;o&amp;nbsp;maior<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'string'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>7</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>42</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;string<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.min.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.max.php' class='function' rel='rdfs-seeAlso'>max()</a> - Localiza o maior valor</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.count.php' class='function' rel='rdfs-seeAlso'>count()</a> - Conta o n&amp;uacute;mero de elementos de uma vari&amp;aacute;vel, ou propriedades de um objeto</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="microtime" value="<div id='function.microtime' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.microtime.php'>microtime</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>microtime</span> &amp;mdash; <span class='dc-title'>Retorna um timestamp Unix com microsegundos</span></p> </div> <a name='function.microtime.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>microtime</b></span> ([ <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$get_as_float</tt></span> ] )</div> <p class='para rdfs-comment'> A <b>microtime()</b> retorna o timestamp atual com microsegundos. Esta fun&amp;ccedil;&amp;atilde;o est&amp;aacute; apenas dispon&amp;iacute;vel em sistemas operacionais que suportam o chamda do sistema gettimeofday(). </p> </div> <a name='function.microtime.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'>get_as_float</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Quando chamada sem o argumento opcional, esta fun&amp;ccedil;&amp;atilde;o retorna a string &amp;quot;msec sec&amp;quot; onde sec &amp;eacute; o a hora atual medida em segundos desde a era UNIX (0:00:00 January 1, 1970 GMT), e msec &amp;eacute; a parte em microsegundos. Ambas por&amp;ccedil;&amp;otilde;es de string s&amp;atilde;o retornadas em segundos. </p> <p class='para'> Se o opcional <i><tt class='parameter'>get_as_float</tt></i> &amp;eacute; definido para <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o um <a href='http://www.php.net/manual/pt_BR/language.types.float.php' class='type float'>float</a> (em segundos) &amp;eacute; retornado. </p> </dd> </dl> <p> </p> </div> <a name='function.microtime.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.0.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>get_as_float</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.microtime.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Cronometrando a execu&amp;ccedil;&amp;atilde;o do script com <b>microtime()</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'>/**<br />&amp;nbsp;*&amp;nbsp;Simple&amp;nbsp;function&amp;nbsp;to&amp;nbsp;replicate&amp;nbsp;PHP&amp;nbsp;5&amp;nbsp;behaviour<br />&amp;nbsp;*/<br /></span><span style='color: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>getmicrotime</span><span style='color: #007700'>()&amp;nbsp;<br />{&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;list(</span><span style='color: #0000BB'>$usec</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$sec</span><span style='color: #007700'>)&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>explode</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>microtime</span><span style='color: #007700'>());&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;((float)</span><span style='color: #0000BB'>$usec&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;(float)</span><span style='color: #0000BB'>$sec</span><span style='color: #007700'>);&amp;nbsp;<br />}&amp;nbsp;<br /><br /></span><span style='color: #0000BB'>$time_start&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>microtime_float</span><span style='color: #007700'>();<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #FF8000'>//&amp;nbsp;Sleep&amp;nbsp;for&amp;nbsp;a&amp;nbsp;while<br /></span><span style='color: #0000BB'>usleep</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$time_end&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>microtime_float</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>$time&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$time_end&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$time_start</span><span style='color: #007700'>;<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Did&amp;nbsp;nothing&amp;nbsp;in&amp;nbsp;</span><span style='color: #0000BB'>$time</span><span style='color: #DD0000'>&amp;nbsp;seconds\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Timing script execution in PHP 5</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$time_start&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>microtime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Sleep&amp;nbsp;for&amp;nbsp;a&amp;nbsp;while<br /></span><span style='color: #0000BB'>usleep</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #0000BB'>$time_end&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>microtime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$time&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$time_end&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$time_start</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'Did&amp;nbsp;nothing&amp;nbsp;in&amp;nbsp;</span><span style='color: #0000BB'>$time</span><span style='color: #DD0000'>&amp;nbsp;seconds\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.microtime.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.time.php' class='function' rel='rdfs-seeAlso'>time()</a> - Retorna o timestamp Unix atual</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="method_exists" value="<div id='function.method-exists' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.method-exists.php'>method_exists</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>method_exists</span> &amp;mdash; <span class='dc-title'>Checa se o m&amp;eacute;todo da classe existe</span></p> </div> <a name='function.method-exists.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>method_exists</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$object</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$method_name</tt></span> )</div> <p class='para rdfs-comment'> Verifica se o m&amp;eacute;todo da classe existe num dado <i><tt class='parameter'>object</tt></i> . </p> </div> <a name='function.method-exists.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'>object</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Uma inst&amp;acirc;ncia de objeto </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>method_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do m&amp;eacute;todo </p> </dd> </dl> <p> </p> </div> <a name='function.method-exists.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o dado m&amp;eacute;todo <i><tt class='parameter'>method_name</tt></i> &amp;eacute; definido no dado <i><tt class='parameter'>object</tt></i> , <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.method-exists.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>method_exists()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$directory&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>Directory</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'.'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>method_exists</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$directory</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'read'</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> bool(true) </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Exemplo da <b>method_exists()</b> com m&amp;eacute;todo est&amp;aacute;tico</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$directory&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>Directory</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'.'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>method_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Directory'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'read'</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> bool(true) </pre></div> </div> </div><p> </p> </div> <a name='function.method-exists.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.function-exists.php' class='function' rel='rdfs-seeAlso'>function_exists()</a> - Retorna TRUE se a fun&amp;ccedil;&amp;atilde;o dada est&amp;aacute; definida</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-callable.php' class='function' rel='rdfs-seeAlso'>is_callable()</a> - Verifica se o conte&amp;uacute;do da vari&amp;aacute;vel pode ser chamado como fun&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="metaphone" value="<div id='function.metaphone' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.metaphone.php'>metaphone</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>metaphone</span> &amp;mdash; <span class='dc-title'>Calcula a metaphone key de uma string</span></p> </div> <a name='function.metaphone.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>metaphone</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> )</div> <p class='para rdfs-comment'> Calcula a metaphone key de <i><tt class='parameter'>str</tt></i> . </p> <p class='para'> Similar a <a href='http://www.php.net/manual/pt_BR/function.soundex.php' class='function'>soundex()</a> metaphone cria a mesma key para palavras sonoras similares. Ela &amp;eacute; mais precisa do que <a href='http://www.php.net/manual/pt_BR/function.soundex.php' class='function'>soundex()</a> por ela conhecer as regras b&amp;aacute;sicas da pronuncia&amp;ccedil;&amp;atilde;o inglesa. As metaphone keys geradas s&amp;atilde;o de comprimentos variados. </p> <p class='para'> Metaphone foi desenvolvido por Lawrence Philips &amp;lt;lphilips at verity dot com&amp;gt;. Ela &amp;eacute; descrita em [&amp;quot;Practical Algorithms for Programmers&amp;quot;, Binstock &amp;amp; Rex, Addison Wesley, 1995]. </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="memory_get_usage" value="<div id='function.memory-get-usage' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.memory-get-usage.php'>memory_get_usage</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.2, PHP 5)</p><p class='refpurpose'><span class='refname'>memory_get_usage</span> &amp;mdash; <span class='dc-title'>Retorna a quantidade de mem&amp;oacute;ria alocada para PHP</span></p> </div> <a name='function.memory-get-usage.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>memory_get_usage</b></span> ([ <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$real_usage</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna a quantidade de mem&amp;oacute;ria, em bytes, que esta atualmente alocada para o seu script PHP. </p> </div> <a name='function.memory-get-usage.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'>real_usage</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Defina isto para <b><tt class='constant'>TRUE</tt></b> para obter a quantidade geral de mem&amp;oacute;ria alocada pelo sistema. Se n&amp;atilde;o definida ou <b><tt class='constant'>FALSE</tt></b> somente a mem&amp;oacute;ria usada por <i>emalloc()</i> &amp;eacute; reportada. </p> </dd> </dl> <p> </p> </div> <a name='function.memory-get-usage.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a quantidade de mem&amp;oacute;ria em bytes. </p> </div> <a name='function.memory-get-usage.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.1</td> <td align='left'> Compilar com <a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.memory-limit' class='link'>--enable-memory-limit</a> n&amp;atilde;o &amp;eacute; mais requerido para esta fun&amp;ccedil;&amp;atilde;o existir. </td> </tr> <tr valign='middle'> <td align='left'>5.2.0</td> <td align='left'> <i><tt class='parameter'>real_usage</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.memory-get-usage.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>memory_get_usage()</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;Este&amp;nbsp;&amp;eacute;&amp;nbsp;apenas&amp;nbsp;um&amp;nbsp;exemplo,&amp;nbsp;os&amp;nbsp;n&amp;uacute;meros&amp;nbsp;abaixo<br />//&amp;nbsp;ser&amp;atilde;o&amp;nbsp;diferentes&amp;nbsp;dependendo&amp;nbsp;do&amp;nbsp;seu&amp;nbsp;sistema<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>memory_get_usage</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;36640<br /><br /></span><span style='color: #0000BB'>$a&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>str_repeat</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Hello'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4242</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>memory_get_usage</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;57960<br /><br /></span><span style='color: #007700'>unset(</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>memory_get_usage</span><span style='color: #007700'>()&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;36744<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.memory-get-usage.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.memory-get-peak-usage.php' class='function' rel='rdfs-seeAlso'>memory_get_peak_usage()</a> - Returns the peak of memory allocated by PHP</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.memory-limit' class='link'>memory_limit</a></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="memory_get_peak_usage" value="<div id='function.memory-get-peak-usage' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.memory-get-peak-usage.php'>memory_get_peak_usage</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>memory_get_peak_usage</span> &amp;mdash; <span class='dc-title'>Returns the peak of memory allocated by PHP</span></p> </div> <a name='function.memory-get-peak-usage.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>memory_get_peak_usage</b></span> ([ <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$real_usage</tt><span class='initializer'> = false</span></span> ] )</div> <p class='para rdfs-comment'> Returns the peak of memory, in bytes, that&amp;#039;s been allocated to your PHP script. </p> </div> <a name='function.memory-get-peak-usage.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'>real_usage</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Set this to <b><tt class='constant'>TRUE</tt></b> to get the real size of memory allocated from system. If not set or <b><tt class='constant'>FALSE</tt></b> only the memory used by <i>emalloc()</i> is reported. </p> </dd> </dl> <p> </p> </div> <a name='function.memory-get-peak-usage.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the memory peak in bytes. </p> </div> <a name='function.memory-get-peak-usage.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.1</td> <td align='left'> Compiling with <a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.memory-limit' class='link'>--enable-memory-limit</a> is no longer required for this function to exist. </td> </tr> <tr valign='middle'> <td align='left'>5.2.0</td> <td align='left'> <i><tt class='parameter'>real_usage</tt></i> was added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.memory-get-peak-usage.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.memory-get-usage.php' class='function' rel='rdfs-seeAlso'>memory_get_usage()</a> - Retorna a quantidade de mem&amp;oacute;ria alocada para PHP</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.memory-limit' class='link'>memory_limit</a></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="md5_file" value="<div id='function.md5-file' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.md5-file.php'>md5_file</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>md5_file</span> &amp;mdash; <span class='dc-title'>Calcula hash md5 de um dado arquivo</span></p> </div> <a name='function.md5-file.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>md5_file</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$raw_output</tt></span> ] )</div> <p class='para rdfs-comment'> Calcula o hash MD5 do arquivo especificado pelo par&amp;acirc;metro <i><tt class='parameter'>filename</tt></i> usando o <a href='http://www.faqs.org/rfcs/rfc1321' class='link external'>&amp;raquo; RSA Data Security, Inc. MD5 Message-Digest Algorithm</a>, e retorna esse hash. A hash &amp;eacute; um n&amp;uacute;mero hexadecimal de 32 caracteres. </p> </div> <a name='function.md5-file.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do arquivo </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>raw_output</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Quando <b><tt class='constant'>TRUE</tt></b>, retorna no formato bin&amp;aacute;rio com o tamanho de 16. O padr&amp;atilde;o &amp;eacute; <b><tt class='constant'>FALSE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.md5-file.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma string em sucesso, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.md5-file.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.0.0</td> <td align='left'> Adicionado o par&amp;acirc;metro <i><tt class='parameter'>raw_output</tt></i> </td> </tr> <tr valign='middle'> <td align='left'>5.1.0</td> <td align='left'> Modificada fun&amp;ccedil;&amp;atilde;o para usar a API de API. Significa que voc&amp;ecirc; pode us&amp;aacute;-la com wrappers, como <i>md5_file(&amp;#039;http://example.com/..&amp;#039;)</i> </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.md5-file.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.md5.php' class='function' rel='rdfs-seeAlso'>md5()</a> - Calcula o 'hash MD5' de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.sha1-file.php' class='function' rel='rdfs-seeAlso'>sha1_file()</a> - Calcula a hash sha1 de um arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.crc32.php' class='function' rel='rdfs-seeAlso'>crc32()</a> - Calcula polin&amp;ocirc;mio crc32 de uma string</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="md5" value="<div id='function.md5' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.md5.php'>md5</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>md5</span> &amp;mdash; <span class='dc-title'>Calcula o &amp;quot;hash MD5&amp;quot; de uma string</span></p> </div> <a name='function.md5.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>md5</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$raw_output</tt></span> ] )</div> <p class='para rdfs-comment'> Calcula o &amp;quot;hash MD5&amp;quot; de <i><tt class='parameter'>str</tt></i> usando <a href='http://www.faqs.org/rfcs/rfc1321' class='link external'>&amp;raquo; RSA Data Security, Inc. MD5 Message-Digest Algorithm</a>, e devolve esse hash. </p> </div> <a name='function.md5.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>raw_output</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se o opcional <i><tt class='parameter'>raw_output</tt></i> &amp;eacute; definido para <b><tt class='constant'>TRUE</tt></b>, ent&amp;atilde;o o md5 &amp;eacute; ao inv&amp;eacute;s retornado no formato bin&amp;aacute;rio com um tamanho de 16. Padr&amp;atilde;o para <b><tt class='constant'>FALSE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.md5.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o hash como um n&amp;uacute;mero hexadecimal de 32 caracteres. </p> </div> <a name='function.md5.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.0.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>raw_output</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.md5.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo da <b>md5()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'apple'</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>md5</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>)&amp;nbsp;===&amp;nbsp;</span><span style='color: #DD0000'>'1f3870be274f6c49b3e31a0c6728957f'</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Would&amp;nbsp;you&amp;nbsp;like&amp;nbsp;a&amp;nbsp;green&amp;nbsp;or&amp;nbsp;red&amp;nbsp;apple?'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.md5.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.sha1-file.php' class='function' rel='rdfs-seeAlso'>sha1_file()</a> - Calcula a hash sha1 de um arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.crc32.php' class='function' rel='rdfs-seeAlso'>crc32()</a> - Calcula polin&amp;ocirc;mio crc32 de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.sha1.php' class='function' rel='rdfs-seeAlso'>sha1()</a> - Calcula a hash sha1 de uma string</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="mb_substr_count" value="<div id='function.mb-substr-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-substr-count.php'>mb_substr_count</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_substr_count</span> &amp;mdash; <span class='dc-title'>Count the number of substring occurrences</span></p> </div> <a name='function.mb-substr-count.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>mb_substr_count</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ] )</div> <p class='para rdfs-comment'> Counts the number of times the <i><tt class='parameter'>needle</tt></i> substring occurs in the <i><tt class='parameter'>haystack</tt></i> <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-substr-count.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being checked. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being found. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-substr-count.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The number of times the <i><tt class='parameter'>needle</tt></i> substring occurs in the <i><tt class='parameter'>haystack</tt></i> <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-substr-count.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_substr_count()</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 /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mb_substr_count</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'This&amp;nbsp;is&amp;nbsp;a&amp;nbsp;test'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'is'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;prints&amp;nbsp;out&amp;nbsp;2<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mb-substr-count.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.mb-strpos.php' class='function' rel='rdfs-seeAlso'>mb_strpos()</a> - Find position of first occurrence of string in a string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-substr.php' class='function' rel='rdfs-seeAlso'>mb_substr()</a> - Get part of string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.substr-count.php' class='function' rel='rdfs-seeAlso'>substr_count()</a> - Conta o n&amp;uacute;mero de ocorr&amp;ecirc;ncias de uma substring</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="mb_substr" value="<div id='function.mb-substr' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-substr.php'>mb_substr</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_substr</span> &amp;mdash; <span class='dc-title'>Get part of string</span></p> </div> <a name='function.mb-substr.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>mb_substr</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$start</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$length</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> Performs a multi-byte safe <a href='http://www.php.net/manual/pt_BR/function.substr.php' class='function'>substr()</a> operation based on number of characters. Position is counted from the beginning of <i><tt class='parameter'>str</tt></i> . First character&amp;#039;s position is 0. Second character position is 1, and so on. </p> </div> <a name='function.mb-substr.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being checked. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>start</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The first position used in <i><tt class='parameter'>str</tt></i> . </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>length</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The maximum length of the returned <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-substr.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>mb_substr()</b> returns the portion of <i><tt class='parameter'>str</tt></i> specified by the <i><tt class='parameter'>start</tt></i> and <i><tt class='parameter'>length</tt></i> parameters. </p> </div> <a name='function.mb-substr.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.mb-strcut.php' class='function' rel='rdfs-seeAlso'>mb_strcut()</a> - Get part of string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</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="mb_substitute_character" value="<div id='function.mb-substitute-character' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-substitute-character.php'>mb_substitute_character</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_substitute_character</span> &amp;mdash; <span class='dc-title'>Set/Get substitution character</span></p> </div> <a name='function.mb-substitute-character.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>mb_substitute_character</b></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'>$substrchar</tt></span> ] )</div> <p class='para rdfs-comment'> Specifies a substitution character when input character encoding is invalid or character code does not exist in output character encoding. Invalid characters may be substituted <b><tt class='constant'>NULL</tt></b> (no output), <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> or <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> value (Unicode character code value). </p> <p class='para'> This setting affects <a href='http://www.php.net/manual/pt_BR/function.mb-convert-encoding.php' class='function'>mb_convert_encoding()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-convert-variables.php' class='function'>mb_convert_variables()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-output-handler.php' class='function'>mb_output_handler()</a>, and <a href='http://www.php.net/manual/pt_BR/function.mb-send-mail.php' class='function'>mb_send_mail()</a>. </p> </div> <a name='function.mb-substitute-character.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'>substrchar</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Specify the Unicode value as an <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>, or as one of the following <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>s: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> &amp;quot;none&amp;quot; : no output </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;long&amp;quot; : Output character code value (Example: U+3000,JIS+7E7E) </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.mb-substitute-character.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> If <i><tt class='parameter'>substchar</tt></i> is set, it returns <b><tt class='constant'>TRUE</tt></b> for success, otherwise returns <b><tt class='constant'>FALSE</tt></b>. If <i><tt class='parameter'>substchar</tt></i> is not set, it returns the Unicode value, or &amp;quot;<i>none</i>&amp;quot; or &amp;quot;<i>long</i>&amp;quot;. </p> </div> <a name='function.mb-substitute-character.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_substitute_character()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Set&amp;nbsp;with&amp;nbsp;Unicode&amp;nbsp;U+3013&amp;nbsp;(GETA&amp;nbsp;MARK)&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mb_substitute_character</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0x3013</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Set&amp;nbsp;hex&amp;nbsp;format&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mb_substitute_character</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'long'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Display&amp;nbsp;current&amp;nbsp;setting&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mb_substitute_character</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="mb_strwidth" value="<div id='function.mb-strwidth' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strwidth.php'>mb_strwidth</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strwidth</span> &amp;mdash; <span class='dc-title'>Return width of string</span></p> </div> <a name='function.mb-strwidth.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>mb_strwidth</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ] )</div> <p class='para rdfs-comment'> Returns the width of <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> . </p> <p class='para'> Multi-byte characters are usually twice the width of single byte characters. </p> <p class='para'> </p><table class='doctable table'> <caption><b>Characters width</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Chars</th> <th>Width</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>U+0000 - U+0019</td> <td align='left'>0</td> </tr> <tr valign='middle'> <td align='left'>U+0020 - U+1FFF</td> <td align='left'>1</td> </tr> <tr valign='middle'> <td align='left'>U+2000 - U+FF60</td> <td align='left'>2</td> </tr> <tr valign='middle'> <td align='left'>U+FF61 - U+FF9F</td> <td align='left'>1</td> </tr> <tr valign='middle'> <td align='left'>U+FFA0 - </td> <td align='left'>2</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mb-strwidth.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being decoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strwidth.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The width of <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> . </p> </div> <a name='function.mb-strwidth.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.mb-strimwidth.php' class='function' rel='rdfs-seeAlso'>mb_strimwidth()</a> - Get truncated string with specified width</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</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="mb_strtoupper" value="<div id='function.mb-strtoupper' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strtoupper.php'>mb_strtoupper</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strtoupper</span> &amp;mdash; <span class='dc-title'>Make a string uppercase</span></p> </div> <a name='function.mb-strtoupper.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>mb_strtoupper</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt><span class='initializer'> = mb_internal_encoding()</span></span> ] )</div> <p class='para rdfs-comment'> Returns <i><tt class='parameter'>str</tt></i> with all alphabetic characters converted to uppercase. </p> </div> <a name='function.mb-strtoupper.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being uppercased. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strtoupper.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <i><tt class='parameter'>str</tt></i> with all alphabetic characters converted to uppercase. </p> </div> <a name='function.mb-strtoupper.unicode'></a><div class='refsect1 unicode'> <h3 class='title'>Unicode</h3> <p class='para'> For more information about the Unicode properties, please see <a href='http://www.unicode.org/unicode/reports/tr21/' class='link external'>&amp;raquo; http://www.unicode.org/unicode/reports/tr21/</a>. </p> <p class='para'> By contrast to <a href='http://www.php.net/manual/pt_BR/function.strtoupper.php' class='function'>strtoupper()</a>, &amp;#039;alphabetic&amp;#039; is determined by the Unicode character properties. Thus the behaviour of this function is not affected by locale settings and it can convert any characters that have &amp;#039;alphabetic&amp;#039; property, such as a-umlaut (&amp;auml;). </p> </div> <a name='function.mb-strtoupper.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_strtoupper()</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 />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Mary&amp;nbsp;Had&amp;nbsp;A&amp;nbsp;Little&amp;nbsp;Lamb&amp;nbsp;and&amp;nbsp;She&amp;nbsp;LOVED&amp;nbsp;It&amp;nbsp;So'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_strtoupper</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Prints&amp;nbsp;MARY&amp;nbsp;HAD&amp;nbsp;A&amp;nbsp;LITTLE&amp;nbsp;LAMB&amp;nbsp;AND&amp;nbsp;SHE&amp;nbsp;LOVED&amp;nbsp;IT&amp;nbsp;SO<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mb-strtoupper.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.mb-strtolower.php' class='function' rel='rdfs-seeAlso'>mb_strtolower()</a> - Make a string lowercase</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-convert-case.php' class='function' rel='rdfs-seeAlso'>mb_convert_case()</a> - Perform case folding on a string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strtoupper.php' class='function' rel='rdfs-seeAlso'>strtoupper()</a> - Converte uma string para mai&amp;uacute;sculas</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="mb_strtolower" value="<div id='function.mb-strtolower' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strtolower.php'>mb_strtolower</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strtolower</span> &amp;mdash; <span class='dc-title'>Make a string lowercase</span></p> </div> <a name='function.mb-strtolower.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>mb_strtolower</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt><span class='initializer'> = mb_internal_encoding()</span></span> ] )</div> <p class='para rdfs-comment'> Returns <i><tt class='parameter'>str</tt></i> with all alphabetic characters converted to lowercase. </p> </div> <a name='function.mb-strtolower.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being lowercased. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strtolower.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <i><tt class='parameter'>str</tt></i> with all alphabetic characters converted to lowercase. </p> </div> <a name='function.mb-strtolower.unicode'></a><div class='refsect1 unicode'> <h3 class='title'>Unicode</h3> <p class='para'> For more information about the Unicode properties, please see <a href='http://www.unicode.org/unicode/reports/tr21/' class='link external'>&amp;raquo; http://www.unicode.org/unicode/reports/tr21/</a>. </p> <p class='para'> By contrast to <a href='http://www.php.net/manual/pt_BR/function.strtolower.php' class='function'>strtolower()</a>, &amp;#039;alphabetic&amp;#039; is determined by the Unicode character properties. Thus the behaviour of this function is not affected by locale settings and it can convert any characters that have &amp;#039;alphabetic&amp;#039; property, such as A-umlaut (&amp;Auml;). </p> </div> <a name='function.mb-strtolower.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_strtolower()</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 />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Mary&amp;nbsp;Had&amp;nbsp;A&amp;nbsp;Little&amp;nbsp;Lamb&amp;nbsp;and&amp;nbsp;She&amp;nbsp;LOVED&amp;nbsp;It&amp;nbsp;So'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_strtolower</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Prints&amp;nbsp;mary&amp;nbsp;had&amp;nbsp;a&amp;nbsp;little&amp;nbsp;lamb&amp;nbsp;and&amp;nbsp;she&amp;nbsp;loved&amp;nbsp;it&amp;nbsp;so<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mb-strtolower.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.mb-strtoupper.php' class='function' rel='rdfs-seeAlso'>mb_strtoupper()</a> - Make a string uppercase</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-convert-case.php' class='function' rel='rdfs-seeAlso'>mb_convert_case()</a> - Perform case folding on a string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strtolower.php' class='function' rel='rdfs-seeAlso'>strtolower()</a> - Converte uma string para min&amp;uacute;sculas</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="mb_strstr" value="<div id='function.mb-strstr' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strstr.php'>mb_strstr</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>mb_strstr</span> &amp;mdash; <span class='dc-title'>Finds first occurrence of a string within another</span></p> </div> <a name='function.mb-strstr.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>mb_strstr</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$part</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_strstr()</b> finds the first occurrence of <i><tt class='parameter'>needle</tt></i> in <i><tt class='parameter'>haystack</tt></i> and returns the portion of <i><tt class='parameter'>haystack</tt></i> . If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-strstr.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string from which to get the first occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to find in <i><tt class='parameter'>haystack</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>part</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Determines which portion of <i><tt class='parameter'>haystack</tt></i> this function returns. If set to <b><tt class='constant'>TRUE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the beginning to the first occurrence of <i><tt class='parameter'>needle</tt></i> . If set to <b><tt class='constant'>FALSE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the first occurrence of <i><tt class='parameter'>needle</tt></i> to the end, Default value is <b><tt class='constant'>FALSE</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Character encoding name to use. If it is omitted, internal character encoding is used. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-strstr.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the portion of <i><tt class='parameter'>haystack</tt></i> , or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>needle</tt></i> is not found. </p> </div> <a name='function.mb-strstr.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.stristr.php' class='function' rel='rdfs-seeAlso'>stristr()</a> - strstr sem diferenciar mai&amp;uacute;sculas e min&amp;uacute;sculas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strstr.php' class='function' rel='rdfs-seeAlso'>strstr()</a> - Encontra a primeira ocorrencia de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-stristr.php' class='function' rel='rdfs-seeAlso'>mb_stristr()</a> - Finds first occurrence of a string within another, case insensitive</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="mb_strrpos" value="<div id='function.mb-strrpos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strrpos.php'>mb_strrpos</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strrpos</span> &amp;mdash; <span class='dc-title'>Find position of last occurrence of a string in a string</span></p> </div> <a name='function.mb-strrpos.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>mb_strrpos</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> Performs a multibyte safe <a href='http://www.php.net/manual/pt_BR/function.strrpos.php' class='function'>strrpos()</a> operation based on the number of characters. <i><tt class='parameter'>needle</tt></i> position is counted from the beginning of <i><tt class='parameter'>haystack</tt></i> . First character&amp;#039;s position is 0. Second character position is 1. </p> </div> <a name='function.mb-strrpos.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being checked, for the last occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> to find in <i><tt class='parameter'>haystack</tt></i> . </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <span class='simpara'> May be specified to begin searching an arbitrary number of characters into the <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. Negative values will stop searching at an arbitrary point prior to the end of the <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </span> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strrpos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the numeric position of the last occurrence of <i><tt class='parameter'>needle</tt></i> in the <i><tt class='parameter'>haystack</tt></i> <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-strrpos.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.0</td> <td align='left'>Added the optional parameter <i><tt class='parameter'>offset</tt></i> .</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mb-strrpos.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'> The <i><tt class='parameter'>encoding</tt></i> parameter was moved from the third position to the fourth in PHP 5.2.0. For backward compatibility, <i><tt class='parameter'>encoding</tt></i> can be specified as the third parameter, but doing so is deprecated and will be removed in the future. </span> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-strrpos.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.mb-strpos.php' class='function' rel='rdfs-seeAlso'>mb_strpos()</a> - Find position of first occurrence of string in a string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strrpos.php' class='function' rel='rdfs-seeAlso'>strrpos()</a> - Encontra a posi&amp;ccedil;&amp;atilde;o da &amp;uacute;ltima ocorr&amp;ecirc;ncia de um caractere em uma string</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="mb_strripos" value="<div id='function.mb-strripos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strripos.php'>mb_strripos</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>mb_strripos</span> &amp;mdash; <span class='dc-title'>Finds position of last occurrence of a string within another, case insensitive</span></p> </div> <a name='function.mb-strripos.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>mb_strripos</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_strripos()</b> performs multi-byte safe <a href='http://www.php.net/manual/pt_BR/function.strripos.php' class='function'>strripos()</a> operation based on number of characters. <i><tt class='parameter'>needle</tt></i> position is counted from the beginning of <i><tt class='parameter'>haystack</tt></i> . First character&amp;#039;s position is 0. Second character position is 1. Unlike <a href='http://www.php.net/manual/pt_BR/function.mb-strrpos.php' class='function'>mb_strrpos()</a>, <b>mb_strripos()</b> is case-insensitive. </p> </div> <a name='function.mb-strripos.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string from which to get the position of the last occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to find in <i><tt class='parameter'>haystack</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The position in <i><tt class='parameter'>haystack</tt></i> to start searching </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Character encoding name to use. If it is omitted, internal character encoding is used. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-strripos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Return the numeric position of the last occurrence of <i><tt class='parameter'>needle</tt></i> in the <i><tt class='parameter'>haystack</tt></i> string, or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>needle</tt></i> is not found. </p> </div> <a name='function.mb-strripos.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.strripos.php' class='function' rel='rdfs-seeAlso'>strripos()</a> - Encontra a posi&amp;ccedil;&amp;atilde;o da &amp;uacute;ltima ocorr&amp;ecirc;ncia de uma string case-insensitive em uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strrpos.php' class='function' rel='rdfs-seeAlso'>strrpos()</a> - Encontra a posi&amp;ccedil;&amp;atilde;o da &amp;uacute;ltima ocorr&amp;ecirc;ncia de um caractere em uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strrpos.php' class='function' rel='rdfs-seeAlso'>mb_strrpos()</a> - Find position of last occurrence of a string in a string</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="mb_strrichr" value="<div id='function.mb-strrichr' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strrichr.php'>mb_strrichr</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>mb_strrichr</span> &amp;mdash; <span class='dc-title'>Finds the last occurrence of a character in a string within another, case insensitive</span></p> </div> <a name='function.mb-strrichr.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>mb_strrichr</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$part</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_strrichr()</b> finds the last occurrence of <i><tt class='parameter'>needle</tt></i> in <i><tt class='parameter'>haystack</tt></i> and returns the portion of <i><tt class='parameter'>haystack</tt></i> . Unlike <a href='http://www.php.net/manual/pt_BR/function.mb-strrchr.php' class='function'>mb_strrchr()</a>, <b>mb_strrichr()</b> is case-insensitive. If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-strrichr.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string from which to get the last occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to find in <i><tt class='parameter'>haystack</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>part</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Determines which portion of <i><tt class='parameter'>haystack</tt></i> this function returns. If set to <b><tt class='constant'>TRUE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the beginning to the last occurrence of <i><tt class='parameter'>needle</tt></i> . If set to <b><tt class='constant'>FALSE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the last occurrence of <i><tt class='parameter'>needle</tt></i> to the end, Default value is <b><tt class='constant'>FALSE</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Character encoding name to use. If it is omitted, internal character encoding is used. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-strrichr.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the portion of <i><tt class='parameter'>haystack</tt></i> . or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>needle</tt></i> is not found. </p> </div> <a name='function.mb-strrichr.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.mb-stristr.php' class='function' rel='rdfs-seeAlso'>mb_stristr()</a> - Finds first occurrence of a string within another, case insensitive</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strrchr.php' class='function' rel='rdfs-seeAlso'>mb_strrchr()</a> - Finds the last occurrence of a character in a string within another</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="mb_strrchr" value="<div id='function.mb-strrchr' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strrchr.php'>mb_strrchr</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>mb_strrchr</span> &amp;mdash; <span class='dc-title'>Finds the last occurrence of a character in a string within another</span></p> </div> <a name='function.mb-strrchr.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>mb_strrchr</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$part</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_strrchr()</b> finds the last occurrence of <i><tt class='parameter'>needle</tt></i> in <i><tt class='parameter'>haystack</tt></i> and returns the portion of <i><tt class='parameter'>haystack</tt></i> . If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-strrchr.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string from which to get the last occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to find in <i><tt class='parameter'>haystack</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>part</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Determines which portion of <i><tt class='parameter'>haystack</tt></i> this function returns. If set to <b><tt class='constant'>TRUE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the beginning to the last occurrence of <i><tt class='parameter'>needle</tt></i> . If set to <b><tt class='constant'>FALSE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the last occurrence of <i><tt class='parameter'>needle</tt></i> to the end, Default value is <b><tt class='constant'>FALSE</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Character encoding name to use. If it is omitted, internal character encoding is used. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-strrchr.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the portion of <i><tt class='parameter'>haystack</tt></i> . or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>needle</tt></i> is not found. </p> </div> <a name='function.mb-strrchr.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.strrchr.php' class='function' rel='rdfs-seeAlso'>strrchr()</a> - Encontra a ultima ocorr&amp;ecirc;ncia de um caractere em uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strstr.php' class='function' rel='rdfs-seeAlso'>mb_strstr()</a> - Finds first occurrence of a string within another</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strrichr.php' class='function' rel='rdfs-seeAlso'>mb_strrichr()</a> - Finds the last occurrence of a character in a string within another, case insensitive</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="mb_strpos" value="<div id='function.mb-strpos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strpos.php'>mb_strpos</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strpos</span> &amp;mdash; <span class='dc-title'>Find position of first occurrence of string in a string</span></p> </div> <a name='function.mb-strpos.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>mb_strpos</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> Finds position of the first occurrence of a <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> in a <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> <p class='para'> Performs a multi-byte safe <a href='http://www.php.net/manual/pt_BR/function.strpos.php' class='function'>strpos()</a> operation based on number of characters. The first character&amp;#039;s position is 0, the second character position is 1, and so on. </p> </div> <a name='function.mb-strpos.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being checked. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The position counted from the beginning of <i><tt class='parameter'>haystack</tt></i> . </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search offset. If it is not specified, 0 is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strpos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the numeric position of the first occurrence of <i><tt class='parameter'>needle</tt></i> in the <i><tt class='parameter'>haystack</tt></i> <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-strpos.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.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strpos.php' class='function' rel='rdfs-seeAlso'>strpos()</a> - Encontra a posi&amp;ccedil;&amp;atilde;o da primeira ocorr&amp;ecirc;ncia de uma string</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="mb_strlen" value="<div id='function.mb-strlen' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strlen.php'>mb_strlen</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strlen</span> &amp;mdash; <span class='dc-title'>Get string length</span></p> </div> <a name='function.mb-strlen.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>mb_strlen</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ] )</div> <p class='para rdfs-comment'> Gets the length of a <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-strlen.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being checked for length. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strlen.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the number of characters in <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> having character encoding <i><tt class='parameter'>encoding</tt></i> . A multi-byte character is counted as 1. </p> </div> <a name='function.mb-strlen.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.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strlen.php' class='function' rel='rdfs-seeAlso'>strlen()</a> - Retorna o tamanho de uma string</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="mb_stristr" value="<div id='function.mb-stristr' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-stristr.php'>mb_stristr</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>mb_stristr</span> &amp;mdash; <span class='dc-title'>Finds first occurrence of a string within another, case insensitive</span></p> </div> <a name='function.mb-stristr.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>mb_stristr</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$part</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_stristr()</b> finds the first occurrence of <i><tt class='parameter'>needle</tt></i> in <i><tt class='parameter'>haystack</tt></i> and returns the portion of <i><tt class='parameter'>haystack</tt></i> . Unlike <a href='http://www.php.net/manual/pt_BR/function.mb-strstr.php' class='function'>mb_strstr()</a>, <b>mb_stristr()</b> is case-insensitive. If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-stristr.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string from which to get the first occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to find in <i><tt class='parameter'>haystack</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>part</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Determines which portion of <i><tt class='parameter'>haystack</tt></i> this function returns. If set to <b><tt class='constant'>TRUE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the beginning to the first occurrence of <i><tt class='parameter'>needle</tt></i> . If set to <b><tt class='constant'>FALSE</tt></b>, it returns all of <i><tt class='parameter'>haystack</tt></i> from the first occurrence of <i><tt class='parameter'>needle</tt></i> to the end, Default value is <b><tt class='constant'>FALSE</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Character encoding name to use. If it is omitted, internal character encoding is used. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-stristr.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the portion of <i><tt class='parameter'>haystack</tt></i> , or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>needle</tt></i> is not found. </p> </div> <a name='function.mb-stristr.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.stristr.php' class='function' rel='rdfs-seeAlso'>stristr()</a> - strstr sem diferenciar mai&amp;uacute;sculas e min&amp;uacute;sculas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strstr.php' class='function' rel='rdfs-seeAlso'>strstr()</a> - Encontra a primeira ocorrencia de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strstr.php' class='function' rel='rdfs-seeAlso'>mb_strstr()</a> - Finds first occurrence of a string within another</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="mb_stripos" value="<div id='function.mb-stripos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-stripos.php'>mb_stripos</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0)</p><p class='refpurpose'><span class='refname'>mb_stripos</span> &amp;mdash; <span class='dc-title'>Finds position of first occurrence of a string within another, case insensitive</span></p> </div> <a name='function.mb-stripos.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>mb_stripos</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$haystack</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$needle</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_stripos()</b> returns the numeric position of the first occurrence of <i><tt class='parameter'>needle</tt></i> in the <i><tt class='parameter'>haystack</tt></i> string. Unlike <a href='http://www.php.net/manual/pt_BR/function.mb-strpos.php' class='function'>mb_strpos()</a>, <b>mb_stripos()</b> is case-insensitive. If <i><tt class='parameter'>needle</tt></i> is not found, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-stripos.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'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string from which to get the position of the first occurrence of <i><tt class='parameter'>needle</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to find in <i><tt class='parameter'>haystack</tt></i> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The position in <i><tt class='parameter'>haystack</tt></i> to start searching </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Character encoding name to use. If it is omitted, internal character encoding is used. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-stripos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Return the numeric position of the first occurrence of <i><tt class='parameter'>needle</tt></i> in the <i><tt class='parameter'>haystack</tt></i> string, or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>needle</tt></i> is not found. </p> </div> <a name='function.mb-stripos.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.stripos.php' class='function' rel='rdfs-seeAlso'>stripos()</a> - Encontra a primeira ocorrencia de uma string sem diferenciar mai&amp;uacute;sculas e min&amp;uacute;sculas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strpos.php' class='function' rel='rdfs-seeAlso'>strpos()</a> - Encontra a posi&amp;ccedil;&amp;atilde;o da primeira ocorr&amp;ecirc;ncia de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strpos.php' class='function' rel='rdfs-seeAlso'>mb_strpos()</a> - Find position of first occurrence of string in a string</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="mb_strimwidth" value="<div id='function.mb-strimwidth' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strimwidth.php'>mb_strimwidth</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strimwidth</span> &amp;mdash; <span class='dc-title'>Get truncated string with specified width</span></p> </div> <a name='function.mb-strimwidth.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>mb_strimwidth</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$start</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$width</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$trimmarker</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> Truncates <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> to specified <i><tt class='parameter'>width</tt></i> . </p> </div> <a name='function.mb-strimwidth.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being decoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>start</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The start position offset. Number of characters from the beginning of string. (First character is 0) </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>width</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The width of the desired trim. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>trimmarker</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string that is added to the end of string when string is truncated. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strimwidth.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The truncated <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. If <i><tt class='parameter'>trimmarker</tt></i> is set, <i><tt class='parameter'>trimmarker</tt></i> is appended to the return value. </p> </div> <a name='function.mb-strimwidth.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_strimwidth()</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 />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_strimwidth</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</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'>40</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'..&amp;gt;'</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.mb-strimwidth.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.mb-strwidth.php' class='function' rel='rdfs-seeAlso'>mb_strwidth()</a> - Return width of string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</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="mb_strcut" value="<div id='function.mb-strcut' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-strcut.php'>mb_strcut</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_strcut</span> &amp;mdash; <span class='dc-title'>Get part of string</span></p> </div> <a name='function.mb-strcut.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>mb_strcut</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$start</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$length</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_strcut()</b> performs equivalent operation as <a href='http://www.php.net/manual/pt_BR/function.mb-substr.php' class='function'>mb_substr()</a> with different method. If <i><tt class='parameter'>start</tt></i> position is multi-byte character&amp;#039;s second byte or larger, it starts from first byte of multi-byte character. </p> <p class='para'> It subtracts string from <i><tt class='parameter'>str</tt></i> that is shorter than <i><tt class='parameter'>length</tt></i> AND character that is not part of multi-byte string or not being middle of shift sequence. </p> </div> <a name='function.mb-strcut.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being cut. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>start</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The position that begins the cut. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>length</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being decoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-strcut.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>mb_strcut()</b> returns the portion of <i><tt class='parameter'>str</tt></i> specified by the <i><tt class='parameter'>start</tt></i> and <i><tt class='parameter'>length</tt></i> parameters. </p> </div> <a name='function.mb-strcut.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.mb-substr.php' class='function' rel='rdfs-seeAlso'>mb_substr()</a> - Get part of string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</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="mb_split" value="<div id='function.mb-split' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-split.php'>mb_split</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_split</span> &amp;mdash; <span class='dc-title'>Split multibyte string using regular expression</span></p> </div> <a name='function.mb-split.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>mb_split</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$limit</tt><span class='initializer'> = -1</span></span> ] )</div> <p class='simpara'> Split a multibyte <i><tt class='parameter'>string</tt></i> using regular expression <i><tt class='parameter'>pattern</tt></i> and returns the result as an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a>. </p> </div> <a name='function.mb-split.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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The regular expression pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being split. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>limit</tt></i> </span> </dt><dd class='listitem'> <span class='simpara'> If optional parameter <i><tt class='parameter'>limit</tt></i> is specified, it will be split in <i><tt class='parameter'>limit</tt></i> elements as maximum. </span> </dd> </dl> <p> </p> </div> <a name='function.mb-split.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The result as an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a>. </p> </div> <a name='function.mb-split.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-split.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg.php' class='function' rel='rdfs-seeAlso'>mb_ereg()</a> - Regular expression match with multibyte support</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="mb_send_mail" value="<div id='function.mb-send-mail' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-send-mail.php'>mb_send_mail</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_send_mail</span> &amp;mdash; <span class='dc-title'>Send encoded mail</span></p> </div> <a name='function.mb-send-mail.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>mb_send_mail</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$to</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$subject</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$message</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$additional_headers</tt><span class='initializer'> = NULL</span></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$additional_parameter</tt><span class='initializer'> = NULL</span></span> ]] )</div> <p class='para rdfs-comment'> Sends email. Headers and messages are converted and encoded according to the <a href='http://www.php.net/manual/pt_BR/function.mb-language.php' class='function'>mb_language()</a> setting. It&amp;#039;s a wrapper function for <a href='http://www.php.net/manual/pt_BR/function.mail.php' class='function'>mail()</a>, so see also <a href='http://www.php.net/manual/pt_BR/function.mail.php' class='function'>mail()</a> for details. </p> </div> <a name='function.mb-send-mail.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'>to</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The mail addresses being sent to. Multiple recipients may be specified by putting a comma between each address in <i><tt class='parameter'>to</tt></i> . This parameter is not automatically encoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>subject</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The subject of the mail. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>message</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The message of the mail. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>additional_headers</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>additional_headers</tt></i> is inserted at the end of the header. This is typically used to add extra headers. Multiple extra headers are separated with a newline (&amp;quot;\n&amp;quot;). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>additional_parameter</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>additional_parameter</tt></i> is a MTA command line parameter. It is useful when setting the correct Return-Path header when using sendmail. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-send-mail.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.mb-send-mail.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.0.0</td> <td align='left'> The <i>Content-Type</i> and <i>Content-Transfer-Encoding</i> headers may be redefined as of PHP 5.0.0. Before this time, the values defined by <a href='http://www.php.net/manual/pt_BR/function.mb-language.php' class='function'>mb_language()</a> are always used. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mb-send-mail.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.mail.php' class='function' rel='rdfs-seeAlso'>mail()</a> - Envia email</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-encode-mimeheader.php' class='function' rel='rdfs-seeAlso'>mb_encode_mimeheader()</a> - Encode string for MIME header</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-language.php' class='function' rel='rdfs-seeAlso'>mb_language()</a> - Set/Get current language</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="mb_regex_set_options" value="<div id='function.mb-regex-set-options' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-regex-set-options.php'>mb_regex_set_options</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_regex_set_options</span> &amp;mdash; <span class='dc-title'>Set/Get the default options for mbregex functions</span></p> </div> <a name='function.mb-regex-set-options.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>mb_regex_set_options</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$options</tt><span class='initializer'> = &amp;quot;msr&amp;quot;</span></span> ] )</div> <p class='simpara'> Sets the default options described by <i><tt class='parameter'>options</tt></i> for multibyte regex functions. </p> </div> <a name='function.mb-regex-set-options.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'>options</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The options to set. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-regex-set-options.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The previous options. If <i><tt class='parameter'>options</tt></i> is omitted, it returns the <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> that describes the current options. </p> </div> <a name='function.mb-regex-set-options.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.mb-split.php' class='function' rel='rdfs-seeAlso'>mb_split()</a> - Split multibyte string using regular expression</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg.php' class='function' rel='rdfs-seeAlso'>mb_ereg()</a> - Regular expression match with multibyte support</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-eregi.php' class='function' rel='rdfs-seeAlso'>mb_eregi()</a> - Regular expression match ignoring case with multibyte support</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="mb_regex_encoding" value="<div id='function.mb-regex-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-regex-encoding.php'>mb_regex_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_regex_encoding</span> &amp;mdash; <span class='dc-title'>Returns current encoding for multibyte regex as string</span></p> </div> <a name='function.mb-regex-encoding.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>mb_regex_encoding</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ] )</div> <p class='para rdfs-comment'> Returns the current encoding for a multibyte regex as a <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-regex-encoding.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'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-regex-encoding.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> Returns the character encoding used by multibyte regex functions. </p> </div> <a name='function.mb-regex-encoding.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.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg.php' class='function' rel='rdfs-seeAlso'>mb_ereg()</a> - Regular expression match with multibyte support</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="mb_preferred_mime_name" value="<div id='function.mb-preferred-mime-name' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-preferred-mime-name.php'>mb_preferred_mime_name</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_preferred_mime_name</span> &amp;mdash; <span class='dc-title'>Get MIME charset string</span></p> </div> <a name='function.mb-preferred-mime-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>mb_preferred_mime_name</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> )</div> <p class='para rdfs-comment'> Get a MIME charset <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> for a specific encoding. </p> </div> <a name='function.mb-preferred-mime-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'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The encoding being checked. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-preferred-mime-name.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The MIME <i>charset</i> <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> for character encoding <i><tt class='parameter'>encoding</tt></i> . </p> </div> <a name='function.mb-preferred-mime-name.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_preferred_mime_name()</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 />$outputenc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'sjis-win'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mb_http_output</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$outputenc</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>ob_start</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mb_output_handler'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;text/html;&amp;nbsp;charset='&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mb_preferred_mime_name</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$outputenc</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="mb_parse_str" value="<div id='function.mb-parse-str' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-parse-str.php'>mb_parse_str</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_parse_str</span> &amp;mdash; <span class='dc-title'>Parse GET/POST/COOKIE data and set global variable</span></p> </div> <a name='function.mb-parse-str.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>mb_parse_str</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoded_string</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$result</tt></span> ] )</div> <p class='para rdfs-comment'> Parses GET/POST/COOKIE data and sets global variables. Since PHP does not provide raw POST/COOKIE data, it can only be used for GET data for now. It parses URL encoded data, detects encoding, converts coding to internal encoding and set values to the <i><tt class='parameter'>result</tt></i> <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> or global variables. </p> </div> <a name='function.mb-parse-str.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'>encoded_string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The URL encoded data. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>result</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> containing decoded and character encoded converted values. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-parse-str.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.mb-parse-str.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.mb-detect-order.php' class='function' rel='rdfs-seeAlso'>mb_detect_order()</a> - Set/Get character encoding detection order</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</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="mb_output_handler" value="<div id='function.mb-output-handler' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-output-handler.php'>mb_output_handler</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_output_handler</span> &amp;mdash; <span class='dc-title'>Callback function converts character encoding in output buffer</span></p> </div> <a name='function.mb-output-handler.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>mb_output_handler</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$contents</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$status</tt></span> )</div> <p class='para rdfs-comment'> <b>mb_output_handler()</b> is <a href='http://www.php.net/manual/pt_BR/function.ob-start.php' class='function'>ob_start()</a> callback function. <b>mb_output_handler()</b> converts characters in the output buffer from internal character encoding to HTTP output character encoding. </p> </div> <a name='function.mb-output-handler.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'>contents</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The contents of the output buffer. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>status</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The status of the output buffer. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-output-handler.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The converted <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-output-handler.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.1.0</td> <td align='left'> <p class='para'> This handler now adds the charset HTTP header when the following conditions are met: </p> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> Does not set <i>Content-Type</i>, using <a href='http://www.php.net/manual/pt_BR/function.header.php' class='function'>header()</a>. </span> </li> <li class='listitem'> <span class='simpara'> The default MIME type begins with <i>text/</i>. </span> </li> <li class='listitem'> <span class='simpara'> The <a href='http://www.php.net/manual/pt_BR/mbstring.configuration.php#ini.mbstring.http-input' class='link'>mbstring.http_input</a> setting is something other than <i>pass</i>. </span> </li> </ul><p> </p> </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mb-output-handler.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_output_handler()</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 />mb_http_output</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'UTF-8'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>ob_start</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mb_output_handler'</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.mb-output-handler.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: If you want to output some binary data such as image from PHP script with PHP 4.3.0 or later, Content-Type: header must be send using <a href='http://www.php.net/manual/pt_BR/function.header.php' class='function'>header()</a> before any binary data was send to client (e.g. header(&amp;quot;Content-Type: image/png&amp;quot;)). If Content-Type: header was send, output character encoding conversion will not be performed. <br /> Note that if &amp;#039;Content-Type: text/*&amp;#039; was send using <a href='http://www.php.net/manual/pt_BR/function.header.php' class='function'>header()</a>, the sending data is regarded as text, encoding conversion will be performed using character encoding settings. <br /> If you want to output some binary data such as image from PHP script with PHP 4.2.x or earlier, you must set output encoding to &amp;quot;pass&amp;quot; using <a href='http://www.php.net/manual/pt_BR/function.mb-http-output.php' class='function'>mb_http_output()</a>. <br /> </p></blockquote> </div> <a name='function.mb-output-handler.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.ob-start.php' class='function' rel='rdfs-seeAlso'>ob_start()</a> - Ativa o buffer de sa&amp;iacute;da</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="mb_list_encodings" value="<div id='function.mb-list-encodings' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-list-encodings.php'>mb_list_encodings</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>mb_list_encodings</span> &amp;mdash; <span class='dc-title'>Returns an array of all supported encodings</span></p> </div> <a name='function.mb-list-encodings.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>mb_list_encodings</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Returns an array containing all supported encodings. </p> </div> <a name='function.mb-list-encodings.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='function.mb-list-encodings.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a numerically indexed array. </p> </div> <a name='function.mb-list-encodings.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> This function does not emit any errors. </p> </div> <a name='function.mb-list-encodings.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_list_encodings()</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 /><br />print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>mb_list_encodings</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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Array ( [0] =&amp;gt; pass [1] =&amp;gt; auto [2] =&amp;gt; wchar [3] =&amp;gt; byte2be [4] =&amp;gt; byte2le [5] =&amp;gt; byte4be [6] =&amp;gt; byte4le [7] =&amp;gt; BASE64 [8] =&amp;gt; UUENCODE [9] =&amp;gt; HTML-ENTITIES [10] =&amp;gt; Quoted-Printable [11] =&amp;gt; 7bit [12] =&amp;gt; 8bit [13] =&amp;gt; UCS-4 [14] =&amp;gt; UCS-4BE [15] =&amp;gt; UCS-4LE [16] =&amp;gt; UCS-2 [17] =&amp;gt; UCS-2BE [18] =&amp;gt; UCS-2LE [19] =&amp;gt; UTF-32 [20] =&amp;gt; UTF-32BE [21] =&amp;gt; UTF-32LE [22] =&amp;gt; UTF-16 [23] =&amp;gt; UTF-16BE [24] =&amp;gt; UTF-16LE [25] =&amp;gt; UTF-8 [26] =&amp;gt; UTF-7 [27] =&amp;gt; UTF7-IMAP [28] =&amp;gt; ASCII [29] =&amp;gt; EUC-JP [30] =&amp;gt; SJIS [31] =&amp;gt; eucJP-win [32] =&amp;gt; SJIS-win [33] =&amp;gt; JIS [34] =&amp;gt; ISO-2022-JP [35] =&amp;gt; Windows-1252 [36] =&amp;gt; ISO-8859-1 [37] =&amp;gt; ISO-8859-2 [38] =&amp;gt; ISO-8859-3 [39] =&amp;gt; ISO-8859-4 [40] =&amp;gt; ISO-8859-5 [41] =&amp;gt; ISO-8859-6 [42] =&amp;gt; ISO-8859-7 [43] =&amp;gt; ISO-8859-8 [44] =&amp;gt; ISO-8859-9 [45] =&amp;gt; ISO-8859-10 [46] =&amp;gt; ISO-8859-13 [47] =&amp;gt; ISO-8859-14 [48] =&amp;gt; ISO-8859-15 [49] =&amp;gt; EUC-CN [50] =&amp;gt; CP936 [51] =&amp;gt; HZ [52] =&amp;gt; EUC-TW [53] =&amp;gt; BIG-5 [54] =&amp;gt; EUC-KR [55] =&amp;gt; UHC [56] =&amp;gt; ISO-2022-KR [57] =&amp;gt; Windows-1251 [58] =&amp;gt; CP866 [59] =&amp;gt; KOI8-R ) </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="mb_language" value="<div id='function.mb-language' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-language.php'>mb_language</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_language</span> &amp;mdash; <span class='dc-title'>Set/Get current language</span></p> </div> <a name='function.mb-language.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>mb_language</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$language</tt></span> ] )</div> <p class='para rdfs-comment'> Set/Get the current language. </p> </div> <a name='function.mb-language.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'>language</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Used for encoding e-mail messages. Valid languages are &amp;quot;Japanese&amp;quot;, &amp;quot;ja&amp;quot;,&amp;quot;English&amp;quot;,&amp;quot;en&amp;quot; and &amp;quot;uni&amp;quot; (UTF-8). <a href='http://www.php.net/manual/pt_BR/function.mb-send-mail.php' class='function'>mb_send_mail()</a> uses this setting to encode e-mail. </p> <p class='para'> Language and its setting is ISO-2022-JP/Base64 for Japanese, UTF-8/Base64 for uni, ISO-8859-1/quoted printable for English. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-language.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> If <i><tt class='parameter'>language</tt></i> is set and <i><tt class='parameter'>language</tt></i> is valid, it returns <b><tt class='constant'>TRUE</tt></b>. Otherwise, it returns <b><tt class='constant'>FALSE</tt></b>. When <i><tt class='parameter'>language</tt></i> is omitted, it returns the language name as a <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. If no language is set previously, it then returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-language.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.mb-send-mail.php' class='function' rel='rdfs-seeAlso'>mb_send_mail()</a> - Send encoded mail</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="mb_internal_encoding" value="<div id='function.mb-internal-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-internal-encoding.php'>mb_internal_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_internal_encoding</span> &amp;mdash; <span class='dc-title'>Set/Get internal character encoding</span></p> </div> <a name='function.mb-internal-encoding.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>mb_internal_encoding</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt><span class='initializer'> = mb_internal_encoding()</span></span> ] )</div> <p class='para rdfs-comment'> Set/Get the internal character encoding </p> </div> <a name='function.mb-internal-encoding.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'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>encoding</tt></i> is the character encoding name used for the HTTP input character encoding conversion, HTTP output character encoding conversion, and the default character encoding for string functions defined by the mbstring module. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-internal-encoding.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> If <i><tt class='parameter'>encoding</tt></i> is set, then Retorna <b><tt class='constant'>TRUE</tt></b> em caso de sucesso ou <b><tt class='constant'>FALSE</tt></b> em falhas. If <i><tt class='parameter'>encoding</tt></i> is omitted, then the current character encoding name is returned. </p> </div> <a name='function.mb-internal-encoding.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_internal_encoding()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Set&amp;nbsp;internal&amp;nbsp;character&amp;nbsp;encoding&amp;nbsp;to&amp;nbsp;UTF-8&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mb_internal_encoding</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'UTF-8'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Display&amp;nbsp;current&amp;nbsp;internal&amp;nbsp;character&amp;nbsp;encoding&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mb_internal_encoding</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.mb-internal-encoding.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-internal-encoding.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.mb-http-input.php' class='function' rel='rdfs-seeAlso'>mb_http_input()</a> - Detect HTTP input character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-http-output.php' class='function' rel='rdfs-seeAlso'>mb_http_output()</a> - Set/Get HTTP output character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-detect-order.php' class='function' rel='rdfs-seeAlso'>mb_detect_order()</a> - Set/Get character encoding detection order</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="mb_http_output" value="<div id='function.mb-http-output' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-http-output.php'>mb_http_output</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_http_output</span> &amp;mdash; <span class='dc-title'>Set/Get HTTP output character encoding</span></p> </div> <a name='function.mb-http-output.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>mb_http_output</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ] )</div> <p class='para rdfs-comment'> Set/Get the HTTP output character encoding. Output after this function is converted to <i><tt class='parameter'>encoding</tt></i> . </p> </div> <a name='function.mb-http-output.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'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If <i><tt class='parameter'>encoding</tt></i> is set, <b>mb_http_output()</b> sets the HTTP output character encoding to <i><tt class='parameter'>encoding</tt></i> . </p> <p class='para'> If <i><tt class='parameter'>encoding</tt></i> is omitted, <b>mb_http_output()</b> returns the current HTTP output character encoding. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-http-output.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> If <i><tt class='parameter'>encoding</tt></i> is omitted, <b>mb_http_output()</b> returns the current HTTP output character encoding. Otherwise, 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.mb-http-output.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.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-http-input.php' class='function' rel='rdfs-seeAlso'>mb_http_input()</a> - Detect HTTP input character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-detect-order.php' class='function' rel='rdfs-seeAlso'>mb_detect_order()</a> - Set/Get character encoding detection order</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="mb_http_input" value="<div id='function.mb-http-input' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-http-input.php'>mb_http_input</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_http_input</span> &amp;mdash; <span class='dc-title'>Detect HTTP input character encoding</span></p> </div> <a name='function.mb-http-input.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>mb_http_input</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$type</tt><span class='initializer'> = &amp;quot;&amp;quot;</span></span> ] )</div> <p class='simpara'> Detects the HTTP input character encoding. </p> </div> <a name='function.mb-http-input.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'>type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Input string specifies the input type. &amp;quot;G&amp;quot; for GET, &amp;quot;P&amp;quot; for POST, &amp;quot;C&amp;quot; for COOKIE, &amp;quot;S&amp;quot; for string, &amp;quot;L&amp;quot; for list, and &amp;quot;I&amp;quot; for the whole list (will return <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a>). If type is omitted, it returns the last input type processed. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-http-input.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The character encoding name, as per the <i><tt class='parameter'>type</tt></i> . If <b>mb_http_input()</b> does not process specified HTTP input, it returns <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.mb-http-input.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.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-http-output.php' class='function' rel='rdfs-seeAlso'>mb_http_output()</a> - Set/Get HTTP output character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-detect-order.php' class='function' rel='rdfs-seeAlso'>mb_detect_order()</a> - Set/Get character encoding detection order</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="mb_get_info" value="<div id='function.mb-get-info' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-get-info.php'>mb_get_info</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_get_info</span> &amp;mdash; <span class='dc-title'>Get internal settings of mbstring</span></p> </div> <a name='function.mb-get-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'><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>mb_get_info</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$type</tt><span class='initializer'> = &amp;quot;all&amp;quot;</span></span> ] )</div> <p class='simpara'> <b>mb_get_info()</b> returns the internal setting parameters of mbstring. </p> </div> <a name='function.mb-get-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'>type</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If <i><tt class='parameter'>type</tt></i> isn&amp;#039;t specified or is specified to &amp;quot;all&amp;quot;, an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> having the elements &amp;quot;internal_encoding&amp;quot;, &amp;quot;http_output&amp;quot;, &amp;quot;http_input&amp;quot;, &amp;quot;func_overload&amp;quot;, &amp;quot;mail_charset&amp;quot;, &amp;quot;mail_header_encoding&amp;quot;, &amp;quot;mail_body_encoding&amp;quot; will be returned. </p> <p class='para'> If <i><tt class='parameter'>type</tt></i> is specified as &amp;quot;http_output&amp;quot;, &amp;quot;http_input&amp;quot;, &amp;quot;internal_encoding&amp;quot;, &amp;quot;func_overload&amp;quot;, the specified setting parameter will be returned. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-get-info.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> of type information if <i><tt class='parameter'>type</tt></i> is not specified, otherwise a specific <i><tt class='parameter'>type</tt></i> . </p> </div> <a name='function.mb-get-info.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.1.3</td> <td align='left'> The entries &amp;quot;mail_charset&amp;quot;, &amp;quot;mail_header_encoding&amp;quot;, and &amp;quot;mail_body_encoding&amp;quot; were made available. </td> </tr> <tr valign='middle'> <td align='left'>5.3.0</td> <td align='left'> The entry &amp;quot;http_output_conv_mimetypes&amp;quot; was made available. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mb-get-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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-http-output.php' class='function' rel='rdfs-seeAlso'>mb_http_output()</a> - Set/Get HTTP output character encoding</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="mb_ereg_search_setpos" value="<div id='function.mb-ereg-search-setpos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search-setpos.php'>mb_ereg_search_setpos</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search_setpos</span> &amp;mdash; <span class='dc-title'>Set start point of next regular expression match</span></p> </div> <a name='function.mb-ereg-search-setpos.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>mb_ereg_search_setpos</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$position</tt></span> )</div> <p class='simpara'> <b>mb_ereg_search_setpos()</b> sets the starting point of a match for <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search.php' class='function'>mb_ereg_search()</a>. </p> </div> <a name='function.mb-ereg-search-setpos.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'>position</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The position to set. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-search-setpos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> 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.mb-ereg-search-setpos.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search-setpos.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_init()</a> - Setup string and regular expression for a multibyte regular expression match</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="mb_ereg_search_regs" value="<div id='function.mb-ereg-search-regs' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search-regs.php'>mb_ereg_search_regs</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search_regs</span> &amp;mdash; <span class='dc-title'>Returns the matched part of a multibyte regular expression</span></p> </div> <a name='function.mb-ereg-search-regs.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>mb_ereg_search_regs</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;ms&amp;quot;</span></span> ]] )</div> <p class='para rdfs-comment'> Returns the matched part of a multibyte regular expression. </p> </div> <a name='function.mb-ereg-search-regs.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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search option. Defaults to &amp;#039;ms&amp;#039;. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-search-regs.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> <b>mb_ereg_search_regs()</b> executes the multibyte regular expression match, and if there are some matched part, it returns an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> including substring of matched part as first element, the first grouped part with brackets as second element, the second grouped part as third element, and so on. It returns <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.mb-ereg-search-regs.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search-regs.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_init()</a> - Setup string and regular expression for a multibyte regular expression match</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="mb_ereg_search_pos" value="<div id='function.mb-ereg-search-pos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search-pos.php'>mb_ereg_search_pos</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search_pos</span> &amp;mdash; <span class='dc-title'>Returns position and length of a matched part of the multibyte regular expression for a predefined multibyte string</span></p> </div> <a name='function.mb-ereg-search-pos.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>mb_ereg_search_pos</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;ms&amp;quot;</span></span> ]] )</div> <p class='para rdfs-comment'> Returns position and length of a matched part of the multibyte regular expression for a predefined multibyte string </p> <p class='para'> The string for match is specified by <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function'>mb_ereg_search_init()</a>. If it is not specified, the previous one will be used. </p> </div> <a name='function.mb-ereg-search-pos.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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search option. Defaults to &amp;#039;ms&amp;#039;. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-search-pos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> An <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> including the position of a matched part for a multibyte regular expression. The first element of the array will be the beginning of matched part, the second element will be length (bytes) of matched part. It returns <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.mb-ereg-search-pos.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search-pos.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_init()</a> - Setup string and regular expression for a multibyte regular expression match</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="mb_ereg_search_init" value="<div id='function.mb-ereg-search-init' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search-init.php'>mb_ereg_search_init</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search_init</span> &amp;mdash; <span class='dc-title'>Setup string and regular expression for a multibyte regular expression match</span></p> </div> <a name='function.mb-ereg-search-init.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>mb_ereg_search_init</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;msr&amp;quot;</span></span> ]] )</div> <p class='para rdfs-comment'> <b>mb_ereg_search_init()</b> sets <i><tt class='parameter'>string</tt></i> and <i><tt class='parameter'>pattern</tt></i> for a multibyte regular expression. These values are used for <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search.php' class='function'>mb_ereg_search()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-pos.php' class='function'>mb_ereg_search_pos()</a>, and <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-regs.php' class='function'>mb_ereg_search_regs()</a>. </p> </div> <a name='function.mb-ereg-search-init.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search option. Defaults to &amp;#039;ms&amp;#039;. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-search-init.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> 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.mb-ereg-search-init.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search-init.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-regs.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_regs()</a> - Returns the matched part of a multibyte regular expression</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="mb_ereg_search_getregs" value="<div id='function.mb-ereg-search-getregs' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search-getregs.php'>mb_ereg_search_getregs</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search_getregs</span> &amp;mdash; <span class='dc-title'>Retrieve the result from the last multibyte regular expression match</span></p> </div> <a name='function.mb-ereg-search-getregs.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>mb_ereg_search_getregs</b></span> ( <span class='methodparam'>void</span> )</div> <p class='simpara'> Retrieve the result from the last multibyte regular expression match </p> </div> <a name='function.mb-ereg-search-getregs.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='function.mb-ereg-search-getregs.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> An <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> including the sub-string of matched part by last <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search.php' class='function'>mb_ereg_search()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-pos.php' class='function'>mb_ereg_search_pos()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-regs.php' class='function'>mb_ereg_search_regs()</a>. If there are some matches, the first element will have the matched sub-string, the second element will have the first part grouped with brackets, the third element will have the second part grouped with brackets, and so on. It returns <b><tt class='constant'>FALSE</tt></b> on error; </p> </div> <a name='function.mb-ereg-search-getregs.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search-getregs.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_init()</a> - Setup string and regular expression for a multibyte regular expression match</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="mb_ereg_search_getpos" value="<div id='function.mb-ereg-search-getpos' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search-getpos.php'>mb_ereg_search_getpos</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search_getpos</span> &amp;mdash; <span class='dc-title'>Returns start point for next regular expression match</span></p> </div> <a name='function.mb-ereg-search-getpos.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>mb_ereg_search_getpos</b></span> ( <span class='methodparam'>void</span> )</div> <p class='simpara'> Returns the start point for the next regular expression match. </p> </div> <a name='function.mb-ereg-search-getpos.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='function.mb-ereg-search-getpos.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> <b>mb_ereg_search_getpos()</b> returns the point to start regular expression match for <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search.php' class='function'>mb_ereg_search()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-pos.php' class='function'>mb_ereg_search_pos()</a>, <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-regs.php' class='function'>mb_ereg_search_regs()</a>. The position is represented by bytes from the head of string. </p> </div> <a name='function.mb-ereg-search-getpos.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search-getpos.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-setpos.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_setpos()</a> - Set start point of next regular expression match</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="mb_ereg_search" value="<div id='function.mb-ereg-search' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-search.php'>mb_ereg_search</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_search</span> &amp;mdash; <span class='dc-title'>Multibyte regular expression match for predefined multibyte string</span></p> </div> <a name='function.mb-ereg-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'>bool</span> <span class='methodname'><b>mb_ereg_search</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;ms&amp;quot;</span></span> ]] )</div> <p class='para rdfs-comment'> Performs a multibyte regular expression match for a predefined multibyte string. </p> </div> <a name='function.mb-ereg-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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search option. Defaults to &amp;#039;ms&amp;#039;. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-search.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> <b>mb_ereg_search()</b> returns <b><tt class='constant'>TRUE</tt></b> if the multibyte string matches with the regular expression, or <b><tt class='constant'>FALSE</tt></b> otherwise. The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> for matching is set by <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function'>mb_ereg_search_init()</a>. If <i><tt class='parameter'>pattern</tt></i> is not specified, the previous one is used. </p> </div> <a name='function.mb-ereg-search.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-search.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-search-init.php' class='function' rel='rdfs-seeAlso'>mb_ereg_search_init()</a> - Setup string and regular expression for a multibyte regular expression match</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="mb_ereg_replace" value="<div id='function.mb-ereg-replace' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-replace.php'>mb_ereg_replace</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_replace</span> &amp;mdash; <span class='dc-title'>Replace regular expression with multibyte support</span></p> </div> <a name='function.mb-ereg-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'>string</span> <span class='methodname'><b>mb_ereg_replace</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$replacement</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;msr&amp;quot;</span></span> ] )</div> <p class='simpara'> Scans <i><tt class='parameter'>string</tt></i> for matches to <i><tt class='parameter'>pattern</tt></i> , then replaces the matched text with <i><tt class='parameter'>replacement</tt></i> </p> </div> <a name='function.mb-ereg-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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The regular expression pattern. </p> <p class='para'> Multibyte characters may be used in <i><tt class='parameter'>pattern</tt></i> . </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>replacement</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The replacement text. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being checked. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <span class='simpara'> Matching condition can be set by <i><tt class='parameter'>option</tt></i> parameter. If <i>i</i> is specified for this parameter, the case will be ignored. If <i>x</i> is specified, white space will be ignored. If <i>m</i> is specified, match will be executed in multiline mode and line break will be included in &amp;#039;.&amp;#039;. If <i>p</i> is specified, match will be executed in POSIX mode, line break will be considered as normal character. If <i>e</i> is specified, <i><tt class='parameter'>replacement</tt></i> string will be evaluated as PHP expression. </span> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-replace.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The resultant <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> on success, or <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.mb-ereg-replace.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> <div class='warning'><b class='warning'>Aviso</b><p class='para'>Jamais use o modificador <i>e</i> ao usar com entrada n&amp;atilde;o confiavel. N&amp;atilde;o ser&amp;aacute; escapado automaticamente (como conhecido da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.preg-replace.php' class='function'>preg_replace()</a>). N&amp;atilde;o ter cuidado com isso ir&amp;aacute; provavelmente criar vulnerabilidades de execu&amp;ccedil;&amp;atilde;o remota de c&amp;oacute;digo na sua aplica&amp;ccedil;&amp;atilde;o.</p></div> </div> <a name='function.mb-ereg-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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-eregi-replace.php' class='function' rel='rdfs-seeAlso'>mb_eregi_replace()</a> - Replace regular expression with multibyte support ignoring case</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="mb_ereg_match" value="<div id='function.mb-ereg-match' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg-match.php'>mb_ereg_match</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg_match</span> &amp;mdash; <span class='dc-title'>Regular expression match for multibyte string</span></p> </div> <a name='function.mb-ereg-match.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>mb_ereg_match</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;msr&amp;quot;</span></span> ] )</div> <p class='para rdfs-comment'> A regular expression match for a multibyte string </p> </div> <a name='function.mb-ereg-match.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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The regular expression pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being evaluated. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg-match.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> Returns <b><tt class='constant'>TRUE</tt></b> if <i><tt class='parameter'>string</tt></i> matches the regular expression <i><tt class='parameter'>pattern</tt></i> , <b><tt class='constant'>FALSE</tt></b> if not. </p> </div> <a name='function.mb-ereg-match.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg-match.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg.php' class='function' rel='rdfs-seeAlso'>mb_ereg()</a> - Regular expression match with multibyte support</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="mb_eregi_replace" value="<div id='function.mb-eregi-replace' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-eregi-replace.php'>mb_eregi_replace</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_eregi_replace</span> &amp;mdash; <span class='dc-title'>Replace regular expression with multibyte support ignoring case</span></p> </div> <a name='function.mb-eregi-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'>string</span> <span class='methodname'><b>mb_eregi_replace</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$replace</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt><span class='initializer'> = &amp;quot;msri&amp;quot;</span></span> ] )</div> <p class='simpara'> Scans <i><tt class='parameter'>string</tt></i> for matches to <i><tt class='parameter'>pattern</tt></i> , then replaces the matched text with <i><tt class='parameter'>replacement</tt></i> . </p> </div> <a name='function.mb-eregi-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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The regular expression pattern. Multibyte characters may be used. The case will be ignored. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>replace</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The replacement text. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The searched <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <span class='simpara'> <i><tt class='parameter'>option</tt></i> has the same meaning as in <a href='http://www.php.net/manual/pt_BR/function.mb-ereg-replace.php' class='function'>mb_ereg_replace()</a>. </span> </dd> </dl> <p> </p> </div> <a name='function.mb-eregi-replace.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The resultant <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> or <b><tt class='constant'>FALSE</tt></b> on error. </p> </div> <a name='function.mb-eregi-replace.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> <div class='warning'><b class='warning'>Aviso</b><p class='para'>Jamais use o modificador <i>e</i> ao usar com entrada n&amp;atilde;o confiavel. N&amp;atilde;o ser&amp;aacute; escapado automaticamente (como conhecido da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.preg-replace.php' class='function'>preg_replace()</a>). N&amp;atilde;o ter cuidado com isso ir&amp;aacute; provavelmente criar vulnerabilidades de execu&amp;ccedil;&amp;atilde;o remota de c&amp;oacute;digo na sua aplica&amp;ccedil;&amp;atilde;o.</p></div> </div> <a name='function.mb-eregi-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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg-replace.php' class='function' rel='rdfs-seeAlso'>mb_ereg_replace()</a> - Replace regular expression with multibyte support</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="mb_eregi" value="<div id='function.mb-eregi' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-eregi.php'>mb_eregi</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_eregi</span> &amp;mdash; <span class='dc-title'>Regular expression match ignoring case with multibyte support</span></p> </div> <a name='function.mb-eregi.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>mb_eregi</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$regs</tt></span> ] )</div> <p class='simpara'> Executes the case insensitive regular expression match with multibyte support. </p> </div> <a name='function.mb-eregi.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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The regular expression pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being searched. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>regs</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Contains a substring of the matched <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-eregi.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> Executes the regular expression match with multibyte support, and returns <i>1</i> if matches are found. If the optional <i><tt class='parameter'>regs</tt></i> parameter was specified, the function returns the byte length of matched part, and the <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> <i><tt class='parameter'>regs</tt></i> will contain the substring of matched string. The function returns <i>1</i> if it matches with the empty string. If no matches are found or an error happens, <b><tt class='constant'>FALSE</tt></b> will be returned. </p> </div> <a name='function.mb-eregi.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-eregi.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-ereg.php' class='function' rel='rdfs-seeAlso'>mb_ereg()</a> - Regular expression match with multibyte support</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="mb_ereg" value="<div id='function.mb-ereg' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-ereg.php'>mb_ereg</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_ereg</span> &amp;mdash; <span class='dc-title'>Regular expression match with multibyte support</span></p> </div> <a name='function.mb-ereg.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>mb_ereg</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$pattern</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$regs</tt></span> ] )</div> <p class='simpara'> Executes the regular expression match with multibyte support. </p> </div> <a name='function.mb-ereg.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'>pattern</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search pattern. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The search <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>regs</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Contains a substring of the matched <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-ereg.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='simpara'> Executes the regular expression match with multibyte support, and returns <i>1</i> if matches are found. If the optional <i><tt class='parameter'>regs</tt></i> parameter was specified, the function returns the byte length of matched part, and the <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> <i><tt class='parameter'>regs</tt></i> will contain the substring of matched string. The function returns <i>1</i> if it matches with the empty string. If no matches are found or an error happens, <b><tt class='constant'>FALSE</tt></b> will be returned. </p> </div> <a name='function.mb-ereg.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A codifica&amp;ccedil;&amp;atilde;o interna ou a codifica&amp;ccedil;&amp;atilde;o de caractere especificado por <a href='http://www.php.net/manual/pt_BR/function.mb-regex-encoding.php' class='function'>mb_regex_encoding()</a> ser&amp;aacute; usado como a codifica&amp;ccedil;&amp;atilde;o de caractere para esta fun&amp;ccedil;&amp;atilde;o.<br /></p></blockquote> </div> <a name='function.mb-ereg.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.mb-regex-encoding.php' class='function' rel='rdfs-seeAlso'>mb_regex_encoding()</a> - Returns current encoding for multibyte regex as string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-eregi.php' class='function' rel='rdfs-seeAlso'>mb_eregi()</a> - Regular expression match ignoring case with multibyte support</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="mb_encode_numericentity" value="<div id='function.mb-encode-numericentity' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-encode-numericentity.php'>mb_encode_numericentity</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_encode_numericentity</span> &amp;mdash; <span class='dc-title'>Encode character to HTML numeric string reference</span></p> </div> <a name='function.mb-encode-numericentity.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>mb_encode_numericentity</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$convmap</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> )</div> <p class='para rdfs-comment'> Converts specified character codes in <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> from HTML numeric character reference to character code. </p> </div> <a name='function.mb-encode-numericentity.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being encoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>convmap</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>convmap</tt></i> is array specifies code area to convert. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-encode-numericentity.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The converted <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-encode-numericentity.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <i><tt class='parameter'>convmap</tt></i> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> $convmap&amp;nbsp;=&amp;nbsp;array&amp;nbsp;(<br />&amp;nbsp;int&amp;nbsp;start_code1,&amp;nbsp;int&amp;nbsp;end_code1,&amp;nbsp;int&amp;nbsp;offset1,&amp;nbsp;int&amp;nbsp;mask1,<br />&amp;nbsp;int&amp;nbsp;start_code2,&amp;nbsp;int&amp;nbsp;end_code2,&amp;nbsp;int&amp;nbsp;offset2,&amp;nbsp;int&amp;nbsp;mask2,<br />&amp;nbsp;........<br />&amp;nbsp;int&amp;nbsp;start_codeN,&amp;nbsp;int&amp;nbsp;end_codeN,&amp;nbsp;int&amp;nbsp;offsetN,&amp;nbsp;int&amp;nbsp;maskN&amp;nbsp;);<br />//&amp;nbsp;Specify&amp;nbsp;Unicode&amp;nbsp;value&amp;nbsp;for&amp;nbsp;start_codeN&amp;nbsp;and&amp;nbsp;end_codeN<br />//&amp;nbsp;Add&amp;nbsp;offsetN&amp;nbsp;to&amp;nbsp;value&amp;nbsp;and&amp;nbsp;take&amp;nbsp;bit-wise&amp;nbsp;'AND'&amp;nbsp;with&amp;nbsp;maskN,&amp;nbsp;then<br />//&amp;nbsp;it&amp;nbsp;converts&amp;nbsp;value&amp;nbsp;to&amp;nbsp;numeric&amp;nbsp;string&amp;nbsp;reference.</span> </code></div> </div> </div><p> </p> </div> <a name='function.mb-encode-numericentity.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 <b>mb_encode_numericentity()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;Left&amp;nbsp;side&amp;nbsp;of&amp;nbsp;ISO-8859-1&amp;nbsp;to&amp;nbsp;HTML&amp;nbsp;numeric&amp;nbsp;character&amp;nbsp;reference&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$convmap&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #0000BB'>0x80</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xff</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'>0xff</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_encode_numericentity</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$convmap</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ISO-8859-1'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;user&amp;nbsp;defined&amp;nbsp;SJIS-win&amp;nbsp;code&amp;nbsp;in&amp;nbsp;block&amp;nbsp;95-104&amp;nbsp;to&amp;nbsp;numeric<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;string&amp;nbsp;reference&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$convmap&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe000</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe03e</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x1040</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe03f</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe0bb</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x1041</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe0bc</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe0fa</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x1084</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe0fb</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe177</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x1085</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe178</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe1b6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x10c8</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe1b7</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe233</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x10c9</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe234</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe272</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x110c</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe273</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe2ef</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x110d</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe2f0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe32e</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x1150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0xe32f</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xe3ab</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x1151</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xffff&amp;nbsp;</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_encode_numericentity</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$convmap</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'sjis-win'</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.mb-encode-numericentity.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.mb-decode-numericentity.php' class='function' rel='rdfs-seeAlso'>mb_decode_numericentity()</a> - Decode HTML numeric string reference to character</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="mb_encode_mimeheader" value="<div id='function.mb-encode-mimeheader' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-encode-mimeheader.php'>mb_encode_mimeheader</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_encode_mimeheader</span> &amp;mdash; <span class='dc-title'>Encode string for MIME header</span></p> </div> <a name='function.mb-encode-mimeheader.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>mb_encode_mimeheader</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$transfer_encoding</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$linefeed</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$indent</tt></span> ]]]] )</div> <p class='para rdfs-comment'> Encodes a given <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> by the MIME header encoding scheme. </p> </div> <a name='function.mb-encode-mimeheader.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being encoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>charset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>charset</tt></i> specifies the name of the character set in which <i><tt class='parameter'>str</tt></i> is represented in. The default value is determined by the current NLS setting (<i>mbstring.language</i>). <a href='http://www.php.net/manual/pt_BR/function.mb-internal-encoding.php' class='function'>mb_internal_encoding()</a> should be set to same encoding. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>transfer_encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>transfer_encoding</tt></i> specifies the scheme of MIME encoding. It should be either <i>&amp;quot;B&amp;quot;</i> (Base64) or <i>&amp;quot;Q&amp;quot;</i> (Quoted-Printable). Falls back to <i>&amp;quot;B&amp;quot;</i> if not given. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>linefeed</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>linefeed</tt></i> specifies the EOL (end-of-line) marker with which <b>mb_encode_mimeheader()</b> performs line-folding (a <a href='http://www.faqs.org/rfcs/rfc2822' class='link external'>&amp;raquo; RFC</a> term, the act of breaking a line longer than a certain length into multiple lines. The length is currently hard-coded to 74 characters). Falls back to <i>&amp;quot;\r\n&amp;quot;</i> (CRLF) if not given. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>indent</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Indentation of the first line (number of characters in the header before <i><tt class='parameter'>str</tt></i> ). </p> </dd> </dl> <p> </p> </div> <a name='function.mb-encode-mimeheader.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A converted version of the <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> represented in ASCII. </p> </div> <a name='function.mb-encode-mimeheader.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.0.0</td> <td align='left'> The <i><tt class='parameter'>indent</tt></i> parameter was added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mb-encode-mimeheader.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_encode_mimeheader()</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 />$name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;kanji<br /></span><span style='color: #0000BB'>$mbox&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'kru'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$doma&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'gtinn.mon'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$addr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_encode_mimeheader</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'UTF-7'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Q'</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;lt;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$mbox&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'@'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$doma&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;gt;'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$addr</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.mb-encode-mimeheader.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function isn&amp;#039;t designed to break lines at higher-level contextual break points (word boundaries, etc.). This behaviour may clutter up the original string with unexpected spaces. <br /> </p></blockquote> </div> <a name='function.mb-encode-mimeheader.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.mb-decode-mimeheader.php' class='function' rel='rdfs-seeAlso'>mb_decode_mimeheader()</a> - Decode string in MIME header field</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="mb_detect_order" value="<div id='function.mb-detect-order' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-detect-order.php'>mb_detect_order</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_detect_order</span> &amp;mdash; <span class='dc-title'>Set/Get character encoding detection order</span></p> </div> <a name='function.mb-detect-order.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>mb_detect_order</b></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'>$encoding_list</tt></span> ] )</div> <p class='para rdfs-comment'> Sets the automatic character encoding detection order to <i><tt class='parameter'>encoding_list</tt></i> . </p> </div> <a name='function.mb-detect-order.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'>encoding_list</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>encoding_list</tt></i> is an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> or comma separated list of character encoding. (&amp;quot;auto&amp;quot; is expanded to &amp;quot;ASCII, JIS, UTF-8, EUC-JP, SJIS&amp;quot;) </p> <p class='para'> If <i><tt class='parameter'>encoding_list</tt></i> is omitted, it returns the current character encoding detection order as array. </p> <p class='para'> This setting affects <a href='http://www.php.net/manual/pt_BR/function.mb-detect-encoding.php' class='function'>mb_detect_encoding()</a> and <a href='http://www.php.net/manual/pt_BR/function.mb-send-mail.php' class='function'>mb_send_mail()</a>. </p> <p class='para'> <i>mbstring</i> currently implements the following encoding detection filters. If there is an invalid byte sequence for the following encodings, encoding detection will fail. </p> <span class='simpara'> <i>UTF-8</i>, <i>UTF-7</i>, <i>ASCII</i>, <i>EUC-JP</i>,<i>SJIS</i>, <i>eucJP-win</i>, <i>SJIS-win</i>, <i>JIS</i>, <i>ISO-2022-JP</i> </span> <p class='para'> For <i>ISO-8859-*</i>, <i>mbstring</i> always detects as <i>ISO-8859-*</i>. </p> <p class='para'> For <i>UTF-16</i>, <i>UTF-32</i>, <i>UCS2</i> and <i>UCS4</i>, encoding detection will fail always. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Useless detect order example</b></p> <div class='example-contents programlisting'> <div class='cdata'><pre> ; Always detect as ISO-8859-1 detect_order = ISO-8859-1, UTF-8 ; Always detect as UTF-8, since ASCII/UTF-7 values are ; valid for UTF-8 detect_order = UTF-8, ASCII, UTF-7 </pre></div> </div> </div><p> </p> </dd> </dl> <p> </p> </div> <a name='function.mb-detect-order.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.mb-detect-order.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 <b>mb_detect_order()</b> examples</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;Set&amp;nbsp;detection&amp;nbsp;order&amp;nbsp;by&amp;nbsp;enumerated&amp;nbsp;list&amp;nbsp;*/<br /></span><span style='color: #0000BB'>mb_detect_order</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'eucjp-win,sjis-win,UTF-8'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Set&amp;nbsp;detection&amp;nbsp;order&amp;nbsp;by&amp;nbsp;array&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>[]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'ASCII'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>[]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'JIS'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>[]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'EUC-JP'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>mb_detect_order</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Display&amp;nbsp;current&amp;nbsp;detection&amp;nbsp;order&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>implode</span><span style='color: #007700'>(</span><span style='color: #DD0000'>',&amp;nbsp;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>mb_detect_order</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.mb-detect-order.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.mb-internal-encoding.php' class='function' rel='rdfs-seeAlso'>mb_internal_encoding()</a> - Set/Get internal character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-http-input.php' class='function' rel='rdfs-seeAlso'>mb_http_input()</a> - Detect HTTP input character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-http-output.php' class='function' rel='rdfs-seeAlso'>mb_http_output()</a> - Set/Get HTTP output character encoding</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-send-mail.php' class='function' rel='rdfs-seeAlso'>mb_send_mail()</a> - Send encoded mail</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="mb_detect_encoding" value="<div id='function.mb-detect-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-detect-encoding.php'>mb_detect_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_detect_encoding</span> &amp;mdash; <span class='dc-title'>Detect character encoding</span></p> </div> <a name='function.mb-detect-encoding.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>mb_detect_encoding</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</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'>$encoding_list</tt><span class='initializer'> = mb_detect_order()</span></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$strict</tt><span class='initializer'> = false</span></span> ]] )</div> <p class='para rdfs-comment'> Detects character encoding in <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> . </p> </div> <a name='function.mb-detect-encoding.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being detected. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding_list</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>encoding_list</tt></i> is list of character encoding. Encoding order may be specified by array or comma separated list string. </p> <p class='para'> If <i><tt class='parameter'>encoding_list</tt></i> is omitted, detect_order is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>strict</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>strict</tt></i> specifies whether to use the strict encoding detection or not. Default is <b><tt class='constant'>FALSE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-detect-encoding.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The detected character encoding or <b><tt class='constant'>FALSE</tt></b> if the encoding cannot be detected from the given string. </p> </div> <a name='function.mb-detect-encoding.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_detect_encoding()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Detect&amp;nbsp;character&amp;nbsp;encoding&amp;nbsp;with&amp;nbsp;current&amp;nbsp;detect_order&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mb_detect_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;'auto'&amp;nbsp;is&amp;nbsp;expanded&amp;nbsp;to&amp;nbsp;'ASCII,JIS,UTF-8,EUC-JP,SJIS'&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mb_detect_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'auto'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Specify&amp;nbsp;encoding_list&amp;nbsp;character&amp;nbsp;encoding&amp;nbsp;by&amp;nbsp;comma&amp;nbsp;separated&amp;nbsp;list&amp;nbsp;*/<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>mb_detect_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'JIS,&amp;nbsp;eucjp-win,&amp;nbsp;sjis-win'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Use&amp;nbsp;array&amp;nbsp;to&amp;nbsp;specify&amp;nbsp;encoding_list&amp;nbsp;&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>[]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'ASCII'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>[]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'JIS'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$ary</span><span style='color: #007700'>[]&amp;nbsp;=&amp;nbsp;</span><span style='color: #DD0000'>'EUC-JP'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #0000BB'>mb_detect_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$ary</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.mb-detect-encoding.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.mb-detect-order.php' class='function' rel='rdfs-seeAlso'>mb_detect_order()</a> - Set/Get character encoding detection order</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="mb_decode_numericentity" value="<div id='function.mb-decode-numericentity' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-decode-numericentity.php'>mb_decode_numericentity</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_decode_numericentity</span> &amp;mdash; <span class='dc-title'>Decode HTML numeric string reference to character</span></p> </div> <a name='function.mb-decode-numericentity.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>mb_decode_numericentity</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$convmap</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> )</div> <p class='para rdfs-comment'> Convert numeric string reference of <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> in a specified block to character. </p> </div> <a name='function.mb-decode-numericentity.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being decoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>convmap</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>convmap</tt></i> is an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> that specifies the code area to convert. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-decode-numericentity.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The converted <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-decode-numericentity.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <i><tt class='parameter'>convmap</tt></i> example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> $convmap&amp;nbsp;=&amp;nbsp;array&amp;nbsp;(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;int&amp;nbsp;start_code1,&amp;nbsp;int&amp;nbsp;end_code1,&amp;nbsp;int&amp;nbsp;offset1,&amp;nbsp;int&amp;nbsp;mask1,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;int&amp;nbsp;start_code2,&amp;nbsp;int&amp;nbsp;end_code2,&amp;nbsp;int&amp;nbsp;offset2,&amp;nbsp;int&amp;nbsp;mask2,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;........<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;int&amp;nbsp;start_codeN,&amp;nbsp;int&amp;nbsp;end_codeN,&amp;nbsp;int&amp;nbsp;offsetN,&amp;nbsp;int&amp;nbsp;maskN&amp;nbsp;);<br />//&amp;nbsp;Specify&amp;nbsp;Unicode&amp;nbsp;value&amp;nbsp;for&amp;nbsp;start_codeN&amp;nbsp;and&amp;nbsp;end_codeN<br />//&amp;nbsp;Add&amp;nbsp;offsetN&amp;nbsp;to&amp;nbsp;value&amp;nbsp;and&amp;nbsp;take&amp;nbsp;bit-wise&amp;nbsp;'AND'&amp;nbsp;with&amp;nbsp;maskN,&amp;nbsp;<br />//&amp;nbsp;then&amp;nbsp;convert&amp;nbsp;value&amp;nbsp;to&amp;nbsp;numeric&amp;nbsp;string&amp;nbsp;reference.</span> </code></div> </div> </div><p> </p> </div> <a name='function.mb-decode-numericentity.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.mb-encode-numericentity.php' class='function' rel='rdfs-seeAlso'>mb_encode_numericentity()</a> - Encode character to HTML numeric string reference</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="mb_decode_mimeheader" value="<div id='function.mb-decode-mimeheader' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-decode-mimeheader.php'>mb_decode_mimeheader</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_decode_mimeheader</span> &amp;mdash; <span class='dc-title'>Decode string in MIME header field</span></p> </div> <a name='function.mb-decode-mimeheader.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>mb_decode_mimeheader</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> )</div> <p class='para rdfs-comment'> Decodes encoded-word <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> in MIME header. </p> </div> <a name='function.mb-decode-mimeheader.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being decoded. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-decode-mimeheader.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The decoded <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> in internal character encoding. </p> </div> <a name='function.mb-decode-mimeheader.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.mb-encode-mimeheader.php' class='function' rel='rdfs-seeAlso'>mb_encode_mimeheader()</a> - Encode string for MIME header</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="mb_convert_variables" value="<div id='function.mb-convert-variables' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-convert-variables.php'>mb_convert_variables</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_convert_variables</span> &amp;mdash; <span class='dc-title'>Convert character code in variable(s)</span></p> </div> <a name='function.mb-convert-variables.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>mb_convert_variables</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$to_encoding</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'>$from_encoding</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;$vars</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;$...</tt></span> ] )</div> <p class='para rdfs-comment'> Converts character encoding of variables <i><tt class='parameter'>vars</tt></i> in encoding <i><tt class='parameter'>from_encoding</tt></i> to encoding <i><tt class='parameter'>to_encoding</tt></i> . </p> <p class='para'> <b>mb_convert_variables()</b> join strings in Array or Object to detect encoding, since encoding detection tends to fail for short strings. Therefore, it is impossible to mix encoding in single array or object. </p> </div> <a name='function.mb-convert-variables.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'>to_encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The encoding that the <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> is being converted to. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>from_encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>from_encoding</tt></i> is specified as an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> or comma separated <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>, it tries to detect encoding from <i><tt class='parameter'>from-coding</tt></i> . When <i><tt class='parameter'>from_encoding</tt></i> is omitted, <i>detect_order</i> is used. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>vars</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>vars</tt></i> is the reference to the variable being converted. String, Array and Object are accepted. <b>mb_convert_variables()</b> assumes all parameters have the same encoding. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>...</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Additional <i><tt class='parameter'>vars</tt></i> . </p> </dd> </dl> <p> </p> </div> <a name='function.mb-convert-variables.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The character encoding before conversion for success, or <b><tt class='constant'>FALSE</tt></b> for failure. </p> </div> <a name='function.mb-convert-variables.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_convert_variables()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;variables&amp;nbsp;$post1,&amp;nbsp;$post2&amp;nbsp;to&amp;nbsp;internal&amp;nbsp;encoding&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$interenc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_internal_encoding</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>$inputenc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_variables</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$interenc</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ASCII,UTF-8,SJIS-win'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$post1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$post2</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="mb_convert_kana" value="<div id='function.mb-convert-kana' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-convert-kana.php'>mb_convert_kana</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_convert_kana</span> &amp;mdash; <span class='dc-title'>Convert &amp;quot;kana&amp;quot; one from another (&amp;quot;zen-kaku&amp;quot;, &amp;quot;han-kaku&amp;quot; and more)</span></p> </div> <a name='function.mb-convert-kana.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>mb_convert_kana</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$option</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt></span> ]] )</div> <p class='para rdfs-comment'> Performs a &amp;quot;han-kaku&amp;quot; - &amp;quot;zen-kaku&amp;quot; conversion for <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> . This function is only useful for Japanese. </p> </div> <a name='function.mb-convert-kana.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being converted. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>option</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The conversion option. The default value is <i>&amp;quot;KV&amp;quot;</i>. </p> <p class='para'> Specify with a combination of following options. The default value is <i>KV</i>. </p><table class='doctable table'> <caption><b>Applicable Conversion Options</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Option</th> <th>Meaning</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><i>r</i></td> <td align='left'> Convert &amp;quot;zen-kaku&amp;quot; alphabets to &amp;quot;han-kaku&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>R</i></td> <td align='left'> Convert &amp;quot;han-kaku&amp;quot; alphabets to &amp;quot;zen-kaku&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>n</i></td> <td align='left'> Convert &amp;quot;zen-kaku&amp;quot; numbers to &amp;quot;han-kaku&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>N</i></td> <td align='left'> Convert &amp;quot;han-kaku&amp;quot; numbers to &amp;quot;zen-kaku&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>a</i></td> <td align='left'> Convert &amp;quot;zen-kaku&amp;quot; alphabets and numbers to &amp;quot;han-kaku&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>A</i></td> <td align='left'> Convert &amp;quot;han-kaku&amp;quot; alphabets and numbers to &amp;quot;zen-kaku&amp;quot; (Characters included in &amp;quot;a&amp;quot;, &amp;quot;A&amp;quot; options are U+0021 - U+007E excluding U+0022, U+0027, U+005C, U+007E) </td> </tr> <tr valign='middle'> <td align='left'><i>s</i></td> <td align='left'> Convert &amp;quot;zen-kaku&amp;quot; space to &amp;quot;han-kaku&amp;quot; (U+3000 -&amp;gt; U+0020) </td> </tr> <tr valign='middle'> <td align='left'><i>S</i></td> <td align='left'> Convert &amp;quot;han-kaku&amp;quot; space to &amp;quot;zen-kaku&amp;quot; (U+0020 -&amp;gt; U+3000) </td> </tr> <tr valign='middle'> <td align='left'><i>k</i></td> <td align='left'> Convert &amp;quot;zen-kaku kata-kana&amp;quot; to &amp;quot;han-kaku kata-kana&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>K</i></td> <td align='left'> Convert &amp;quot;han-kaku kata-kana&amp;quot; to &amp;quot;zen-kaku kata-kana&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>h</i></td> <td align='left'> Convert &amp;quot;zen-kaku hira-gana&amp;quot; to &amp;quot;han-kaku kata-kana&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>H</i></td> <td align='left'> Convert &amp;quot;han-kaku kata-kana&amp;quot; to &amp;quot;zen-kaku hira-gana&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>c</i></td> <td align='left'> Convert &amp;quot;zen-kaku kata-kana&amp;quot; to &amp;quot;zen-kaku hira-gana&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>C</i></td> <td align='left'> Convert &amp;quot;zen-kaku hira-gana&amp;quot; to &amp;quot;zen-kaku kata-kana&amp;quot; </td> </tr> <tr valign='middle'> <td align='left'><i>V</i></td> <td align='left'> Collapse voiced sound notation and convert them into a character. Use with &amp;quot;K&amp;quot;,&amp;quot;H&amp;quot; </td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-convert-kana.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The converted <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-convert-kana.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_convert_kana()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;all&amp;nbsp;'kana'&amp;nbsp;to&amp;nbsp;'zen-kaku'&amp;nbsp;'kata-kana'&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_kana</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'KVC'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;'han-kaku'&amp;nbsp;'kata-kana'&amp;nbsp;to&amp;nbsp;'zen-kaku'&amp;nbsp;'kata-kana'&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;and&amp;nbsp;'zen-kaku'&amp;nbsp;alpha-numeric&amp;nbsp;to&amp;nbsp;'han-kaku'&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_kana</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'KVa'</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="mb_convert_encoding" value="<div id='function.mb-convert-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-convert-encoding.php'>mb_convert_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_convert_encoding</span> &amp;mdash; <span class='dc-title'>Convert character encoding</span></p> </div> <a name='function.mb-convert-encoding.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>mb_convert_encoding</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$to_encoding</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'>$from_encoding</tt></span> ] )</div> <p class='para rdfs-comment'> Converts the character encoding of <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>str</tt></i> to <i><tt class='parameter'>to_encoding</tt></i> from optionally <i><tt class='parameter'>from_encoding</tt></i> . </p> </div> <a name='function.mb-convert-encoding.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being encoded. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>to_encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The type of encoding that <i><tt class='parameter'>str</tt></i> is being converted to. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>from_encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Is specified by character code names before conversion. It is either an <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a>, or a comma separated enumerated list. If <i><tt class='parameter'>from_encoding</tt></i> is not specified, the internal encoding will be used. </p> <p class='para'> &amp;quot;<i>auto</i>&amp;quot; may be used, which expands to <em class='emphasis'>&amp;quot;ASCII,JIS,UTF-8,EUC-JP,SJIS&amp;quot;</em>. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-convert-encoding.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The encoded <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>. </p> </div> <a name='function.mb-convert-encoding.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_convert_encoding()</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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;internal&amp;nbsp;character&amp;nbsp;encoding&amp;nbsp;to&amp;nbsp;SJIS&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'SJIS'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Convert&amp;nbsp;EUC-JP&amp;nbsp;to&amp;nbsp;UTF-7&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'UTF-7'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'EUC-JP'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Auto&amp;nbsp;detect&amp;nbsp;encoding&amp;nbsp;from&amp;nbsp;JIS,&amp;nbsp;eucjp-win,&amp;nbsp;sjis-win,&amp;nbsp;then&amp;nbsp;convert&amp;nbsp;str&amp;nbsp;to&amp;nbsp;UCS-2LE&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'UCS-2LE'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'JIS,&amp;nbsp;eucjp-win,&amp;nbsp;sjis-win'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;'auto'&amp;nbsp;is&amp;nbsp;expanded&amp;nbsp;to&amp;nbsp;'ASCII,JIS,UTF-8,EUC-JP,SJIS'&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_encoding</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'EUC-JP'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'auto'</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.mb-convert-encoding.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.mb-detect-order.php' class='function' rel='rdfs-seeAlso'>mb_detect_order()</a> - Set/Get character encoding detection order</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="mb_convert_case" value="<div id='function.mb-convert-case' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-convert-case.php'>mb_convert_case</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>mb_convert_case</span> &amp;mdash; <span class='dc-title'>Perform case folding on a string</span></p> </div> <a name='function.mb-convert-case.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>mb_convert_case</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$mode</tt><span class='initializer'> = MB_CASE_UPPER</span></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt><span class='initializer'> = mb_internal_encoding()</span></span> ] )</div> <p class='para rdfs-comment'> Performs case folding on a <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>, converted in the way specified by <i><tt class='parameter'>mode</tt></i> . </p> </div> <a name='function.mb-convert-case.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> being converted. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>mode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The mode of the conversion. It can be one of <b><tt class='constant'>MB_CASE_UPPER</tt></b>, <b><tt class='constant'>MB_CASE_LOWER</tt></b>, or <b><tt class='constant'>MB_CASE_TITLE</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'>O par&amp;acirc;metro <i><tt class='parameter'>encoding</tt></i> &amp;eacute; a codifica&amp;ccedil;&amp;atilde;o de caractere. Se ele &amp;eacute; omitido, o valor da codifica&amp;ccedil;&amp;atilde;o de caractere interna &amp;eacute; usado.</p> </dd> </dl> <p> </p> </div> <a name='function.mb-convert-case.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A case folded version of <i><tt class='parameter'>string</tt></i> converted in the way specified by <i><tt class='parameter'>mode</tt></i> . </p> </div> <a name='function.mb-convert-case.unicode'></a><div class='refsect1 unicode'> <h3 class='title'>Unicode</h3> <p class='para'> By contrast to the standard case folding functions such as <a href='http://www.php.net/manual/pt_BR/function.strtolower.php' class='function'>strtolower()</a> and <a href='http://www.php.net/manual/pt_BR/function.strtoupper.php' class='function'>strtoupper()</a>, case folding is performed on the basis of the Unicode character properties. Thus the behaviour of this function is not affected by locale settings and it can convert any characters that have &amp;#039;alphabetic&amp;#039; property, such as A-umlaut (&amp;Auml;). </p> <p class='para'> For more information about the Unicode properties, please see <a href='http://www.unicode.org/unicode/reports/tr21/' class='link external'>&amp;raquo; http://www.unicode.org/unicode/reports/tr21/</a>. </p> </div> <a name='function.mb-convert-case.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>mb_convert_case()</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 />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'mary&amp;nbsp;had&amp;nbsp;a&amp;nbsp;Little&amp;nbsp;lamb&amp;nbsp;and&amp;nbsp;she&amp;nbsp;loved&amp;nbsp;it&amp;nbsp;so'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_case</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>MB_CASE_UPPER</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'UTF-8'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Prints&amp;nbsp;MARY&amp;nbsp;HAD&amp;nbsp;A&amp;nbsp;LITTLE&amp;nbsp;LAMB&amp;nbsp;AND&amp;nbsp;SHE&amp;nbsp;LOVED&amp;nbsp;IT&amp;nbsp;SO<br /></span><span style='color: #0000BB'>$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>mb_convert_case</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>MB_CASE_TITLE</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'UTF-8'</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Prints&amp;nbsp;Mary&amp;nbsp;Had&amp;nbsp;A&amp;nbsp;Little&amp;nbsp;Lamb&amp;nbsp;And&amp;nbsp;She&amp;nbsp;Loved&amp;nbsp;It&amp;nbsp;So<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.mb-convert-case.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.mb-strtolower.php' class='function' rel='rdfs-seeAlso'>mb_strtolower()</a> - Make a string lowercase</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mb-strtoupper.php' class='function' rel='rdfs-seeAlso'>mb_strtoupper()</a> - Make a string uppercase</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strtolower.php' class='function' rel='rdfs-seeAlso'>strtolower()</a> - Converte uma string para min&amp;uacute;sculas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strtoupper.php' class='function' rel='rdfs-seeAlso'>strtoupper()</a> - Converte uma string para mai&amp;uacute;sculas</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ucfirst.php' class='function' rel='rdfs-seeAlso'>ucfirst()</a> - Converte para mai&amp;uacute;scula o primeiro caractere de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ucwords.php' class='function' rel='rdfs-seeAlso'>ucwords()</a> - Converte para mai&amp;uacute;sculas o primeiro caractere de cada palavra</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="mb_check_encoding" value="<div id='function.mb-check-encoding' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mb-check-encoding.php'>mb_check_encoding</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.4.3, PHP 5 &amp;gt;= 5.1.3)</p><p class='refpurpose'><span class='refname'>mb_check_encoding</span> &amp;mdash; <span class='dc-title'>Check if the string is valid for the specified encoding</span></p> </div> <a name='function.mb-check-encoding.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>mb_check_encoding</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$var</tt><span class='initializer'> = NULL</span></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encoding</tt><span class='initializer'> = mb_internal_encoding()</span></span> ]] )</div> <p class='para rdfs-comment'> Checks if the specified byte stream is valid for the specified encoding. It is useful to prevent so-called &amp;quot;Invalid Encoding Attack&amp;quot;. </p> <p class='para'> </p> </div> <a name='function.mb-check-encoding.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The byte stream to check. If it is omitted, this function checks all the input from the beginning of the request. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encoding</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The expected encoding. </p> </dd> </dl> <p> </p> </div> <a name='function.mb-check-encoding.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="max" value="<div id='function.max' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.max.php'>max</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>max</span> &amp;mdash; <span class='dc-title'>Localiza o maior valor</span></p> </div> <a name='function.max.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>max</b></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$values</tt></span> )</div> <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>max</b></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'>$value1</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'>$value2</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'>$value3...</tt></span> ] )</div> <p class='para rdfs-comment'> </p> <p class='para'> Se o primeiro e &amp;uacute;nico par&amp;acirc;metro &amp;eacute; um array, <b>max()</b> retorna o maior valor do array. Se no m&amp;iacute;nimo dois par&amp;acirc;metros s&amp;atilde;o fornecidos, <b>max()</b> retornar&amp;aacute; o maior desses valores. </p> <blockquote><p><b class='note'>Nota</b>: O PHP ir&amp;aacute; avaliar uma <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> n&amp;atilde;o num&amp;eacute;rica como <i>0</i> se comparado a <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>, mas ainda retorna a string como se ela fosse numericamente o maior valor. Se v&amp;aacute;rios agumentos forem avaliados como <i>0</i>, <b>max()</b> ir&amp;aacute; retornar um n&amp;uacute;mero <i>0</i> se dado, sen&amp;atilde;o o maior alfab&amp;eacute;tico valor string ser&amp;aacute; retornado. <br /> </p></blockquote> </div> <a name='function.max.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'>values</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Um array contendo os valores. </p> </dd> </dl> <p> </p> </div> <a name='function.max.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>max()</b> retorna o maior numericalmente dos valores dos par&amp;acirc;metros. </p> </div> <a name='function.max.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplos de <b>max()</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: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>7</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;7<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;5<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;0<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;hello<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(-</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;hello<br /><br />//&amp;nbsp;Com&amp;nbsp;arrays&amp;nbsp;m&amp;uacute;ltiplos,&amp;nbsp;max&amp;nbsp;compara&amp;nbsp;da&amp;nbsp;esquerda&amp;nbsp;para&amp;nbsp;direita,<br />//&amp;nbsp;assim&amp;nbsp;nesse&amp;nbsp;exemplo:&amp;nbsp;2&amp;nbsp;==&amp;nbsp;2,&amp;nbsp;mas&amp;nbsp;4&amp;nbsp;&amp;lt;&amp;nbsp;5<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>8</span><span style='color: #007700'>),&amp;nbsp;array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>7</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;array(2,&amp;nbsp;5,&amp;nbsp;7)<br /><br />//&amp;nbsp;Se&amp;nbsp;forem&amp;nbsp;informados&amp;nbsp;um&amp;nbsp;array&amp;nbsp;e&amp;nbsp;um&amp;nbsp;n&amp;atilde;o&amp;nbsp;array,&amp;nbsp;o&amp;nbsp;array<br />//&amp;nbsp;&amp;eacute;&amp;nbsp;sempre&amp;nbsp;retornado&amp;nbsp;como&amp;nbsp;se&amp;nbsp;ele&amp;nbsp;fosse&amp;nbsp;o&amp;nbsp;maior<br /></span><span style='color: #0000BB'>$val&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'string'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>7</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>42</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;array(2,&amp;nbsp;5,&amp;nbsp;7)<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.max.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.min.php' class='function' rel='rdfs-seeAlso'>min()</a> - Encontra o menor valor</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.count.php' class='function' rel='rdfs-seeAlso'>count()</a> - Conta o n&amp;uacute;mero de elementos de uma vari&amp;aacute;vel, ou propriedades de um objeto</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="mail" value="<div id='function.mail' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.mail.php'>mail</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>mail</span> &amp;mdash; <span class='dc-title'>Envia email</span></p> </div> <a name='function.mail.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>mail</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$to</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$subject</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$message</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$additional_headers</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$additional_parameters</tt></span> ]] )</div> <p class='para rdfs-comment'> Envia um email. </p> </div> <a name='function.mail.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'>to</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Receptor, ou receptores do email. </p> <p class='para'> O formato desta string precisa estar de acordo com <a href='http://www.faqs.org/rfcs/rfc2822' class='link external'>&amp;raquo; RFC 2822</a>. Alguns exemplos: </p><ul class='simplelist'> <li class='member'>user@example.com</li> <li class='member'>user@example.com, anotheruser@example.com</li> <li class='member'>User &amp;lt;user@example.com&amp;gt;</li> <li class='member'>User &amp;lt;user@example.com&amp;gt;, Another User &amp;lt;anotheruser@example.com&amp;gt;</li> </ul><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>subject</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Assunto do email a ser enviado. </p> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> N&amp;atilde;o deve conter caractere de nova linha, ou o email pode n&amp;atilde;o ser enviado corretamente. </p> </div> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>message</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Mensagem a ser enviada. </p> <p class='para'> Cada linha deve ser separada com um LF (\n). Linhas n&amp;atilde;o deve ser maiores que 70 caracteres. </p> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> (Somente Windows) Quando PHP est&amp;aacute; usando o servidor SMTP diretamente, e uma parada total &amp;eacute; encontrada no in&amp;iacute;cio de uma linha, ela &amp;eacute; removida. Para se defender disto, substitua estas ocorr&amp;ecirc;ncia com dois pontos seguindos. </p><div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$text&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>str_replace</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'\n.'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\n..'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$text</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <p> </p> </div> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>additional_headers</tt></i> (opcional)</span> </dt><dd class='listitem'> <p class='para'> String a ser inserida no final do cabe&amp;ccedil;alho do email. </p> <p class='para'> Esta &amp;eacute; normalmente usada para adicionar cabe&amp;ccedil;alhos extras (From, Cc, e Bcc). M&amp;uacute;ltiplos cabe&amp;ccedil;alhos extra devem ser separados com um CRLF (\r\n). </p> <blockquote><p><b class='note'>Nota</b>: Quando enviando email, o email <em class='emphasis'>precisa</em> conter um cabe&amp;ccedil;alho <i>From</i>. Este pode ser definido com o par&amp;acirc;metro <i><tt class='parameter'>additional_headers</tt></i> , ou um padr&amp;atilde;o pode ser definido no <var class='filename'>php.ini</var>. <br /> Um deslize far&amp;aacute; com que resulte em uma mensagem de erro similar a <i>Warning: mail(): &amp;quot;sendmail_from&amp;quot; not set in php.ini or custom &amp;quot;From:&amp;quot; header missing</i>. O cabe&amp;ccedil;alho <i>From</i> define tamb&amp;eacute;m <i>Return-Path</i> em Windows. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Se mensagens n&amp;atilde;o s&amp;atilde;o recebiedas, tente usar somente um LF (\n). Alguns Unix mail transfer agents de m&amp;aacute; qualidade modificam LF por CRLF automaticamente (que leva a duplica&amp;ccedil;&amp;atilde;o de CR se CRLF &amp;eacute; usado). Este deve ser um &amp;uacute;ltimo recurso, como n&amp;atilde;o est&amp;aacute; de acordo com <a href='http://www.faqs.org/rfcs/rfc2822' class='link external'>&amp;raquo; RFC 2822</a>. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>additional_parameters</tt></i> (opcional)</span> </dt><dd class='listitem'> <p class='para'> O par&amp;acirc;metro <i><tt class='parameter'>additional_parameters</tt></i> pode ser usado para passar um par&amp;acirc;metro adicional para o programa configurado para usa quando enviando email usando a configura&amp;ccedil;&amp;atilde;o <i>sendmail_path</i>. Por exemplo, isto pode ser usado para definir o endere&amp;ccedil;o do envelope remetente quando usando sendmail com a op&amp;ccedil;&amp;atilde;o do sendmail <i>-f</i>. </p> <p class='para'> Voc&amp;ecirc; pode precisar adicionar o usu&amp;aacute;rio que seu servidor web executa como para sua configura&amp;ccedil;&amp;atilde;o de sendmail para evitar que um cabe&amp;ccedil;alho &amp;#039;X-Warning&amp;#039; seja adicionado &amp;agrave; mensagem quando voc&amp;ecirc; define o envelope remetente (-f) usando este m&amp;eacute;todo. Para usu&amp;aacute;rios de sendmail, este arquivo &amp;eacute; <var class='filename'>/etc/mail/trusted-users</var>. </p> </dd> </dl> <p> </p> </div> <a name='function.mail.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o email foi aceito com sucesso pelo entregado, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> <p class='para'> &amp;Eacute; importante notar que somente pelo o email ser aceito pelo entregado, n&amp;atilde;o significa que o email alcancar&amp;aacute; o destino esperado. </p> </div> <a name='function.mail.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.0 (Somente Windows)</td> <td align='left'> Todos os cabe&amp;ccedil;alhos (como From, Cc, Bcc e Date) s&amp;atilde;o suportados, e n&amp;atilde;o s&amp;atilde;o case-sensitive. (Como cabe&amp;ccedil;alhos customizados n&amp;atilde;o s&amp;atilde;o interpretados pela MTA, s&amp;atilde;o analisados pelo PHP, PHP &amp;lt; 4.3 suportava somente o elemento de cabe&amp;ccedil;alho Cc e era case-sensitive). </td> </tr> <tr valign='middle'> <td align='left'>4.2.3</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>additional_parameters</tt></i> &amp;eacute; desabilitado em <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.safe-mode' class='link'>safe_mode</a> e a fun&amp;ccedil;&amp;atilde;o <b>mail()</b> emitir&amp;aacute; uma mensagem de aviso e retornar&amp;aacute; <b><tt class='constant'>FALSE</tt></b> quando usada. </td> </tr> <tr valign='middle'> <td align='left'>4.0.5</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>additional_parameters</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.mail.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Enviando email.</b></p> <div class='example-contents para'><p> Usando <b>mail()</b> para enviar um simples email: </p></div> <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;The&amp;nbsp;message<br /></span><span style='color: #0000BB'>$message&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Line&amp;nbsp;1\nLine&amp;nbsp;2\nLine&amp;nbsp;3'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;In&amp;nbsp;case&amp;nbsp;any&amp;nbsp;of&amp;nbsp;our&amp;nbsp;lines&amp;nbsp;are&amp;nbsp;larger&amp;nbsp;than&amp;nbsp;70&amp;nbsp;characters,&amp;nbsp;we&amp;nbsp;should&amp;nbsp;use&amp;nbsp;wordwrap()<br /></span><span style='color: #0000BB'>$message&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>wordwrap</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$message</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>70</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Send<br /></span><span style='color: #0000BB'>mail</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'caffinated@example.com'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'My&amp;nbsp;Subject'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$message</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Enviando email com cabe&amp;ccedil;alhos extra.</b></p> <div class='example-contents para'><p> A adi&amp;ccedil;&amp;atilde;o de cabe&amp;ccedil;alhos b&amp;aacute;sicos, dizendo a MUA os endere&amp;ccedil;os From e Reply-To: </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$to&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'nobody@example.com'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$subject&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'the&amp;nbsp;subject'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$message&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'hello'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'From:&amp;nbsp;webmaster@example.com'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'&amp;nbsp;</span><span style='color: #007700'>.<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'Reply-To:&amp;nbsp;webmaster@example.com'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'&amp;nbsp;</span><span style='color: #007700'>.<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'X-Mailer:&amp;nbsp;PHP/'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>phpversion</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>mail</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$to</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$subject</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$message</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$headers</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #3 Enviando email com um par&amp;acirc;metro adicional da linha de comando.</b></p> <div class='example-contents para'><p> O par&amp;acirc;metro <i><tt class='parameter'>additional_parameters</tt></i> pode ser usado para passar um par&amp;acirc;metro adicional para o programa configurado para usar quando enviar email usando a defini&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o <i>sendmail_path</i>. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />mail</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'nobody@example.com'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'the&amp;nbsp;subject'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'the&amp;nbsp;message'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>null</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'-fwebmaster@example.com'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #4 Enviando email HTML</b></p> <div class='example-contents para'><p> &amp;Eacute; tamb&amp;eacute;m poss&amp;iacute;vel enviar email HTML com <b>mail()</b>. </p></div> <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;multiple&amp;nbsp;recipients<br /></span><span style='color: #0000BB'>$to&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'aidan@example.com'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>',&amp;nbsp;'</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;note&amp;nbsp;the&amp;nbsp;comma<br /></span><span style='color: #0000BB'>$to&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'wez@example.com'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;subject<br /></span><span style='color: #0000BB'>$subject&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Birthday&amp;nbsp;Reminders&amp;nbsp;for&amp;nbsp;August'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;message<br /></span><span style='color: #0000BB'>$message&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'<br />&amp;lt;html&amp;gt;<br />&amp;lt;head&amp;gt;<br />&amp;nbsp;&amp;lt;title&amp;gt;Birthday&amp;nbsp;Reminders&amp;nbsp;for&amp;nbsp;August&amp;lt;/title&amp;gt;<br />&amp;lt;/head&amp;gt;<br />&amp;lt;body&amp;gt;<br />&amp;lt;p&amp;gt;Here&amp;nbsp;are&amp;nbsp;the&amp;nbsp;birthdays&amp;nbsp;upcoming&amp;nbsp;in&amp;nbsp;August!&amp;lt;/p&amp;gt;<br />&amp;lt;table&amp;gt;<br />&amp;nbsp;&amp;lt;tr&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;lt;th&amp;gt;Person&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;Day&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;Month&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;Year&amp;lt;/th&amp;gt;<br />&amp;nbsp;&amp;lt;/tr&amp;gt;<br />&amp;nbsp;&amp;lt;tr&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;lt;td&amp;gt;Joe&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;3rd&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;August&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;1970&amp;lt;/td&amp;gt;<br />&amp;nbsp;&amp;lt;/tr&amp;gt;<br />&amp;nbsp;&amp;lt;tr&amp;gt;<br />&amp;nbsp;&amp;nbsp;&amp;lt;td&amp;gt;Sally&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;17th&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;August&amp;lt;/td&amp;gt;&amp;lt;td&amp;gt;1973&amp;lt;/td&amp;gt;<br />&amp;nbsp;&amp;lt;/tr&amp;gt;<br />&amp;lt;/table&amp;gt;<br />&amp;lt;/body&amp;gt;<br />&amp;lt;/html&amp;gt;<br />'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Aten&amp;ccedil;&amp;atilde;o&amp;nbsp;se&amp;nbsp;voc&amp;ecirc;&amp;nbsp;pretende&amp;nbsp;inserir&amp;nbsp;numa&amp;nbsp;vari&amp;aacute;vel&amp;nbsp;uma&amp;nbsp;mensagem&amp;nbsp;html&amp;nbsp;mais<br />&amp;nbsp;complexa&amp;nbsp;do&amp;nbsp;que&amp;nbsp;essa&amp;nbsp;sem&amp;nbsp;precisar&amp;nbsp;escapar&amp;nbsp;os&amp;nbsp;carateres&amp;nbsp;<br />&amp;nbsp;necess&amp;aacute;rios&amp;nbsp;pode&amp;nbsp;ser&amp;nbsp;feito&amp;nbsp;o&amp;nbsp;uso&amp;nbsp;da&amp;nbsp;sintaxe&amp;nbsp;heredoc,&amp;nbsp;consulte&amp;nbsp;tipos-string-sintaxe-heredoc&amp;nbsp;*/<br /><br />//&amp;nbsp;To&amp;nbsp;send&amp;nbsp;HTML&amp;nbsp;mail,&amp;nbsp;the&amp;nbsp;Content-type&amp;nbsp;header&amp;nbsp;must&amp;nbsp;be&amp;nbsp;set<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'MIME-Version:&amp;nbsp;1.0'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;text/html;&amp;nbsp;charset=iso-8859-1'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Additional&amp;nbsp;headers<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'To:&amp;nbsp;Mary&amp;nbsp;&amp;lt;mary@example.com&amp;gt;,&amp;nbsp;Kelly&amp;nbsp;&amp;lt;kelly@example.com&amp;gt;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'From:&amp;nbsp;Birthday&amp;nbsp;Reminder&amp;nbsp;&amp;lt;birthday@example.com&amp;gt;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'Cc:&amp;nbsp;birthdayarchive@example.com'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$headers&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'Bcc:&amp;nbsp;birthdaycheck@example.com'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'\r\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Mail&amp;nbsp;it<br /></span><span style='color: #0000BB'>mail</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$to</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$subject</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$message</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$headers</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> </p><blockquote><p><b class='note'>Nota</b>: Se a inten&amp;ccedil;&amp;atilde;o &amp;eacute; enviar email HTML ou outro formato complexo, &amp;eacute; recomendado usar o pacote PEAR <a href='http://pear.php.net/package/Mail_Mime' class='link external'>&amp;raquo; PEAR::Mail_Mime</a>. <br /> </p></blockquote><p> </p></div> </div><p> </p> </div> <a name='function.mail.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A implenta&amp;ccedil;&amp;atilde;o do Windows de <b>mail()</b> difere bastante da implenta&amp;ccedil;&amp;atilde;o Unix. Primeiro, ele n&amp;atilde;o usa um binary local para compor mensagens mas apenas opera com sockets diretos o que significa que uma <i>MTA</i> &amp;eacute; necess&amp;aacute;ria monitorando um socket de rede (que pode ser ou o localhost ou uma m&amp;aacute;quina remota). <br /> Segundo, cabe&amp;ccedil;alhos customizados como <i>From:</i>, <i>Cc:</i>, <i>Bcc:</i> e <i>Date:</i> <em class='emphasis'>not</em> s&amp;atilde;o interpretados pela <i>MTA</i>, mas s&amp;atilde;o analiados pelo PHP. <br /> Assim como, o par&amp;acirc;metro <i><tt class='parameter'>to</tt></i> n&amp;atilde;o deve ser um endere&amp;ccedil;o na forma de &amp;quot;Algo &amp;lt;alguem@example.com&amp;gt;&amp;quot;. O comando de email poderia n&amp;atilde;o analisar isso adequadamente enquanto se comunica com o MTA. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Email com anexos e tipos especiais de conte&amp;uacute;do (e.g. HTML) podem ser enviado usando esta fun&amp;ccedil;&amp;atilde;o. Isto &amp;eacute; melhorado com MIME-encoding - para mais informa&amp;ccedil;&amp;atilde;o, veja este <a href='http://www.zend.com/zend/spotlight/sendmimeemailpart1.php' class='link external'>&amp;raquo; artigo da Zend</a> ou as classes <a href='http://pear.php.net/package/Mail_Mime' class='link external'>&amp;raquo; PEAR Mime</a>. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Vale a pena notar que a fun&amp;ccedil;&amp;atilde;o <b>mail()</b> n&amp;atilde;o &amp;eacute; apropriada para grande volume de email em um loop. Esta fun&amp;ccedil;&amp;atilde;o abre e fecha um socket SMTP para cada email, que n&amp;atilde;o &amp;eacute; muito eficiente. <br /> Para enviar uma grande quantidade de email, veja os pacotes <a href='http://pear.php.net/package/Mail' class='link external'>&amp;raquo; PEAR::Mail</a>, e <a href='http://pear.php.net/package/Mail_Queue' class='link external'>&amp;raquo; PEAR::Mail_Queue</a>. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: O seguintes RFCs podem ser &amp;uacute;teis: <a href='http://www.faqs.org/rfcs/rfc1896' class='link external'>&amp;raquo; RFC 1896</a>, <a href='http://www.faqs.org/rfcs/rfc2045' class='link external'>&amp;raquo; RFC 2045</a>, <a href='http://www.faqs.org/rfcs/rfc2046' class='link external'>&amp;raquo; RFC 2046</a>, <a href='http://www.faqs.org/rfcs/rfc2047' class='link external'>&amp;raquo; RFC 2047</a>, <a href='http://www.faqs.org/rfcs/rfc2048' class='link external'>&amp;raquo; RFC 2048</a>, <a href='http://www.faqs.org/rfcs/rfc2049' class='link external'>&amp;raquo; RFC 2049</a>, e <a href='http://www.faqs.org/rfcs/rfc2822' class='link external'>&amp;raquo; RFC 2822</a>. <br /> </p></blockquote> </div> <a name='function.mail.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.imap-mail.php' class='function' rel='rdfs-seeAlso'>imap_mail()</a> - Send an email message</li> <li class='member'><a href='http://pear.php.net/package/Mail' class='link external'>&amp;raquo; PEAR::Mail</a></li> <li class='member'><a href='http://pear.php.net/package/Mail_Mime' class='link external'>&amp;raquo; PEAR::Mail_Mime</a></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="magic_quotes_runtime" value="<div id='function.magic-quotes-runtime' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.magic-quotes-runtime.php'>magic_quotes_runtime</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>magic_quotes_runtime</span> &amp;mdash; <span class='dc-title'>Sin&amp;ocirc;nimo de <a href='http://www.php.net/manual/pt_BR/function.set-magic-quotes-runtime.php' class='function'>set_magic_quotes_runtime()</a></span></p> </div> <a name='function.magic-quotes-runtime.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; um apelido para: <a href='http://www.php.net/manual/pt_BR/function.set-magic-quotes-runtime.php' class='function'>set_magic_quotes_runtime()</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="ltrim" value="<div id='function.ltrim' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ltrim.php'>ltrim</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ltrim</span> &amp;mdash; <span class='dc-title'>Retira espa&amp;ccedil;os em branco (ou outros caracteres) do in&amp;iacute;cio da string</span></p> </div> <a name='function.ltrim.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>ltrim</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charlist</tt></span> ] )</div> <p class='para rdfs-comment'> Retira espa&amp;ccedil;os em branco (ou outros caracteres) do in&amp;iacute;cio de uma string. </p> </div> <a name='function.ltrim.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'>str</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string de entrada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>charlist</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Voc&amp;ecirc; pode tamb&amp;eacute;m especificar os caracteres que voc&amp;ecirc; quer retirar, para isso, use o par&amp;acirc;metro <i><tt class='parameter'>charlist</tt></i> . Simplesmente liste todos os caracteres que voc&amp;ecirc; quer que seja removido. Com <i>..</i> voc&amp;ecirc; pode especificar um intervalo de caracteres. </p> </dd> </dl> <p> </p> </div> <a name='function.ltrim.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o retorna uma string com whitespace retirados do in&amp;iacute;cio de <i><tt class='parameter'>str</tt></i> . Sem o segundo par&amp;acirc;metro, <b>ltrim()</b> retirar&amp;aacute; estes caracteres: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> &amp;quot; &amp;quot; (<acronym title='American Standard Code for Information Interchange'>ASCII</acronym> <i>32</i> (<i>0x20</i>)), um espa&amp;ccedil;o normal. </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;\t&amp;quot; (<acronym title='American Standard Code for Information Interchange'>ASCII</acronym> <i>9</i> (<i>0x09</i>)), uma tabula&amp;ccedil;&amp;atilde;o. </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;\n&amp;quot; (<acronym title='American Standard Code for Information Interchange'>ASCII</acronym> <i>10</i> (<i>0x0A</i>)), uma linha nova (line feed). </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;\r&amp;quot; (<acronym title='American Standard Code for Information Interchange'>ASCII</acronym> <i>13</i> (<i>0x0D</i>)), um retono de carro. </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;\0&amp;quot; (<acronym title='American Standard Code for Information Interchange'>ASCII</acronym> <i>0</i> (<i>0x00</i>)), o byte <i>NULL</i>. </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;\x0B&amp;quot; (<acronym title='American Standard Code for Information Interchange'>ASCII</acronym> <i>11</i> (<i>0x0B</i>)), uma tabula&amp;ccedil;&amp;atilde;o vertical. </span> </li> </ul><p> </p> </div> <a name='function.ltrim.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.1.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>charlist</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ltrim.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de uso da <b>ltrim()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$text&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'\t\tThese&amp;nbsp;are&amp;nbsp;a&amp;nbsp;few&amp;nbsp;words&amp;nbsp;:)&amp;nbsp;...&amp;nbsp;&amp;nbsp;'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$binary&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'\x09Example&amp;nbsp;string\x0A'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$hello&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Hello&amp;nbsp;World'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$text</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$binary</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$hello</span><span style='color: #007700'>);<br /><br />print&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /><br /></span><span style='color: #0000BB'>$trimmed&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ltrim</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$text</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$trimmed</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$trimmed&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ltrim</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$text</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;\t.'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$trimmed</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$trimmed&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ltrim</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$hello</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Hdle'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$trimmed</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;trim&amp;nbsp;the&amp;nbsp;ASCII&amp;nbsp;control&amp;nbsp;characters&amp;nbsp;at&amp;nbsp;the&amp;nbsp;beginning&amp;nbsp;of&amp;nbsp;$binary&amp;nbsp;<br />//&amp;nbsp;(from&amp;nbsp;0&amp;nbsp;to&amp;nbsp;31&amp;nbsp;inclusive)<br /></span><span style='color: #0000BB'>$clean&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ltrim</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$binary</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\x00..\x1F'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$clean</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> string(32) &amp;quot; These are a few words :) ... &amp;quot; string(16) &amp;quot; Example string &amp;quot; string(11) &amp;quot;Hello World&amp;quot; string(30) &amp;quot;These are a few words :) ... &amp;quot; string(30) &amp;quot;These are a few words :) ... &amp;quot; string(7) &amp;quot;o World&amp;quot; string(15) &amp;quot;Example string &amp;quot; </pre></div> </div> </div><p> </p> </div> <a name='function.ltrim.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.trim.php' class='function' rel='rdfs-seeAlso'>trim()</a> - Retira espa&amp;ccedil;o no &amp;iacute;nicio e final de uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.rtrim.php' class='function' rel='rdfs-seeAlso'>rtrim()</a> - Retira espa&amp;ccedil;o em branco (ou outros caracteres) do final da string</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="lstat" value="<div id='function.lstat' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.lstat.php'>lstat</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>lstat</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m informa&amp;ccedil;&amp;otilde;es sobre um arquivo ou link simb&amp;oacute;lico</span></p> </div> <a name='function.lstat.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>lstat</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Pega as estat&amp;iacute;sticas do arquivo ou link simb&amp;oacute;lico com o nome de <i><tt class='parameter'>filename</tt></i> . </p> </div> <a name='function.lstat.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Path to a file or a symbolic link. </p> </dd> </dl> <p> </p> </div> <a name='function.lstat.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Veja a p&amp;aacute;gina do manual para <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a> para informa&amp;ccedil;&amp;otilde;es sobre a estrutura do array retornado que <b>lstat()</b> retorna. Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; identica a <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a> exceto que se o par&amp;acirc;metro <i><tt class='parameter'>filename</tt></i> &amp;eacute; um link simb&amp;oacute;lico, e o status do link simb&amp;oacute;lico &amp;eacute; retornado e n&amp;atilde;o o status do arquivo apontando pelo link simb&amp;oacute;lico. </p> </div> <a name='function.lstat.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> </div> <a name='function.lstat.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.stat.php' class='function' rel='rdfs-seeAlso'>stat()</a> - Obtem informa&amp;ccedil;&amp;otilde;es sobre um arquivo</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="long2ip" value="<div id='function.long2ip' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.long2ip.php'>long2ip</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>long2ip</span> &amp;mdash; <span class='dc-title'>Converts an (IPv4) Internet network address into a string in Internet standard dotted format</span></p> </div> <a name='function.long2ip.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>long2ip</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$proper_address</tt></span> )</div> <p class='para rdfs-comment'> The function <b>long2ip()</b> generates an Internet address in dotted format (i.e.: aaa.bbb.ccc.ddd) from the proper address representation. </p> </div> <a name='function.long2ip.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'>proper_address</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A proper address representation. </p> </dd> </dl> <p> </p> </div> <a name='function.long2ip.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the Internet IP address as a string. </p> </div> <a name='function.long2ip.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.ip2long.php' class='function' rel='rdfs-seeAlso'>ip2long()</a> - Converts a string containing an (IPv4) Internet Protocol dotted address into a proper address</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="LogicException" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.logicexception.php'>The LogicException class</a></h1> <div class='partintro'> <div id='logicexception.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Exception thrown if a logic expression is invalid </p> </div> <div id='logicexception.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>LogicException</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>LogicException</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.exception.php' class='classname'>Exception</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Inherited methods */</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getmessage.php' class='function'>Exception::getMessage</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getcode.php' class='function'>Exception::getCode</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getfile.php' class='function'>Exception::getFile</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getline.php' class='function'>Exception::getLine</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>array</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.gettrace.php' class='function'>Exception::getTrace</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.gettraceasstring.php' class='function'>Exception::getTraceAsString</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.tostring.php' class='function'>Exception::__toString</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>private</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.clone.php' class='function'>Exception::__clone</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </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="log10" value="<div id='function.log10' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.log10.php'>log10</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>log10</span> &amp;mdash; <span class='dc-title'>Logaritmo Base-10</span></p> </div> <a name='function.log10.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>float</span> <span class='methodname'><b>log10</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$arg</tt></span> )</div> <p class='para rdfs-comment'> Retorna o logaritmo na base-10 de <i><tt class='parameter'>arg</tt></i> . </p> </div> <a name='function.log10.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'>arg</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O argumento para processar </p> </dd> </dl> <p> </p> </div> <a name='function.log10.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O logaritmo na base-10 de <i><tt class='parameter'>arg</tt></i> </p> </div> <a name='function.log10.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.log.php' class='function' rel='rdfs-seeAlso'>log()</a> - Logaritmo natural</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="log" value="<div id='function.log' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.log.php'>log</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>log</span> &amp;mdash; <span class='dc-title'>Logaritmo natural</span></p> </div> <a name='function.log.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>float</span> <span class='methodname'><b>log</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$arg</tt></span> [, <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$base</tt></span> ] )</div> <p class='para rdfs-comment'> Se o par&amp;acirc;metro opcional <i><tt class='parameter'>base</tt></i> for informado, <b>log()</b> retorna log<sub class='subscript'>base</sub> <i><tt class='parameter'>arg</tt></i> , sen&amp;atilde;o <b>log()</b> retorna o logaritmo natural de <i><tt class='parameter'>arg</tt></i> . </p> </div> <a name='function.log.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'>arg</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O valor para calcular o logaritmo </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>base</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O logaritmo base opcional para usar (padr&amp;atilde;o &amp;eacute; &amp;#039;e&amp;#039; e assim o logaritmo natural). </p> </dd> </dl> <p> </p> </div> <a name='function.log.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O logarimo de <i><tt class='parameter'>arg</tt></i> na <i><tt class='parameter'>base</tt></i> , se fornecido, ou o logaritmo natural. </p> </div> <a name='function.log.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'>Since 4.3.0</td> <td align='left'> O par&amp;acirc;metro opcional <i><tt class='parameter'>base</tt></i> tornou-se dispon&amp;iacute;vel. Para antigas vers&amp;otilde;es voc&amp;ecirc; pode calcular o logaritmo na base <i>b</i> de um n&amp;uacute;mero <i>n</i> pela utiliza&amp;ccedil;&amp;atilde;o da identidade matem&amp;aacute;tica: log<sub class='subscript'>b</sub>(n) = log(n)/log(b), onde log &amp;eacute; o logaritmo neperiano (ou natural). </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.log.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.log10.php' class='function' rel='rdfs-seeAlso'>log10()</a> - Logaritmo Base-10</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.exp.php' class='function' rel='rdfs-seeAlso'>exp()</a> - Calcula o expoente de e</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.pow.php' class='function' rel='rdfs-seeAlso'>pow()</a> - Pot&amp;ecirc;ncia</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="localtime" value="<div id='function.localtime' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.localtime.php'>localtime</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>localtime</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a hora local</span></p> </div> <a name='function.localtime.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>localtime</b></span> ([ <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$timestamp</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$is_associative</tt></span> ]] )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>localtime()</b> retorna uma matriz id&amp;ecirc;ntica &amp;agrave;quela da estrutura retornada pela chamada de uma fun&amp;ccedil;&amp;atilde;o em C. </p> </div> <a name='function.localtime.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'>timestamp</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O par&amp;acirc;metro opcional <i><tt class='parameter'>timestamp</tt></i> &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> Unix timestamp cujo padr&amp;atilde;o &amp;eacute; a hora local se <i><tt class='parameter'>timestamp</tt></i> n&amp;atilde;o for dado. Em outras palavras, o padr&amp;atilde;o &amp;eacute; o valor de <a href='http://www.php.net/manual/pt_BR/function.time.php' class='function'>time()</a>. </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>is_associative</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se definido para <b><tt class='constant'>FALSE</tt></b> ou n&amp;atilde;o fornecido, ent&amp;atilde;o um array &amp;eacute; retornado, com &amp;iacute;ndices num&amp;eacute;ricos. Se o argumento &amp;eacute; definido para <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o <b>localtime()</b> &amp;eacute; um array associativo contendo todos os diferentes elementos da estrutura retornados pela chamada da fun&amp;ccedil;&amp;atilde;o C para o localtime. Os nomes das diferentes chaves do array associativo s&amp;atilde;o as seguintes: </p> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> &amp;quot;tm_sec&amp;quot; - Segundos </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_min&amp;quot; - Minutos </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_hour&amp;quot; - Hora </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_mday&amp;quot; - Dia do m&amp;ecirc;s </span> <span class='simpara'> Meses s&amp;atilde;o de 0 (Jan) &amp;agrave; 11 (Dez) e dias da semana s&amp;atilde;o de 0 (Dom) &amp;agrave; 6 (S&amp;aacute;b). </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_mon&amp;quot; - M&amp;ecirc;s do ano, come&amp;ccedil;a com 0 para Janeiro </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_year&amp;quot; - Anos desde 1900 </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_wday&amp;quot; - Dia da semana </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_yday&amp;quot; - Dia do ano </span> </li> <li class='listitem'> <span class='simpara'> &amp;quot;tm_isdst&amp;quot; - Se est&amp;aacute; em hor&amp;aacute;rio de ver&amp;atilde;o </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.localtime.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> Toda a chamada a uma fun&amp;ccedil;&amp;atilde;o de data/hora ir&amp;aacute; gerar um se a zona da hora n&amp;atilde;o for valida, e/ou uma mensagem <b><tt class='constant'>E_STRICT</tt></b> ou <b><tt class='constant'>E_WARNING</tt></b> se estiver usando a defini&amp;ccedil;&amp;atilde;o do sistema ou a vari&amp;aacute;vel de ambiente <var class='varname'>TZ</var>. Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.date-default-timezone-set.php' class='function'>date_default_timezone_set()</a></p> </div> <a name='function.localtime.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.1.0</td><td align='left'><p class='para'> Agora emite <b><tt class='constant'>E_STRICT</tt></b> e <b><tt class='constant'>E_NOTICE</tt></b> em erros da zona de hor&amp;aacute;rio.</p></td></tr> </tbody> </table> <p> </p> </div> <a name='function.localtime.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>localtime()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$localtime&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>localtime</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>$localtime_assoc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>localtime</span><span style='color: #007700'>(</span><span style='color: #0000BB'>time</span><span style='color: #007700'>(),&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$localtime</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$localtime_assoc</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> Array ( [0] =&amp;gt; 24 [1] =&amp;gt; 3 [2] =&amp;gt; 19 [3] =&amp;gt; 3 [4] =&amp;gt; 3 [5] =&amp;gt; 105 [6] =&amp;gt; 0 [7] =&amp;gt; 92 [8] =&amp;gt; 1 ) Array ( [tm_sec] =&amp;gt; 24 [tm_min] =&amp;gt; 3 [tm_hour] =&amp;gt; 19 [tm_mday] =&amp;gt; 3 [tm_mon] =&amp;gt; 3 [tm_year] =&amp;gt; 105 [tm_wday] =&amp;gt; 0 [tm_yday] =&amp;gt; 92 [tm_isdst] =&amp;gt; 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="localeconv" value="<div id='function.localeconv' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.localeconv.php'>localeconv</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>localeconv</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a informa&amp;ccedil;&amp;atilde;o da formata&amp;ccedil;&amp;atilde;o num&amp;eacute;rica</span></p> </div> <a name='function.localeconv.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Description</h3> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>localeconv</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Retorna uma matriz associativa contendo informa&amp;ccedil;&amp;atilde;o de formata&amp;ccedil;&amp;atilde;o num&amp;eacute;rica. </p> <p class='para'> <b>localeconv()</b> retorna dados baseados na localidade corrente definida por <a href='http://www.php.net/manual/pt_BR/function.setlocale.php' class='function'>setlocale()</a>. A matriz associativa que &amp;eacute; retornada cont&amp;eacute;m os seguintes campos: </p><table class='doctable informaltable'> <thead valign='middle'> <tr valign='middle'> <th>Array element</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>decimal_point</td> <td align='left'>Caracter de ponto decimal</td> </tr> <tr valign='middle'> <td align='left'>thousands_sep</td> <td align='left'>Thousands separator</td> </tr> <tr valign='middle'> <td align='left'>grouping</td> <td align='left'>Matriz contendo agrupamentos num&amp;eacute;ricos</td> </tr> <tr valign='middle'> <td align='left'>int_curr_symbol</td> <td align='left'>International currency symbol (i.e. USD)</td> </tr> <tr valign='middle'> <td align='left'>currency_symbol</td> <td align='left'>Simbolo da moeda local symbol (i.e. $)</td> </tr> <tr valign='middle'> <td align='left'>mon_decimal_point</td> <td align='left'>Caractere monet&amp;aacute;rio de ponto decimal</td> </tr> <tr valign='middle'> <td align='left'>mon_thousands_sep</td> <td align='left'>Separador monet&amp;aacute;rio de mil</td> </tr> <tr valign='middle'> <td align='left'>mon_grouping</td> <td align='left'>Matriz contendo agrupamentos monet&amp;aacute;rios</td> </tr> <tr valign='middle'> <td align='left'>positive_sign</td> <td align='left'>Sinal para valores positivos</td> </tr> <tr valign='middle'> <td align='left'>negative_sign</td> <td align='left'>Sinal para valores negativos</td> </tr> <tr valign='middle'> <td align='left'>int_frac_digits</td> <td align='left'>D&amp;iacute;gitos de fra&amp;ccedil;&amp;atilde;o Internacionais</td> </tr> <tr valign='middle'> <td align='left'>frac_digits</td> <td align='left'>D&amp;iacute;gitos de fra&amp;ccedil;&amp;atilde;o locais</td> </tr> <tr valign='middle'> <td align='left'>p_cs_precedes</td> <td align='left'> <b><tt class='constant'>TRUE</tt></b> Se o simbolo da moeda precede um valor positivo, <b><tt class='constant'>FALSE</tt></b> se eles sucede um. </td> </tr> <tr valign='middle'> <td align='left'>p_sep_by_space</td> <td align='left'> <b><tt class='constant'>TRUE</tt></b> Se um espa&amp;ccedil;o separa o simbolo da moeda de um valor positivo, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio </td> </tr> <tr valign='middle'> <td align='left'>n_cs_precedes</td> <td align='left'> <b><tt class='constant'>TRUE</tt></b> Se o simbolo de moeda precede um valor negativo, <b><tt class='constant'>FALSE</tt></b> se ele sucede </td> </tr> <tr valign='middle'> <td align='left'>n_sep_by_space</td> <td align='left'> <b><tt class='constant'>TRUE</tt></b> se um espa&amp;ccedil;o separa o simbolo da moeda de um valor negativo, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio </td> </tr> <tr valign='top'> <td align='left'>p_sign_posn</td> <td align='left'> <ul class='simplelist'> <li class='member'>0</li> <li class='member'> Par&amp;ecirc;nteses na quantidade e simbolo da moeda</li> <li class='member'>1</li> <li class='member'> A string sinal precede a quantidade e o simbolo da moeda </li> <li class='member'>2</li> <li class='member'> A string sinal sucede a quantidade e o simbolo da moeda </li> <li class='member'>3</li> <li class='member'> A string sinal precede imediatamente o simbolo da moeda </li> <li class='member'>4</li> <li class='member'> A string sinal sucede imediatamente o simbolo da moeda </li> </ul> </td> </tr> <tr valign='top'> <td align='left'>n_sign_posn</td> <td align='left'> <ul class='simplelist'> <li class='member'>0</li> <li class='member'> Parent&amp;ecirc;ses na quantidade e simbolo da moeda </li> <li class='member'>1</li> <li class='member'> A string sinal precede a quantidade e o simbolo da moeda </li> <li class='member'>2</li> <li class='member'> A string sinal sucede a quantidade e o simbolo da moeda </li> <li class='member'>3</li> <li class='member'> A string sinal precede imediatamente o simbolo da moeda </li> <li class='member'>4</li> <li class='member'>A string sinal sucede imediatamente o simbolo da moeda </li> </ul> </td> </tr> </tbody> </table> <p> </p> <p class='para'> Os campos de agrupamento cont&amp;eacute;m matrizes que definem o modo de como os n&amp;uacute;meros seriam agrupados. Por exemplo, o campo de agrupamento para a localidade en_US, conteria uma matriz de 2 itens com os valores 3 e 3. O mais alto &amp;iacute;ndice na matriz, mais distante da esquerda do agrupamento est&amp;aacute;. Se um elemento da matriz &amp;eacute; igual a CHAR_MAX, at&amp;eacute; aqui nenhum agrupamento &amp;eacute; feito. Se um elemento de matriz &amp;eacute; igual a 0, o pr&amp;eacute;vio elemento seria usado. </p> <div class='example'> <p><b>Exemplo #1 <b>localeconv()</b> exemplo</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />setlocale</span><span style='color: #007700'>(</span><span style='color: #0000BB'>LC_ALL</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'en_US'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$locale_info&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>localeconv</span><span style='color: #007700'>();<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;pre&amp;gt;\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'--------------------------------------------\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;nbsp;&amp;nbsp;Monetary&amp;nbsp;information&amp;nbsp;for&amp;nbsp;current&amp;nbsp;locale:&amp;nbsp;&amp;nbsp;\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'--------------------------------------------\n\n'</span><span style='color: #007700'>;<br /><br />echo&amp;nbsp;</span><span style='color: #DD0000'>'int_curr_symbol:&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'int_curr_symbol'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'currency_symbol:&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'currency_symbol'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'mon_decimal_point:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'mon_decimal_point'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'mon_thousands_sep:&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'mon_thousands_sep'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'positive_sign:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'positive_sign'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'negative_sign:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'negative_sign'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'int_frac_digits:&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'int_frac_digits'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'frac_digits:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'frac_digits'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'p_cs_precedes:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'p_cs_precedes'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'p_sep_by_space:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'p_sep_by_space'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'n_cs_precedes:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'n_cs_precedes'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'n_sep_by_space:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'n_sep_by_space'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'p_sign_posn:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'p_sign_posn'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'n_sign_posn:&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>{</span><span style='color: #0000BB'>$locale_info</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'n_sign_posn'</span><span style='color: #007700'>]}</span><span style='color: #DD0000'>\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;/pre&amp;gt;\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> A constante CHAR_MAX tamb&amp;eacute;m est&amp;aacute; definida para o uso mencionado acima. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.setlocale.php' class='function'>setlocale()</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="LimitIterator::__construct" value="<div id='limititerator.construct' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.construct.php'>LimitIterator::__construct</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::__construct</span> &amp;mdash; <span class='dc-title'>Construct a LimitIterator</span></p> </div> <a name='limititerator.construct.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='methodname'><b>LimitIterator::__construct</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='type Iterator'>Iterator</a></span> <tt class='parameter'>$iterator</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$count</tt></span> ]] )</div> <p class='para rdfs-comment'> Constructs a new <b class='classname'>LimitIterator</b>, which consists of a passed in <i><tt class='parameter'>iterator</tt></i> with limits applied to it. </p> <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> <a name='limititerator.construct.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'>iterator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The iterator to limit. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Optional offset of the limit. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>count</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Optional count of the limit. </p> </dd> </dl> <p> </p> </div> <a name='limititerator.construct.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The new <b class='classname'>LimitIterator</b>. </p> </div> <a name='limititerator.construct.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/filteriterator.construct.php' class='function' rel='rdfs-seeAlso'>FilterIterator::__construct</a> - Construct a filterIterator</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="LimitIterator::valid" value="<div id='limititerator.valid' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.valid.php'>LimitIterator::valid</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::valid</span> &amp;mdash; <span class='dc-title'>Verifica se o elemento atual &amp;eacute; v&amp;aacute;lido ou n&amp;atilde;o</span></p> </div> <a name='limititerator.valid.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>LimitIterator::valid</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Verifica se o elemento atual &amp;eacute; v&amp;aacute;lido ou n&amp;atilde;o. </p> <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> <a name='limititerator.valid.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.valid.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="LimitIterator::seek" value="<div id='limititerator.seek' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.seek.php'>LimitIterator::seek</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::seek</span> &amp;mdash; <span class='dc-title'>Aponta para a posi&amp;ccedil;&amp;atilde;o especificada</span></p> </div> <a name='limititerator.seek.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>LimitIterator::seek</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$position</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> <a name='limititerator.seek.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'>position</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A posi&amp;ccedil;&amp;atilde;o a ser procurada. </p> </dd> </dl> <p> </p> </div> <a name='limititerator.seek.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> </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="LimitIterator::rewind" value="<div id='limititerator.rewind' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.rewind.php'>LimitIterator::rewind</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::rewind</span> &amp;mdash; <span class='dc-title'>Retorna o iterador para o come&amp;ccedil;o especificado no construtor</span></p> </div> <a name='limititerator.rewind.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>LimitIterator::rewind</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Retorna o iterador para o come&amp;ccedil;o especificado no construtor. </p> <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> <a name='limititerator.rewind.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.rewind.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> </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="LimitIterator::next" value="<div id='limititerator.next' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.next.php'>LimitIterator::next</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::next</span> &amp;mdash; <span class='dc-title'>Avan&amp;ccedil;a o iterador</span></p> </div> <a name='limititerator.next.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>LimitIterator::next</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Avan&amp;ccedil;a o iterador. </p> <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> <a name='limititerator.next.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.next.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> </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="LimitIterator::key" value="<div id='limititerator.key' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.key.php'>LimitIterator::key</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::key</span> &amp;mdash; <span class='dc-title'>Get current key</span></p> </div> <a name='limititerator.key.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <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>LimitIterator::key</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Gets the current key </p> <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> <a name='limititerator.key.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.key.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The current key. </p> </div> <a name='limititerator.key.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.current.php' class='function' rel='rdfs-seeAlso'>LimitIterator::current</a> - Get current element</span></li> <li class='member'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.next.php' class='function' rel='rdfs-seeAlso'>LimitIterator::next</a> - Avan&amp;ccedil;a o iterador</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="LimitIterator::getPosition" value="<div id='limititerator.getposition' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.getposition.php'>LimitIterator::getPosition</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::getPosition</span> &amp;mdash; <span class='dc-title'>Retorna a posi&amp;ccedil;&amp;atilde;o atual</span></p> </div> <a name='limititerator.getposition.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>LimitIterator::getPosition</b></span> ( <span class='methodparam'>void</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> <a name='limititerator.getposition.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.getposition.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A posi&amp;ccedil;&amp;atilde;o atual. </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="LimitIterator::getInnerIterator" value="<div id='limititerator.getinneriterator' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.getinneriterator.php'>LimitIterator::getInnerIterator</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::getInnerIterator</span> &amp;mdash; <span class='dc-title'>Get inner iterator</span></p> </div> <a name='limititerator.getinneriterator.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='type Iterator'>Iterator</a></span> <span class='methodname'><b>LimitIterator::getInnerIterator</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Gets the inner iterator. </p> <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> <a name='limititerator.getinneriterator.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.getinneriterator.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The inner iterator. </p> </div> <a name='limititerator.getinneriterator.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.getposition.php' class='function' rel='rdfs-seeAlso'>LimitIterator::getPosition</a> - Retorna a posi&amp;ccedil;&amp;atilde;o atual</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="LimitIterator::current" value="<div id='limititerator.current' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/limititerator.current.php'>LimitIterator::current</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>LimitIterator::current</span> &amp;mdash; <span class='dc-title'>Get current element</span></p> </div> <a name='limititerator.current.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <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>LimitIterator::current</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Gets the current element. </p> <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> <a name='limititerator.current.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='limititerator.current.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The current element. </p> </div> <a name='limititerator.current.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.key.php' class='function' rel='rdfs-seeAlso'>LimitIterator::key</a> - Get current key</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="LimitIterator" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.limititerator.php'>A classe LimitIterator</a></h1> <div class='partintro'> <div id='limititerator.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> ... </p> </div> <div id='limititerator.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>LimitIterator</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>LimitIterator</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.iteratoriterator.php' class='classname'>IteratorIterator</a> </span> <span class='oointerface'>implements <a href='http://www.php.net/manual/pt_BR/class.outeriterator.php' class='interfacename'>OuterIterator</a> </span> <span class='oointerface'>, <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='interfacename'>Traversable</a> </span> <span class='oointerface'>, <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='interfacename'>Iterator</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* M&amp;eacute;todos */</div> <div class='methodsynopsis dc-description'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.construct.php' class='function'>__construct</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='type Iterator'>Iterator</a></span> <tt class='parameter'>$iterator</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$offset</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$count</tt></span> ]] )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.current.php' class='function'>current</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>Iterator</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.getinneriterator.php' class='function'>getInnerIterator</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.getposition.php' class='function'>getPosition</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.key.php' class='function'>key</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.next.php' class='function'>next</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.rewind.php' class='function'>rewind</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.seek.php' class='function'>seek</a></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$position</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/limititerator.valid.php' class='function'>valid</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/limititerator.construct.php'>LimitIterator::__construct</a> &amp;mdash; Construct a LimitIterator</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.current.php'>LimitIterator::current</a> &amp;mdash; Get current element</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.getinneriterator.php'>LimitIterator::getInnerIterator</a> &amp;mdash; Get inner iterator</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.getposition.php'>LimitIterator::getPosition</a> &amp;mdash; Retorna a posi&amp;ccedil;&amp;atilde;o atual</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.key.php'>LimitIterator::key</a> &amp;mdash; Get current key</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.next.php'>LimitIterator::next</a> &amp;mdash; Avan&amp;ccedil;a o iterador</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.rewind.php'>LimitIterator::rewind</a> &amp;mdash; Retorna o iterador para o come&amp;ccedil;o especificado no construtor</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.seek.php'>LimitIterator::seek</a> &amp;mdash; Aponta para a posi&amp;ccedil;&amp;atilde;o especificada</li><li><a href='http://www.php.net/manual/pt_BR/limititerator.valid.php'>LimitIterator::valid</a> &amp;mdash; Verifica se o elemento atual &amp;eacute; v&amp;aacute;lido ou n&amp;atilde;o</li></ul> </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="levenshtein" value="<div id='function.levenshtein' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.levenshtein.php'>levenshtein</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>levenshtein</span> &amp;mdash; <span class='dc-title'> Calcula a dist&amp;acirc;ncia Levenshtein entre duas strings </span></p> </div> <a name='function.levenshtein.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>levenshtein</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str1</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str2</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>levenshtein</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str1</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cost_ins</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cost_rep</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cost_del</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>int</span> <span class='methodname'><b>levenshtein</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str1</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str2</tt></span> , <span class='methodparam'><span class='type'><span class='type function'>function</span></span> <tt class='parameter'>$cost</tt></span> )</div> <p class='para rdfs-comment'> Retorna a Levenshtein-Distance entre duas strings argumentos ou -1, se nenhuma das strings argumentos &amp;eacute; mais longa que o o limite de 255 caracteres (255 seria mais do que o bastante para o nome ou compara&amp;ccedil;&amp;atilde;o de dicion&amp;aacute;rio, e ningu&amp;eacute;m s&amp;eacute;rio estaria fazendo an&amp;aacute;lises gen&amp;eacute;ticas com PHP). </p> <p class='para'> A dist&amp;acirc;ncia Levenshtein &amp;eacute; definida como o n&amp;uacute;mero m&amp;iacute;nimo de caracteres que voc&amp;ecirc; tem para substituir, inserir ou apagar para transformar <i><tt class='parameter'>str1</tt></i> dentro de <i><tt class='parameter'>str2</tt></i> . A complexidade do algoritmo &amp;eacute; <i>O(m*n)</i>, onde <i>n</i> e <i>m</i> s&amp;atilde;o o comprimento da <i><tt class='parameter'>str1</tt></i> e <i><tt class='parameter'>str2</tt></i> (rather good when compared to <a href='http://www.php.net/manual/pt_BR/function.similar-text.php' class='function'>similar_text()</a>, which is O(max(n,m)**3), but still expensive). </p> <p class='para'> Na sua forma mais simples a fun&amp;ccedil;&amp;atilde;o pegar&amp;aacute; apenas as duas strings como par&amp;acirc;metros e calcular&amp;aacute; apenas o n&amp;uacute;mero de opera&amp;ccedil;&amp;otilde;es de inser&amp;ccedil;&amp;atilde;o, substitui&amp;ccedil;&amp;atilde;o e deleta&amp;ccedil;&amp;atilde;o necess&amp;aacute;rias para transformar <i><tt class='parameter'>str1</tt></i> em <i><tt class='parameter'>str2</tt></i> . </p> <p class='para'> Uma segunda variante pegar&amp;aacute; tr&amp;ecirc;s par&amp;acirc;metros adicionais que definem o custo das opera&amp;ccedil;&amp;otilde;es de inser&amp;ccedil;&amp;atilde;o, substitui&amp;ccedil;&amp;atilde;o e deleta&amp;ccedil;&amp;atilde;o. Esta &amp;eacute; a mais geral e adapat&amp;aacute;vel do que a variante um, mas n&amp;atilde;o t&amp;atilde;o eficiente. </p> <p class='para'> A terceira variante (que ainda n&amp;atilde;o &amp;eacute; implementada) ser&amp;aacute; a mais geral e adapt&amp;aacute;vel, mas tamb&amp;eacute;m a alternativa mais lenta. Ela chamar&amp;aacute; uma fun&amp;ccedil;&amp;atilde;o de usu&amp;aacute;rio fornecida que determinar&amp;aacute; o custo para cada poss&amp;iacute;vel opera&amp;ccedil;&amp;atilde;o. </p> <p class='para'> A fun&amp;ccedil;&amp;atilde;o de usu&amp;aacute;rio fornecida(The user-supplied function) ser&amp;aacute; chamada com os seguintes argumentos: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> operation to apply: &amp;#039;I&amp;#039;, &amp;#039;R&amp;#039; ou &amp;#039;D&amp;#039; </span> </li> <li class='listitem'> <span class='simpara'> actual character in string 1 </span> </li> <li class='listitem'> <span class='simpara'> actual character in string 2 </span> </li> <li class='listitem'> <span class='simpara'> position in string 1 </span> </li> <li class='listitem'> <span class='simpara'> position in string 2 </span> </li> <li class='listitem'> <span class='simpara'> remaining characters in string 1 </span> </li> <li class='listitem'> <span class='simpara'> remaining characters in string 2 </span> </li> </ul><p> The user-supplied function has to return a positive integer describing the cost for this particular operation, but it may decide to use only some of the supplied arguments. </p> <p class='para'> The user-supplied function approach offers the possibility to take into account the relevance of and/or difference between certain symbols (characters) or even the context those symbols appear in to determine the cost of insert, replace and delete operations, but at the cost of losing all optimizations done regarding cpu register utilization and cache misses that have been worked into the other two variants. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.soundex.php' class='function'>soundex()</a>, <a href='http://www.php.net/manual/pt_BR/function.similar-text.php' class='function'>similar_text()</a>, e <a href='http://www.php.net/manual/pt_BR/function.metaphone.php' class='function'>metaphone()</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="LengthException" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.lengthexception.php'>The LengthException class</a></h1> <div class='partintro'> <div id='lengthexception.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Exception thrown if a length is invalid </p> </div> <div id='lengthexception.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>LengthException</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>LengthException</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.logicexception.php' class='classname'>LogicException</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Inherited methods */</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getmessage.php' class='function'>Exception::getMessage</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getcode.php' class='function'>Exception::getCode</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getfile.php' class='function'>Exception::getFile</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getline.php' class='function'>Exception::getLine</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>array</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.gettrace.php' class='function'>Exception::getTrace</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.gettraceasstring.php' class='function'>Exception::getTraceAsString</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.tostring.php' class='function'>Exception::__toString</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>private</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.clone.php' class='function'>Exception::__clone</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </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="lcg_value" value="<div id='function.lcg-value' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.lcg-value.php'>lcg_value</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>lcg_value</span> &amp;mdash; <span class='dc-title'>Gerador congruente linear combinado</span></p> </div> <a name='function.lcg-value.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>float</span> <span class='methodname'><b>lcg_value</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> <b>lcg_value()</b> retorna um pseudo n&amp;uacute;mero aleat&amp;oacute;rio nos limites de (0, 1). A fun&amp;ccedil;&amp;atilde;o combina duas congru&amp;ecirc;ncias geradas, com per&amp;iacute;odos de 2^31 - 85 e 2^31 - 249. O per&amp;iacute;odo desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; igual ao produto de ambos os primos. </p> </div> <a name='function.lcg-value.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Um pseudo valor float aleat&amp;oacute;rio no intervalo (0, 1) </p> </div> <a name='function.lcg-value.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.rand.php' class='function' rel='rdfs-seeAlso'>rand()</a> - Gera um inteiro aleat&amp;oacute;rio</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.mt-rand.php' class='function' rel='rdfs-seeAlso'>mt_rand()</a> - Gerador melhorado de n&amp;uacute;meros aleat&amp;oacute;rios</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="ksort" value="<div id='function.ksort' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ksort.php'>ksort</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ksort</span> &amp;mdash; <span class='dc-title'>Ordena um array pelas chaves</span></p> </div> <a name='function.ksort.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>ksort</b></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$sort_flags</tt></span> ] )</div> <p class='para rdfs-comment'> Ordena um array pelas chaves, mantendo a correla&amp;ccedil;&amp;atilde;o entre as chaves e os valores. Essa fun&amp;ccedil;&amp;atilde;o &amp;eacute; bastante &amp;uacute;til principalmente para arrays associativos. </p> </div> <a name='function.ksort.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'>array</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O array de entrada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>sort_flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Voc&amp;ecirc; pode modificar o comportamento da ordena&amp;ccedil;&amp;atilde;o atrav&amp;eacute;s do par&amp;acirc;metro opcional <i><tt class='parameter'>sort_flags</tt></i> , para mais detalhes veja <a href='http://www.php.net/manual/pt_BR/function.sort.php' class='function'>sort()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.ksort.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.ksort.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.0</td> <td align='left'> O par&amp;acirc;metro opcional <i><tt class='parameter'>sort_flags</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ksort.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>ksort()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$frutas&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'d'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'limao'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'a'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'laranja'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'b'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'banana'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'c'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'ma&amp;ccedil;&amp;atilde;'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>ksort</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$frutas</span><span style='color: #007700'>);<br />foreach&amp;nbsp;(</span><span style='color: #0000BB'>$fruits&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$key&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$chave</span><span style='color: #DD0000'>&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>$valor</span><span style='color: #DD0000'>\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> a = laranja b = banana c = ma&amp;ccedil;&amp;atilde; d = limao </pre></div> </div> </div><p> </p> </div> <a name='function.ksort.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.asort.php' class='function' rel='rdfs-seeAlso'>asort()</a> - Ordena um array mantendo a associa&amp;ccedil;&amp;atilde;o entre &amp;iacute;ndices e valores</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.arsort.php' class='function' rel='rdfs-seeAlso'>arsort()</a> - Ordena um array em ordem descrescente mantendo a associa&amp;ccedil;&amp;atilde;o entre &amp;iacute;ndices e valores</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.krsort.php' class='function' rel='rdfs-seeAlso'>krsort()</a> - Ordena um array pelas chaves em ordem descrescente</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.uksort.php' class='function' rel='rdfs-seeAlso'>uksort()</a> - Ordena um array pelas chaves utilizando uma fun&amp;ccedil;&amp;atilde;o de compara&amp;ccedil;&amp;atilde;o definida pelo usu&amp;aacute;rio.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.sort.php' class='function' rel='rdfs-seeAlso'>sort()</a> - Ordena um array</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.natsort.php' class='function' rel='rdfs-seeAlso'>natsort()</a> - Ordena um array utilizando o algoritmo da 'ordem natural'</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.rsort.php' class='function' rel='rdfs-seeAlso'>rsort()</a> - Ordena um array em ordem descrescente</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="krsort" value="<div id='function.krsort' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.krsort.php'>krsort</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>krsort</span> &amp;mdash; <span class='dc-title'>Ordena um array pelas chaves em ordem descrescente</span></p> </div> <a name='function.krsort.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>krsort</b></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$array</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$sort_flags</tt></span> ] )</div> <p class='para rdfs-comment'> Ordena um array pelas chaves em ordem descrescente, mantendo a correla&amp;ccedil;&amp;atilde;o entre entre as chaves e os valores. Essa fun&amp;ccedil;&amp;atilde;o &amp;eacute; bastante &amp;uacute;til em arrays associativos. </p> </div> <a name='function.krsort.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'>array</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O array de entrada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>sort_flags</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Voc&amp;ecirc; pode modificar o comportamento da ordena&amp;ccedil;&amp;atilde;o usando o par&amp;acirc;metro opcional <i><tt class='parameter'>sort_flags</tt></i> , para detalhes veja <a href='http://www.php.net/manual/pt_BR/function.sort.php' class='function'>sort()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.krsort.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.krsort.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de <b>krsort()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$fruits&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'d'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'lemon'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'a'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'orange'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'b'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'banana'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'c'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'apple'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>krsort</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$fruits</span><span style='color: #007700'>);<br />foreach&amp;nbsp;(</span><span style='color: #0000BB'>$fruits&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$key&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$key</span><span style='color: #DD0000'>&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>$val</span><span style='color: #DD0000'>\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> d = limao c = melancia b = banana a = laranja </pre></div> </div> </div><p> </p> </div> <a name='function.krsort.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.asort.php' class='function' rel='rdfs-seeAlso'>asort()</a> - Ordena um array mantendo a associa&amp;ccedil;&amp;atilde;o entre &amp;iacute;ndices e valores</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.arsort.php' class='function' rel='rdfs-seeAlso'>arsort()</a> - Ordena um array em ordem descrescente mantendo a associa&amp;ccedil;&amp;atilde;o entre &amp;iacute;ndices e valores</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ksort.php' class='function' rel='rdfs-seeAlso'>ksort()</a> - Ordena um array pelas chaves</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.sort.php' class='function' rel='rdfs-seeAlso'>sort()</a> - Ordena um array</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.natsort.php' class='function' rel='rdfs-seeAlso'>natsort()</a> - Ordena um array utilizando o algoritmo da 'ordem natural'</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.rsort.php' class='function' rel='rdfs-seeAlso'>rsort()</a> - Ordena um array em ordem descrescente</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="key" value="<div id='function.key' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.key.php'>key</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>key</span> &amp;mdash; <span class='dc-title'>Retorna uma chave de um array</span></p> </div> <a name='function.key.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>key</b></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter reference'>&amp;amp;$array</tt></span> )</div> <p class='para rdfs-comment'> <b>key()</b> retorna a chave da posi&amp;ccedil;&amp;atilde;o atual de um array. </p> </div> <a name='function.key.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'>array</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O array. </p> </dd> </dl> <p> </p> </div> <a name='function.key.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o &amp;iacute;ndice. </p> </div> <a name='function.key.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>key()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$array&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'fruit1'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'apple'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'fruit2'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'orange'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'fruit3'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'grape'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'fruit4'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'apple'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'fruit5'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'apple'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;este&amp;nbsp;ciclo&amp;nbsp;exibir&amp;aacute;&amp;nbsp;toda&amp;nbsp;a&amp;nbsp;chave&amp;nbsp;do&amp;nbsp;array&amp;nbsp;associativo<br />//&amp;nbsp;onde&amp;nbsp;o&amp;nbsp;valor&amp;nbsp;&amp;eacute;&amp;nbsp;igual&amp;nbsp;a&amp;nbsp;'apple'<br /></span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$fruit_name&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>current</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$array</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$fruit_name&amp;nbsp;</span><span style='color: #007700'>==&amp;nbsp;</span><span style='color: #DD0000'>'apple'</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: #0000BB'>key</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$array</span><span style='color: #007700'>).</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;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>next</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$array</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> fruit1&amp;lt;br /&amp;gt; fruit4&amp;lt;br /&amp;gt; fruit5&amp;lt;br /&amp;gt; </pre></div> </div> </div><p> </p> </div> <a name='function.key.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.current.php' class='function' rel='rdfs-seeAlso'>current()</a> - Retorna o elemento corrente em um array</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.next.php' class='function' rel='rdfs-seeAlso'>next()</a> - Avan&amp;ccedil;a o ponteiro interno de 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="json_encode" value="<div id='function.json-encode' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.json-encode.php'>json_encode</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0, PECL json &amp;gt;= 1.2.0)</p><p class='refpurpose'><span class='refname'>json_encode</span> &amp;mdash; <span class='dc-title'>Retorna a representa&amp;ccedil;&amp;atilde;o JSON de um valor</span></p> </div> <a name='function.json-encode.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>json_encode</b></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'>$value</tt></span> )</div> <p class='para rdfs-comment'> Retorna a string contendo a representa&amp;ccedil;&amp;atilde;o JSON de um <i><tt class='parameter'>value</tt></i> . </p> </div> <a name='function.json-encode.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'>value</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O <i><tt class='parameter'>value</tt></i> a ser codificado. Pode ser qualquer tipo, exceto um <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a>. </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o funciona somente com dados com codifica&amp;ccedil;&amp;atilde;o UTF-8. </p> </dd> </dl> <p> </p> </div> <a name='function.json-encode.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> JSON codificada em caso de sucesso. </p> </div> <a name='function.json-encode.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.1</td> <td align='left'> Adicionado suporte a tipos b&amp;aacute;sicos JSON </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.json-encode.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo da <b>json_encode()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$arr&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array&amp;nbsp;(</span><span style='color: #DD0000'>'a'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'b'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'c'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'d'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'e'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>json_encode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$arr</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> {&amp;quot;a&amp;quot;:1,&amp;quot;b&amp;quot;:2,&amp;quot;c&amp;quot;:3,&amp;quot;d&amp;quot;:4,&amp;quot;e&amp;quot;:5} </pre></div> </div> </div><p> </p> </div> <a name='function.json-encode.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.json-decode.php' class='function' rel='rdfs-seeAlso'>json_decode()</a> - Decodifica uma string JSON</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="json_decode" value="<div id='function.json-decode' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.json-decode.php'>json_decode</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.0, PECL json &amp;gt;= 1.2.0)</p><p class='refpurpose'><span class='refname'>json_decode</span> &amp;mdash; <span class='dc-title'>Decodifica uma string JSON</span></p> </div> <a name='function.json-decode.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>json_decode</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$json</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$assoc</tt></span> ] )</div> <p class='para rdfs-comment'> Analisa a string codificada JSON e converte-a em uma vari&amp;aacute;vel do PHP. </p> </div> <a name='function.json-decode.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'>json</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> <i><tt class='parameter'>json</tt></i> a ser decodificada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>assoc</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Quando <b><tt class='constant'>TRUE</tt></b>, o <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a> retornado ser&amp;aacute; convertido em <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> associativo. </p> </dd> </dl> <p> </p> </div> <a name='function.json-decode.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a> ou um <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a> associativo se o par&amp;acirc;metro opcional <i><tt class='parameter'>assoc</tt></i> &amp;eacute; <b><tt class='constant'>TRUE</tt></b>. </p> </div> <a name='function.json-decode.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>json_decode()</b> exemplos</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$json&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'{'a':1,'b':2,'c':3,'d':4,'e':5}'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>json_decode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$json</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>json_decode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$json</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'>?&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> object(stdClass)#1 (5) { [&amp;quot;a&amp;quot;] =&amp;gt; int(1) [&amp;quot;b&amp;quot;] =&amp;gt; int(2) [&amp;quot;c&amp;quot;] =&amp;gt; int(3) [&amp;quot;d&amp;quot;] =&amp;gt; int(4) [&amp;quot;e&amp;quot;] =&amp;gt; int(5) } array(5) { [&amp;quot;a&amp;quot;] =&amp;gt; int(1) [&amp;quot;b&amp;quot;] =&amp;gt; int(2) [&amp;quot;c&amp;quot;] =&amp;gt; int(3) [&amp;quot;d&amp;quot;] =&amp;gt; int(4) [&amp;quot;e&amp;quot;] =&amp;gt; int(5) } </pre></div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Um outro exemplo</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$json&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'{'foo-bar':&amp;nbsp;12345}'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$obj&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>json_decode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$json</span><span style='color: #007700'>);<br />print&amp;nbsp;</span><span style='color: #0000BB'>$obj</span><span style='color: #007700'>-&amp;gt;{</span><span style='color: #DD0000'>'foo-bar'</span><span style='color: #007700'>};&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;12345<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.json-decode.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <div class='caution'><b class='caution'>Cuidado</b> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; retorna false se o dado codificado JSON possui mais que 127 elementos. </p> </div> </div> <a name='function.json-decode.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.3</td> <td align='left'>O limite de aninhamento foi aumentado de 20 para 128</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.json-decode.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.json-encode.php' class='function' rel='rdfs-seeAlso'>json_encode()</a> - Retorna a representa&amp;ccedil;&amp;atilde;o JSON de um valor</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="jpeg2wbmp" value="<div id='function.jpeg2wbmp' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.jpeg2wbmp.php'>jpeg2wbmp</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>jpeg2wbmp</span> &amp;mdash; <span class='dc-title'>Converte um arquivo de imagem JPEG para um arquivo de imagem WBMP</span></p> </div> <a name='function.jpeg2wbmp.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>jpeg2wbmp</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$jpegname</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$wbmpname</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dest_height</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dest_width</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$threshold</tt></span> )</div> <p class='para rdfs-comment'> Converte o arquivo JPEG em arquivo WBMP. </p> </div> <a name='function.jpeg2wbmp.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'>jpegname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para o arquivo JPEG </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>wbmpname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho de destino do arquivo WBMP </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dest_height</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Altura da imagem destino </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dest_width</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Largura da imagem destino </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>threshold</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.jpeg2wbmp.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.jpeg2wbmp.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O suporte a WBMP esta dispon&amp;iacute;vel apenas se o PHP for compilado com GD-1.8 ou posterior.</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O suporte a JPEG esta dispon&amp;iacute;vel apenas se o PHP for compilado com GD-1.8 ou posterior.</span></p></blockquote> </div> <a name='function.jpeg2wbmp.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.png2wbmp.php' class='function' rel='rdfs-seeAlso'>png2wbmp()</a> - Converte um arquivo de imagem PNG para um arquivo de imagem WBMP</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="iterator_to_array" value="<div id='function.iterator-to-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.iterator-to-array.php'>iterator_to_array</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>iterator_to_array</span> &amp;mdash; <span class='dc-title'>Copia o iterador em um array</span></p> </div> <a name='function.iterator-to-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>iterator_to_array</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.iteratoraggregate.php' class='type IteratorAggregate'>IteratorAggregate</a></span> <tt class='parameter'>$iterator</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$use_keys</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> <p class='para'> Conta os elementos em um iterador. </p> </div> <a name='function.iterator-to-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'>iterator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O iterador a ser contado. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>use_keys</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.iterator-to-array.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O n&amp;uacute;mero de elementos em <i><tt class='parameter'>iterator</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="iterator_count" value="<div id='function.iterator-count' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.iterator-count.php'>iterator_count</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>iterator_count</span> &amp;mdash; <span class='dc-title'>Conta o n&amp;uacute;mero de elementos do iterador</span></p> </div> <a name='function.iterator-count.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>iterator_count</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.iteratoraggregate.php' class='type IteratorAggregate'>IteratorAggregate</a></span> <tt class='parameter'>$iterator</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> <p class='para'> Conta os elementos em um iterador. </p> </div> <a name='function.iterator-count.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'>iterator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O iterador a ser contado. </p> </dd> </dl> <p> </p> </div> <a name='function.iterator-count.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O n&amp;uacute;mero de elementos no <i><tt class='parameter'>iterator</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="iterator_apply" value="<div id='function.iterator-apply' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.iterator-apply.php'>iterator_apply</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>iterator_apply</span> &amp;mdash; <span class='dc-title'>Call a function for every element in an iterator</span></p> </div> <a name='function.iterator-apply.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>iterator_apply</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='type Traversable'>Traversable</a></span> <tt class='parameter'>$iterator</tt></span> , <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/language.pseudo-types.php#language.types.callback' class='type callback'>callback</a></span> <tt class='parameter'>$function</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$args</tt></span> ] )</div> <p class='para rdfs-comment'> Calls a function for every element in an iterator. </p> </div> <a name='function.iterator-apply.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'>iterator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The class to iterate over. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>function</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The callback function to call on every element. </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> The function must return <b><tt class='constant'>TRUE</tt></b> in order to continue iterating over the <i><tt class='parameter'>iterator</tt></i> . </span> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>args</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Arguments to pass to the callback function. </p> </dd> </dl> <p> </p> </div> <a name='function.iterator-apply.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the iteration count. </p> </div> <a name='function.iterator-apply.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>iterator_apply()</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 /></span><span style='color: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>print_caps</span><span style='color: #007700'>(</span><span style='color: #0000BB'>Iterator&amp;nbsp;$iterator</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>strtoupper</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$iterator</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>current</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;return&amp;nbsp;</span><span style='color: #0000BB'>TRUE</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>$it&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>ArrayIterator</span><span style='color: #007700'>(array(</span><span style='color: #DD0000'>'Apples'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Bananas'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Cherries'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>iterator_apply</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$it</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'print_caps'</span><span style='color: #007700'>,&amp;nbsp;array(</span><span style='color: #0000BB'>$it</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> APPLES BANANAS CHERRIES </pre></div> </div> </div><p> </p> </div> <a name='function.iterator-apply.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.array-walk.php' class='function' rel='rdfs-seeAlso'>array_walk()</a> - Aplica uma determinada func&amp;atilde;o em cada elemento de 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="IteratorIterator::__construct" value="<div id='iteratoriterator.construct' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.construct.php'>IteratorIterator::__construct</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::__construct</span> &amp;mdash; <span class='dc-title'>Create an iterator from anything that is traversable</span></p> </div> <a name='iteratoriterator.construct.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='methodname'><b>IteratorIterator::__construct</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='type Traversable'>Traversable</a></span> <tt class='parameter'>$iterator</tt></span> )</div> <p class='para rdfs-comment'> Creates an iterator from anything that is traversable. </p> </div> <a name='iteratoriterator.construct.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'>iterator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The traversable iterator. </p> </dd> </dl> <p> </p> </div> <a name='iteratoriterator.construct.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='iteratoriterator.construct.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/class.traversable.php' class='classname'>Traversable</a></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="IteratorIterator::valid" value="<div id='iteratoriterator.valid' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.valid.php'>IteratorIterator::valid</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::valid</span> &amp;mdash; <span class='dc-title'>Checks if the iterator is valid</span></p> </div> <a name='iteratoriterator.valid.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>bool</span> <span class='methodname'><b>IteratorIterator::valid</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Checks if the iterator is valid. </p> </div> <a name='iteratoriterator.valid.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoriterator.valid.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 iterator is valid, otherwise <b><tt class='constant'>FALSE</tt></b> </p> </div> <a name='iteratoriterator.valid.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.iterator-count.php' class='function' rel='rdfs-seeAlso'>iterator_count()</a> - Conta o n&amp;uacute;mero de elementos do iterador</li> <li class='member'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.current.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::current</a> - Get the current value</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="IteratorIterator::rewind" value="<div id='iteratoriterator.rewind' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.rewind.php'>IteratorIterator::rewind</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::rewind</span> &amp;mdash; <span class='dc-title'>Rewind to the first element</span></p> </div> <a name='iteratoriterator.rewind.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>IteratorIterator::rewind</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Rewinds to the first element. </p> </div> <a name='iteratoriterator.rewind.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoriterator.rewind.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='iteratoriterator.rewind.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.next.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::next</a> - Forward to the next element</span></li> <li class='member'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.valid.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::valid</a> - Checks if the iterator is valid</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="IteratorIterator::next" value="<div id='iteratoriterator.next' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.next.php'>IteratorIterator::next</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::next</span> &amp;mdash; <span class='dc-title'>Forward to the next element</span></p> </div> <a name='iteratoriterator.next.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>IteratorIterator::next</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Forward to the next element. </p> </div> <a name='iteratoriterator.next.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoriterator.next.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='iteratoriterator.next.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.rewind.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::rewind</a> - Rewind to the first element</span></li> <li class='member'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.valid.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::valid</a> - Checks if the iterator is valid</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="IteratorIterator::key" value="<div id='iteratoriterator.key' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.key.php'>IteratorIterator::key</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::key</span> &amp;mdash; <span class='dc-title'>Get the key of the current element</span></p> </div> <a name='iteratoriterator.key.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>IteratorIterator::key</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Get the key of the current element. </p> </div> <a name='iteratoriterator.key.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoriterator.key.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The key of the current element. </p> </div> <a name='iteratoriterator.key.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.current.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::current</a> - Get the current value</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="IteratorIterator::getInnerIterator" value="<div id='iteratoriterator.getinneriterator' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.getinneriterator.php'>IteratorIterator::getInnerIterator</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::getInnerIterator</span> &amp;mdash; <span class='dc-title'>Get the inner iterator</span></p> </div> <a name='iteratoriterator.getinneriterator.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>IteratorIterator::getInnerIterator</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Get the inner iterator. </p> </div> <a name='iteratoriterator.getinneriterator.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoriterator.getinneriterator.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The inner iterator as passed to <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.construct.php' class='function'>IteratorIterator::__construct</a></span>. </p> </div> <a name='iteratoriterator.getinneriterator.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/class.iterator.php' class='classname'>Iterator</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/class.outeriterator.php' class='classname'>OuterIterator</a></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="IteratorIterator::current" value="<div id='iteratoriterator.current' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoriterator.current.php'>IteratorIterator::current</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorIterator::current</span> &amp;mdash; <span class='dc-title'>Get the current value</span></p> </div> <a name='iteratoriterator.current.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>IteratorIterator::current</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Get the value of the current element. </p> </div> <a name='iteratoriterator.current.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoriterator.current.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The value of the current element. </p> </div> <a name='iteratoriterator.current.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.key.php' class='function' rel='rdfs-seeAlso'>IteratorIterator::key</a> - Get the key of the current element</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="IteratorIterator" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.iteratoriterator.php'>The IteratorIterator class</a></h1> <div class='partintro'> <div id='iteratoriterator.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> This iterator wrapper allows the conversion of anything that is <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='link'>Traversable</a> into an Iterator. It is important to understand that most classes that do not implement Iterators have reasons as most likely they do not allow the full Iterator feature set. If so, techniques should be provided to prevent misuse, otherwise expect exceptions or fatal errors. </p> </div> <div id='iteratoriterator.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>IteratorIterator</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>IteratorIterator</b> </span> <span class='oointerface'>implements <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='interfacename'>Iterator</a> </span> <span class='oointerface'>, <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='interfacename'>Traversable</a> </span> <span class='oointerface'>, <a href='http://www.php.net/manual/pt_BR/class.outeriterator.php' class='interfacename'>OuterIterator</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Methods */</div> <div class='methodsynopsis dc-description'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.construct.php' class='function'>__construct</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='type Traversable'>Traversable</a></span> <tt class='parameter'>$iterator</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.current.php' class='function'>current</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.getinneriterator.php' class='function'>getInnerIterator</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.key.php' class='function'>key</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.next.php' class='function'>next</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.rewind.php' class='function'>rewind</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.valid.php' class='function'>valid</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.construct.php'>IteratorIterator::__construct</a> &amp;mdash; Create an iterator from anything that is traversable</li><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.current.php'>IteratorIterator::current</a> &amp;mdash; Get the current value</li><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.getinneriterator.php'>IteratorIterator::getInnerIterator</a> &amp;mdash; Get the inner iterator</li><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.key.php'>IteratorIterator::key</a> &amp;mdash; Get the key of the current element</li><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.next.php'>IteratorIterator::next</a> &amp;mdash; Forward to the next element</li><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.rewind.php'>IteratorIterator::rewind</a> &amp;mdash; Rewind to the first element</li><li><a href='http://www.php.net/manual/pt_BR/iteratoriterator.valid.php'>IteratorIterator::valid</a> &amp;mdash; Checks if the iterator is valid</li></ul> </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="IteratorAggregate::getIterator" value="<div id='iteratoraggregate.getiterator' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iteratoraggregate.getiterator.php'>IteratorAggregate::getIterator</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>IteratorAggregate::getIterator</span> &amp;mdash; <span class='dc-title'>Retrieve an external iterator</span></p> </div> <a name='iteratoraggregate.getiterator.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'><a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='type Traversable'>Traversable</a></span> <span class='methodname'><b>IteratorAggregate::getIterator</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Returns an external iterator. </p> </div> <a name='iteratoraggregate.getiterator.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iteratoraggregate.getiterator.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> An instance of an object implementing <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='classname'>Iterator</a> or <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='classname'>Traversable</a> </p> </div> <a name='iteratoraggregate.getiterator.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> Throws an <a href='http://www.php.net/manual/pt_BR/class.exception.php' class='classname'>Exception</a> on failure. </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="IteratorAggregate" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.iteratoraggregate.php'>The IteratorAggregate interface</a></h1> <div class='partintro'> <div id='iteratoraggregate.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Interface to create an external Iterator. </p> </div> <div id='iteratoraggregate.synopsis' class='section'> <h2 class='title'>Resumo da Interface</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>IteratorAggregate</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>IteratorAggregate</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='classname'>Traversable</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Methods */</div> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>Traversable</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoraggregate.getiterator.php' class='function'>getIterator</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </div> <div id='iteratoraggregate.examples' class='section'> <div class='example'> <p><b>Exemplo #1 Basic usage</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: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>myData&amp;nbsp;</span><span style='color: #007700'>implements&amp;nbsp;</span><span style='color: #0000BB'>IteratorAggregate&amp;nbsp;</span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;</span><span style='color: #0000BB'>$property1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Public&amp;nbsp;property&amp;nbsp;one'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;</span><span style='color: #0000BB'>$property2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Public&amp;nbsp;property&amp;nbsp;two'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;</span><span style='color: #0000BB'>$property3&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Public&amp;nbsp;property&amp;nbsp;three'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>__construct</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'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>property4&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'last&amp;nbsp;property'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>getIterator</span><span style='color: #007700'>()&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>ArrayIterator</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$this</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /><br /></span><span style='color: #0000BB'>$obj&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>myData</span><span style='color: #007700'>;<br /><br />foreach(</span><span style='color: #0000BB'>$obj&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$key&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$value</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'>$key</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$value</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'\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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> string(9) &amp;quot;property1&amp;quot; string(19) &amp;quot;Public property one&amp;quot; string(9) &amp;quot;property2&amp;quot; string(19) &amp;quot;Public property two&amp;quot; string(9) &amp;quot;property3&amp;quot; string(21) &amp;quot;Public property three&amp;quot; string(9) &amp;quot;property4&amp;quot; string(13) &amp;quot;last property&amp;quot; </pre></div> </div> </div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/iteratoraggregate.getiterator.php'>IteratorAggregate::getIterator</a> &amp;mdash; Retrieve an external iterator</li></ul> </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="Iterator::valid" value="<div id='iterator.valid' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iterator.valid.php'>Iterator::valid</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>Iterator::valid</span> &amp;mdash; <span class='dc-title'>Checks if current position is valid</span></p> </div> <a name='iterator.valid.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>boolean</span> <span class='methodname'><b>Iterator::valid</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> This method is called after <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.rewind.php' class='function'>Iterator::rewind</a></span> and <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.next.php' class='function'>Iterator::next</a></span> to check if the current position is valid. </p> </div> <a name='iterator.valid.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iterator.valid.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The return value will be casted to <a href='http://www.php.net/manual/pt_BR/language.types.boolean.php' class='type boolean'>boolean</a> and then evaluated. 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="Iterator::rewind" value="<div id='iterator.rewind' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iterator.rewind.php'>Iterator::rewind</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>Iterator::rewind</span> &amp;mdash; <span class='dc-title'>Rewind the Iterator to the first element</span></p> </div> <a name='iterator.rewind.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>Iterator::rewind</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Rewinds back to the first element of the Iterator. </p> <blockquote><p><b class='note'>Nota</b>: This is the <em class='emphasis'>first</em> method called when starting a <a href='http://www.php.net/manual/pt_BR/control-structures.foreach.php' class='link'>foreach</a> loop. It will <em class='emphasis'>not</em> be executed <em class='emphasis'>after</em> <a href='http://www.php.net/manual/pt_BR/control-structures.foreach.php' class='link'>foreach</a> loops. <br /> </p></blockquote> </div> <a name='iterator.rewind.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iterator.rewind.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Any returned value is ignored. </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="Iterator::next" value="<div id='iterator.next' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iterator.next.php'>Iterator::next</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>Iterator::next</span> &amp;mdash; <span class='dc-title'>Move forward to next element</span></p> </div> <a name='iterator.next.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>Iterator::next</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Moves the current position to the next element. </p> <blockquote><p><b class='note'>Nota</b>: This method is called <em class='emphasis'>after</em> each <a href='http://www.php.net/manual/pt_BR/control-structures.foreach.php' class='link'>foreach</a> loop. <br /> </p></blockquote> </div> <a name='iterator.next.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iterator.next.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Any returned value is ignored. </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="Iterator::key" value="<div id='iterator.key' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iterator.key.php'>Iterator::key</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>Iterator::key</span> &amp;mdash; <span class='dc-title'>Return the key of the current element</span></p> </div> <a name='iterator.key.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'><span class='type scalar'>scalar</span></span> <span class='methodname'><b>Iterator::key</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Returns the key of the current element. </p> </div> <a name='iterator.key.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iterator.key.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns <span class='type scalar'>scalar</span> on success, <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> <i>0</i> on failure. </p> </div> <a name='iterator.key.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> Issues <b><tt class='constant'>E_WARNING</tt></b> on failure. </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="Iterator::current" value="<div id='iterator.current' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/iterator.current.php'>Iterator::current</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>Iterator::current</span> &amp;mdash; <span class='dc-title'>Return the current element</span></p> </div> <a name='iterator.current.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <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>Iterator::current</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Returns the current element. </p> </div> <a name='iterator.current.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='iterator.current.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Can return any type. </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="Iterator" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.iterator.php'>The Iterator interface</a></h1> <div class='partintro'> <div id='iterator.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Interface for external iterators or objects that can be iterated themselves internally. </p> </div> <div id='iterator.synopsis' class='section'> <h2 class='title'>Resumo da Interface</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>Iterator</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>Iterator</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='classname'>Traversable</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Methods */</div> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>mixed</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.current.php' class='function'>current</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>scalar</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.key.php' class='function'>key</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.next.php' class='function'>next</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.rewind.php' class='function'>rewind</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>abstract</span> <span class='modifier'>public</span> <span class='type'>boolean</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iterator.valid.php' class='function'>valid</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </div> <div id='iterator.examples' class='section'> <div class='example'> <p><b>Exemplo #1 Basic usage</b></p> <div class='example-contents para'><p> This example demonstrates in which order methods are called when using <a href='http://www.php.net/manual/pt_BR/control-structures.foreach.php' class='link'>foreach</a> with an iterator. </p></div> <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: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>myIterator&amp;nbsp;</span><span style='color: #007700'>implements&amp;nbsp;</span><span style='color: #0000BB'>Iterator&amp;nbsp;</span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;private&amp;nbsp;</span><span style='color: #0000BB'>$position&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;private&amp;nbsp;</span><span style='color: #0000BB'>$array&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'firstelement'</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: #DD0000'>'secondelement'</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: #DD0000'>'lastelement'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;);&amp;nbsp;&amp;nbsp;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;public&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>__construct</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'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>position&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;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>rewind</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'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>__METHOD__</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'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>position&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;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>current</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'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>__METHOD__</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>array</span><span style='color: #007700'>[</span><span style='color: #0000BB'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>position</span><span style='color: #007700'>];<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>key</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'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>__METHOD__</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>position</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>next</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'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>__METHOD__</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'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>position</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>valid</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'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>__METHOD__</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;isset(</span><span style='color: #0000BB'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>array</span><span style='color: #007700'>[</span><span style='color: #0000BB'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>position</span><span style='color: #007700'>]);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /><br /></span><span style='color: #0000BB'>$it&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>myIterator</span><span style='color: #007700'>;<br /><br />foreach(</span><span style='color: #0000BB'>$it&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$key&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$value</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'>$key</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$value</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'\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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> string(18) &amp;quot;myIterator::rewind&amp;quot; string(17) &amp;quot;myIterator::valid&amp;quot; string(19) &amp;quot;myIterator::current&amp;quot; string(15) &amp;quot;myIterator::key&amp;quot; int(0) string(12) &amp;quot;firstelement&amp;quot; string(16) &amp;quot;myIterator::next&amp;quot; string(17) &amp;quot;myIterator::valid&amp;quot; string(19) &amp;quot;myIterator::current&amp;quot; string(15) &amp;quot;myIterator::key&amp;quot; int(1) string(13) &amp;quot;secondelement&amp;quot; string(16) &amp;quot;myIterator::next&amp;quot; string(17) &amp;quot;myIterator::valid&amp;quot; string(19) &amp;quot;myIterator::current&amp;quot; string(15) &amp;quot;myIterator::key&amp;quot; int(2) string(11) &amp;quot;lastelement&amp;quot; string(16) &amp;quot;myIterator::next&amp;quot; string(17) &amp;quot;myIterator::valid&amp;quot; </pre></div> </div> </div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/iterator.current.php'>Iterator::current</a> &amp;mdash; Return the current element</li><li><a href='http://www.php.net/manual/pt_BR/iterator.key.php'>Iterator::key</a> &amp;mdash; Return the key of the current element</li><li><a href='http://www.php.net/manual/pt_BR/iterator.next.php'>Iterator::next</a> &amp;mdash; Move forward to next element</li><li><a href='http://www.php.net/manual/pt_BR/iterator.rewind.php'>Iterator::rewind</a> &amp;mdash; Rewind the Iterator to the first element</li><li><a href='http://www.php.net/manual/pt_BR/iterator.valid.php'>Iterator::valid</a> &amp;mdash; Checks if current position is valid</li></ul> </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="is_writable" value="<div id='function.is-writable' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-writable.php'>is_writable</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_writable</span> &amp;mdash; <span class='dc-title'>Diz se o arquivo pode ser modificado</span></p> </div> <a name='function.is-writable.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>is_writable</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Retorna <b><tt class='constant'>TRUE</tt></b> se o arquivo em <i><tt class='parameter'>filename</tt></i> existe e pode ser modificado. O argumento <i><tt class='parameter'>filename</tt></i> pode ser um diret&amp;oacute;rio, permitindo que voc&amp;ecirc; verifique se o diret&amp;oacute;rio tem permiss&amp;atilde;o de escrita. </p> <p class='para'> Lembre-se que o PHP pode acessar o arquivo como o usu&amp;aacute;rio com o qual o servidor web &amp;eacute; executado (geralmente &amp;#039;nobody&amp;#039;). Limita&amp;ccedil;&amp;otilde;es de Safe Mode n&amp;atilde;o s&amp;atilde;o levadas em conta antes do PHP 5.1.5. </p> </div> <a name='function.is-writable.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O arquivo sendo verificado. </p> </dd> </dl> <p> </p> </div> <a name='function.is-writable.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o arquivo em <i><tt class='parameter'>filename</tt></i> existe e pode ser modificado. </p> </div> <a name='function.is-writable.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de <b>is_writable()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$filename&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'teste.txt'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>is_writable</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;arquivo&amp;nbsp;possui&amp;nbsp;permiss&amp;atilde;o&amp;nbsp;de&amp;nbsp;escrita'</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'>'O&amp;nbsp;arquivo&amp;nbsp;n&amp;atilde;o&amp;nbsp;possui&amp;nbsp;permiss&amp;atilde;o&amp;nbsp;de&amp;nbsp;escrita'</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.is-writable.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> </div> <a name='function.is-writable.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.is-readable.php' class='function' rel='rdfs-seeAlso'>is_readable()</a> - Diz se o arquivo pode ser lido</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.file-exists.php' class='function' rel='rdfs-seeAlso'>file_exists()</a> - Checa se um arquivo ou diret&amp;oacute;rio existe</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.fwrite.php' class='function' rel='rdfs-seeAlso'>fwrite()</a> - Escrita binary-safe em arquivos</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="is_uploaded_file" value="<div id='function.is-uploaded-file' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-uploaded-file.php'>is_uploaded_file</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.3, PHP 5)</p><p class='refpurpose'><span class='refname'>is_uploaded_file</span> &amp;mdash; <span class='dc-title'>Diz se o arquivo foi enviado por POST HTTP</span></p> </div> <a name='function.is-uploaded-file.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>is_uploaded_file</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Retorna <b><tt class='constant'>TRUE</tt></b> se o arquivo com o nome <var class='varname'>filename</var> foi enviado por POST HTTP. Isto &amp;eacute; &amp;uacute;til para ter certeza que um usu&amp;aacute;rio malicioso n&amp;atilde;o est&amp;aacute; tentando levar o script a trabalhar em arquivos que n&amp;atilde;o deve estar trabalhando --- por exemplo, <var class='filename'>/etc/passwd</var>. </p> <p class='para'> Este tipo de confirma&amp;ccedil;&amp;atilde;o &amp;eacute; importante principalmente se existe alguma chance que qualquer coisa feita com os arquivos carregados possa revelar seu conte&amp;uacute;do para o usu&amp;aacute;rio, ou mesmo para outros usu&amp;aacute;rios no mesmo sistema. </p> <p class='para'> Para o funcionamento apropriado, a fun&amp;ccedil;&amp;atilde;o <b>is_uploaded_file()</b> precisa de um argumento como $_FILES[&amp;#039;userfile&amp;#039;][&amp;#039;tmp_name&amp;#039;], - o nome do arquivo enviado na m&amp;aacute;quina do cliente $_FILES[&amp;#039;userfile&amp;#039;][&amp;#039;name&amp;#039;] n&amp;atilde;o funciona. </p> </div> <a name='function.is-uploaded-file.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do arquivo sendo checado. </p> </dd> </dl> <p> </p> </div> <a name='function.is-uploaded-file.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.is-uploaded-file.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de <b>is_uploaded_file()</b></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: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>is_uploaded_file</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$_FILES</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'userfile'</span><span style='color: #007700'>][</span><span style='color: #DD0000'>'tmp_name'</span><span style='color: #007700'>]))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;arquivo&amp;nbsp;'</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$_FILES</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'userfile'</span><span style='color: #007700'>][</span><span style='color: #DD0000'>'name'</span><span style='color: #007700'>]&amp;nbsp;.</span><span style='color: #DD0000'>'&amp;nbsp;foi&amp;nbsp;enviado&amp;nbsp;com&amp;nbsp;sucesso.\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Mostrando&amp;nbsp;o&amp;nbsp;conte&amp;uacute;do\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>readfile</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$_FILES</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'userfile'</span><span style='color: #007700'>][</span><span style='color: #DD0000'>'tmp_name'</span><span style='color: #007700'>]);<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Poss&amp;iacute;vel&amp;nbsp;ataque&amp;nbsp;de&amp;nbsp;envio&amp;nbsp;de&amp;nbsp;arquivo:&amp;nbsp;'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'nome&amp;nbsp;do&amp;nbsp;arquivo&amp;nbsp;''</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$_FILES</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'userfile'</span><span style='color: #007700'>][</span><span style='color: #DD0000'>'tmp_name'</span><span style='color: #007700'>]&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>''.'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.is-uploaded-file.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.move-uploaded-file.php' class='function' rel='rdfs-seeAlso'>move_uploaded_file()</a> - Move um arquivo enviado para uma nova localiza&amp;ccedil;&amp;atilde;o</li> <li class='member'>Veja <a href='http://www.php.net/manual/pt_BR/features.file-upload.php' class='link'>Gerenciar upload de arquivo</a> para um simples exemplo de uso.</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="is_subclass_of" value="<div id='function.is-subclass-of' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-subclass-of.php'>is_subclass_of</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_subclass_of</span> &amp;mdash; <span class='dc-title'>Verifica se o objeto tem esta classe como uma de suas classes pai</span></p> </div> <a name='function.is-subclass-of.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>is_subclass_of</b></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'>$object</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$class_name</tt></span> )</div> <p class='para rdfs-comment'> Verifica se o dado <i><tt class='parameter'>object</tt></i> tem a classe <i><tt class='parameter'>class_name</tt></i> como uma de suas classes pai. </p> </div> <a name='function.is-subclass-of.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'>object</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da classe ou um inst&amp;acirc;ncia do objeto </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>class_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da classe </p> </dd> </dl> <p> </p> </div> <a name='function.is-subclass-of.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o retorna <b><tt class='constant'>TRUE</tt></b> se o objeto <i><tt class='parameter'>object</tt></i> , pertence a classe que &amp;eacute; a subclasse de <i><tt class='parameter'>class_name</tt></i> , <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-subclass-of.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.0.3</td> <td align='left'> Voc&amp;ecirc; pode tamb&amp;eacute;m especificar o par&amp;acirc;metro <i><tt class='parameter'>object</tt></i> como uma string (o nome da classe) </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.is-subclass-of.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_subclass_of()</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;define&amp;nbsp;a&amp;nbsp;class<br /></span><span style='color: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory<br /></span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;var&amp;nbsp;</span><span style='color: #0000BB'>$oink&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'moo'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;define&amp;nbsp;a&amp;nbsp;child&amp;nbsp;class<br /></span><span style='color: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory_Child&amp;nbsp;</span><span style='color: #007700'>extends&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory<br /></span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;var&amp;nbsp;</span><span style='color: #0000BB'>$oink&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'oink'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;create&amp;nbsp;a&amp;nbsp;new&amp;nbsp;object<br /></span><span style='color: #0000BB'>$WF&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>$WFC&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory_Child</span><span style='color: #007700'>();<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>is_subclass_of</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$WFC</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'WidgetFactory'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'yes,&amp;nbsp;\$WFC&amp;nbsp;is&amp;nbsp;a&amp;nbsp;subclass&amp;nbsp;of&amp;nbsp;WidgetFactory\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'no,&amp;nbsp;\$WFC&amp;nbsp;is&amp;nbsp;not&amp;nbsp;a&amp;nbsp;subclass&amp;nbsp;of&amp;nbsp;WidgetFactory\n'</span><span style='color: #007700'>;<br />}<br /><br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>is_subclass_of</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$WF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'WidgetFactory'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'yes,&amp;nbsp;\$WF&amp;nbsp;is&amp;nbsp;a&amp;nbsp;subclass&amp;nbsp;of&amp;nbsp;WidgetFactory\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'no,&amp;nbsp;\$WF&amp;nbsp;is&amp;nbsp;not&amp;nbsp;a&amp;nbsp;subclass&amp;nbsp;of&amp;nbsp;WidgetFactory\n'</span><span style='color: #007700'>;<br />}<br /><br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;usable&amp;nbsp;only&amp;nbsp;since&amp;nbsp;PHP&amp;nbsp;5.0.3<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>is_subclass_of</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'WidgetFactory_Child'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'WidgetFactory'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'yes,&amp;nbsp;WidgetFactory_Child&amp;nbsp;is&amp;nbsp;a&amp;nbsp;subclass&amp;nbsp;of&amp;nbsp;WidgetFactory\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'no,&amp;nbsp;WidgetFactory_Child&amp;nbsp;is&amp;nbsp;not&amp;nbsp;a&amp;nbsp;subclass&amp;nbsp;of&amp;nbsp;WidgetFactory\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> yes, $WFC is a subclass of WidgetFactory no, $WF is not a subclass of WidgetFactory yes, WidgetFactory_Child is a subclass of WidgetFactory </pre></div> </div> </div><p> </p> </div> <a name='function.is-subclass-of.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.get-class.php' class='function' rel='rdfs-seeAlso'>get_class()</a> - Retorna o nome da classe de um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.get-parent-class.php' class='function' rel='rdfs-seeAlso'>get_parent_class()</a> - Recupera o nome da classe pai para o objeto ou classe</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-a.php' class='function' rel='rdfs-seeAlso'>is_a()</a> - Verifica se o objeto &amp;eacute; de uma classe ou de sua classe pai</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="is_string" value="<div id='function.is-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-string.php'>is_string</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_string</span> &amp;mdash; <span class='dc-title'>Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</span></p> </div> <a name='function.is-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'>bool</span> <span class='methodname'><b>is_string</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se a dada vari&amp;aacute;vel &amp;eacute; do tipo string. </p> </div> <a name='function.is-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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser analisada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-string.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; do tipo <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a>, <b><tt class='constant'>FALSE</tt></b> sen&amp;atilde;o. </p> </div> <a name='function.is-string.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_string()</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: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>is_string</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'23'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'is&amp;nbsp;string\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'is&amp;nbsp;not&amp;nbsp;an&amp;nbsp;string\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_string</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'abc'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_string</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'23'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>23.5</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_string</span><span style='color: #007700'>(</span><span style='color: #0000BB'>true</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> is string bool(true) bool(true) bool(false) bool(false) </pre></div> </div> </div><p> </p> </div> <a name='function.is-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.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; 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="is_scalar" value="<div id='function.is-scalar' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-scalar.php'>is_scalar</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>is_scalar</span> &amp;mdash; <span class='dc-title'> Informa se &amp;eacute; uma v&amp;aacute;riavel escalar </span></p> </div> <a name='function.is-scalar.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>is_scalar</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se a dada vari&amp;aacute;vel &amp;eacute; uma escalar. </p> <p class='para'> Vari&amp;aacute;veis escalares s&amp;atilde;o as que cont&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>, <a href='http://www.php.net/manual/pt_BR/language.types.float.php' class='type float'>float</a>, <a href='http://www.php.net/manual/pt_BR/language.types.string.php' class='type string'>string</a> ou <a href='http://www.php.net/manual/pt_BR/language.types.boolean.php' class='type boolean'>boolean</a>. os tipos <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a>, <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a> e <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> n&amp;atilde;o s&amp;atilde;o escalares. </p> <blockquote><p><b class='note'>Nota</b>: <b>is_scalar()</b> n&amp;atilde;o considera o tipo <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a> como um valor escalar, apesar de tipos resouce ser uma abstra&amp;ccedil;&amp;atilde;o de dados, atualmente baseados em inteiros. Esse detalhe de implementa&amp;ccedil;&amp;atilde;o poder&amp;aacute; ser modificado futuramente. <br /> </p></blockquote> </div> <a name='function.is-scalar.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-scalar.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; um escalar, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-scalar.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_scalar()</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: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>show_var</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$var</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>is_scalar</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$var</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: #0000BB'>$var</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;</span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$var</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /></span><span style='color: #0000BB'>$pi&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>3.1416</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$proteins&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'hemoglobin'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cytochrome&amp;nbsp;c&amp;nbsp;oxidase'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'ferredoxin'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>show_var</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$pi</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>show_var</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$proteins</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> 3.1416 array(3) { [0]=&amp;gt; string(10) &amp;quot;hemoglobin&amp;quot; [1]=&amp;gt; string(20) &amp;quot;cytochrome c oxidase&amp;quot; [2]=&amp;gt; string(10) &amp;quot;ferredoxin&amp;quot; } </pre></div> </div> </div><p> </p> </div> <a name='function.is-scalar.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.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function' rel='rdfs-seeAlso'>is_numeric()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-real.php' class='function' rel='rdfs-seeAlso'>is_real()</a> - Sin&amp;ocirc;nimo de is_float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; 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="is_resource" value="<div id='function.is-resource' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-resource.php'>is_resource</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_resource</span> &amp;mdash; <span class='dc-title'> Informa se a vari&amp;aacute;vel &amp;eacute; um resource </span></p> </div> <a name='function.is-resource.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>is_resource</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se uma dada vari&amp;aacute;vel &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a>. </p> </div> <a name='function.is-resource.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-resource.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.resource.php' class='type resource'>resource</a>, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-resource.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_resource()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$db_link&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>mysql_connect</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'localhost'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_user'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'mysql_pass'</span><span style='color: #007700'>);<br />if&amp;nbsp;(!</span><span style='color: #0000BB'>is_resource</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$db_link</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'Can\'t&amp;nbsp;connect&amp;nbsp;:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>mysql_error</span><span style='color: #007700'>());<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.is-resource.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/language.types.resource.php' class='link'>The resource-type documentation</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.get-resource-type.php' class='function' rel='rdfs-seeAlso'>get_resource_type()</a> - Retorna o tipo de 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="is_real" value="<div id='function.is-real' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-real.php'>is_real</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_real</span> &amp;mdash; <span class='dc-title'>Sin&amp;ocirc;nimo de <a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function'>is_float()</a></span></p> </div> <a name='function.is-real.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; um apelido para: <a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function'>is_float()</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="is_readable" value="<div id='function.is-readable' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-readable.php'>is_readable</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_readable</span> &amp;mdash; <span class='dc-title'>Diz se o arquivo pode ser lido</span></p> </div> <a name='function.is-readable.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>is_readable</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Diz se o arquivo pode ser lido. </p> </div> <a name='function.is-readable.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho do arquivo. </p> </dd> </dl> <p> </p> </div> <a name='function.is-readable.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o arquivo ou diret&amp;oacute;rio especificado por <i><tt class='parameter'>filename</tt></i> existe e pode ser lido, <b><tt class='constant'>FALSE</tt></b> do contr&amp;aacute;rio. </p> </div> <a name='function.is-readable.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de <b>is_readable()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$filename&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'teste.txt'</span><span style='color: #007700'>;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>is_readable</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;arquivo&amp;nbsp;pode&amp;nbsp;ser&amp;nbsp;lido.'</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'>'O&amp;nbsp;arquivo&amp;nbsp;n&amp;atilde;o&amp;nbsp;pode&amp;nbsp;ser&amp;nbsp;lido.'</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.is-readable.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <p class='para'> Lembre-se que o PHP pode acessar o arquivo como o usu&amp;aacute;rio com o qual o servidor web &amp;eacute; executado (geralmente &amp;#039;nobody&amp;#039;). Limita&amp;ccedil;&amp;otilde;es de Safe Mode n&amp;atilde;o s&amp;atilde;o levadas em conta antes do PHP 5.1.5. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> <blockquote><p><b class='note'>Nota</b>: A verifica&amp;ccedil;&amp;atilde;o &amp;eacute; feita usando os UID/GID reais ao inv&amp;eacute;s dos efetivos. <br /> </p></blockquote> </div> <a name='function.is-readable.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.is-writable.php' class='function' rel='rdfs-seeAlso'>is_writable()</a> - Diz se o arquivo pode ser modificado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.file-exists.php' class='function' rel='rdfs-seeAlso'>file_exists()</a> - Checa se um arquivo ou diret&amp;oacute;rio existe</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.fgets.php' class='function' rel='rdfs-seeAlso'>fgets()</a> - L&amp;ecirc; uma linha de um ponteiro de arquivo</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="is_object" value="<div id='function.is-object' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-object.php'>is_object</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_object</span> &amp;mdash; <span class='dc-title'>Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</span></p> </div> <a name='function.is-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'>bool</span> <span class='methodname'><b>is_object</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se uma dada vari&amp;aacute;vel &amp;eacute; um objeto. </p> </div> <a name='function.is-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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-object.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a>, <b><tt class='constant'>FALSE</tt></b> sen&amp;atilde;o. </p> </div> <a name='function.is-object.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 retornar&amp;aacute; <b><tt class='constant'>FALSE</tt></b> se usada em um objeto n&amp;atilde;o serializado onde a defini&amp;ccedil;&amp;atilde;o da classe n&amp;atilde;o est&amp;aacute; presente (mesmo que <a href='http://www.php.net/manual/pt_BR/function.gettype.php' class='function'>gettype()</a> retorne <a href='http://www.php.net/manual/pt_BR/language.types.object.php' class='type object'>object</a>). <br /> </p></blockquote> </div> <a name='function.is-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.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; 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="is_numeric" value="<div id='function.is-numeric' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-numeric.php'>is_numeric</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_numeric</span> &amp;mdash; <span class='dc-title'> Informa se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica </span></p> </div> <a name='function.is-numeric.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>is_numeric</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se a dada vari&amp;aacute;vel &amp;eacute; num&amp;eacute;rica. Strings num&amp;eacute;ricas consistem de um sinal opcional, algum n&amp;uacute;mero de d&amp;iacute;gitos, opcional parte decimal e opcional parte exponencial. Assim <i>+0123.45e6</i> &amp;eacute; um v&amp;aacute;lido valor num&amp;eacute;rico. Nota&amp;ccedil;&amp;atilde;o hexadecimal (<i>0xFF</i>) &amp;eacute; permitida tamb&amp;eacute;m mas somente sem sinal, decimal e parte exponencial. </p> </div> <a name='function.is-numeric.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-numeric.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-numeric.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.ctype-digit.php' class='function' rel='rdfs-seeAlso'>ctype_digit()</a> - Verifica se os caracteres s&amp;atilde;o num&amp;eacute;ricos</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-null.php' class='function' rel='rdfs-seeAlso'>is_null()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; NULL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; 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="is_null" value="<div id='function.is-null' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-null.php'>is_null</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_null</span> &amp;mdash; <span class='dc-title'> Informa se a vari&amp;aacute;vel &amp;eacute; <b><tt class='constant'>NULL</tt></b> </span></p> </div> <a name='function.is-null.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>is_null</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se uma dada vari&amp;aacute;vel &amp;eacute; <b><tt class='constant'>NULL</tt></b>. </p> </div> <a name='function.is-null.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-null.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; <a href='http://www.php.net/manual/pt_BR/language.types.null.php' class='type null'>null</a>, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-null.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'>O tipo <a href='http://www.php.net/manual/pt_BR/language.types.null.php#language.types.null.syntax' class='link'><b><tt class='constant'>NULL</tt></b></a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.isset.php' class='function' rel='rdfs-seeAlso'>isset()</a> - Informa se a vari&amp;aacute;vel foi iniciada</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function' rel='rdfs-seeAlso'>is_numeric()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; 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="is_nan" value="<div id='function.is-nan' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-nan.php'>is_nan</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>is_nan</span> &amp;mdash; <span class='dc-title'> Verifica se um valor n&amp;atilde;o &amp;eacute; um n&amp;uacute;mero </span></p> </div> <a name='function.is-nan.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>is_nan</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$val</tt></span> )</div> <p class='para rdfs-comment'> Verifica se <i><tt class='parameter'>val</tt></i> &amp;eacute; &amp;#039;n&amp;atilde;o &amp;eacute; um n&amp;uacute;mero&amp;#039;, como o resultado de <i>acos(1.01)</i>. </p> </div> <a name='function.is-nan.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'>val</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The value to check </p> </dd> </dl> <p> </p> </div> <a name='function.is-nan.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>val</tt></i> &amp;eacute; &amp;#039;n&amp;atilde;o &amp;eacute; um num&amp;eacute;ro&amp;#039;, caso contr&amp;aacute;rio <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.is-nan.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.is-finite.php' class='function' rel='rdfs-seeAlso'>is_finite()</a> - Verifica se um valor &amp;eacute; um n&amp;uacute;mero finito</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-infinite.php' class='function' rel='rdfs-seeAlso'>is_infinite()</a> - Descri&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="is_long" value="<div id='function.is-long' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-long.php'>is_long</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_long</span> &amp;mdash; <span class='dc-title'>Sin&amp;ocirc;nimo de <a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function'>is_int()</a></span></p> </div> <a name='function.is-long.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; um apelido para: <a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function'>is_int()</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="is_link" value="<div id='function.is-link' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-link.php'>is_link</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_link</span> &amp;mdash; <span class='dc-title'>Diz se o arquivo &amp;eacute; um link simb&amp;oacute;lico (symbolic link)</span></p> </div> <a name='function.is-link.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>is_link</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$arquivo</tt></span> )</div> <p class='para rdfs-comment'> Informa se um dado arquivo &amp;eacute; um link simb&amp;oacute;lico (symbolic link). </p> </div> <a name='function.is-link.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O caminho para o arquivo. </p> </dd> </dl> <p> </p> </div> <a name='function.is-link.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o nome do arquivo existe e se &amp;eacute; um link simb&amp;oacute;lico, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-link.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> </div> <a name='function.is-link.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.is-dir.php' class='function' rel='rdfs-seeAlso'>is_dir()</a> - Diz se o caminho &amp;eacute; um diret&amp;oacute;rio</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-file.php' class='function' rel='rdfs-seeAlso'>is_file()</a> - Informa se o arquivo &amp;eacute; um arquivo comum (n&amp;atilde;o &amp;eacute; diret&amp;oacute;rio)</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.readlink.php' class='function' rel='rdfs-seeAlso'>readlink()</a> - Retornar o alvo de um link simb&amp;oacute;lico</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="is_integer" value="<div id='function.is-integer' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-integer.php'>is_integer</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_integer</span> &amp;mdash; <span class='dc-title'>Sin&amp;ocirc;nimo de <a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function'>is_int()</a></span></p> </div> <a name='function.is-integer.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; um apelido para: <a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function'>is_int()</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="is_int" value="<div id='function.is-int' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-int.php'>is_int</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_int</span> &amp;mdash; <span class='dc-title'>Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</span></p> </div> <a name='function.is-int.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>is_int</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se a dada vari&amp;aacute;vel &amp;eacute; do tipo inteiro. </p> <blockquote><p><b class='note'>Nota</b>: Para verificar se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica (campos de formul&amp;aacute;rios sempre s&amp;atilde;o strings num&amp;eacute;ricas), use <a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function'>is_numeric()</a>. <br /> </p></blockquote> </div> <a name='function.is-int.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-int.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-int.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_int()</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: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>is_int</span><span style='color: #007700'>(</span><span style='color: #0000BB'>23</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'is&amp;nbsp;integer\n'</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'is&amp;nbsp;not&amp;nbsp;an&amp;nbsp;integer\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_int</span><span style='color: #007700'>(</span><span style='color: #0000BB'>23</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_int</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'23'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_int</span><span style='color: #007700'>(</span><span style='color: #0000BB'>23.5</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_int</span><span style='color: #007700'>(</span><span style='color: #0000BB'>true</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> is integer bool(true) bool(false) bool(false) bool(false) </pre></div> </div> </div><p> </p> </div> <a name='function.is-int.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.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function' rel='rdfs-seeAlso'>is_numeric()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um array</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</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="is_infinite" value="<div id='function.is-infinite' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-infinite.php'>is_infinite</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>is_infinite</span> &amp;mdash; <span class='dc-title'> </span></p> </div> <a name='function.is-infinite.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>is_infinite</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$val</tt></span> )</div> <p class='para rdfs-comment'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>val</tt></i> &amp;eacute; infinito (positivo ou negativo), como por exemplo o resultado de <i>log(0)</i> ou qualquer outro valor muito grande para caber num float desta plataforma. </p> </div> <a name='function.is-infinite.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'>val</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O valor para verificar </p> </dd> </dl> <p> </p> </div> <a name='function.is-infinite.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>val</tt></i> &amp;eacute; infinito, caso contr&amp;aacute;rio <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.is-infinite.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.is-finite.php' class='function' rel='rdfs-seeAlso'>is_finite()</a> - Verifica se um valor &amp;eacute; um n&amp;uacute;mero finito</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-nan.php' class='function' rel='rdfs-seeAlso'>is_nan()</a> - Verifica se um valor n&amp;atilde;o &amp;eacute; um n&amp;uacute;mero</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="is_float" value="<div id='function.is-float' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-float.php'>is_float</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_float</span> &amp;mdash; <span class='dc-title'>Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</span></p> </div> <a name='function.is-float.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>is_float</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se a dada vari&amp;aacute;vel &amp;eacute; do tipo ponto flutuante. </p> <blockquote><p><b class='note'>Nota</b>: Para verificar se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica (campos de formul&amp;aacute;rios sempre s&amp;atilde;o strings n&amp;uacute;mericas), use <a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function'>is_numeric()</a>. <br /> </p></blockquote> </div> <a name='function.is-float.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-float.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; <a href='http://www.php.net/manual/pt_BR/language.types.float.php' class='type float'>float</a>, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-float.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_float()</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: #007700'>if(</span><span style='color: #0000BB'>is_float</span><span style='color: #007700'>(</span><span style='color: #0000BB'>27.25</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'is&amp;nbsp;float\n'</span><span style='color: #007700'>;<br />}else&amp;nbsp;{<br />&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'is&amp;nbsp;not&amp;nbsp;float\n'</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_float</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'abc'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_float</span><span style='color: #007700'>(</span><span style='color: #0000BB'>23</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_float</span><span style='color: #007700'>(</span><span style='color: #0000BB'>23.5</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_float</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1e7</span><span style='color: #007700'>));&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//Scientific&amp;nbsp;Notation<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_float</span><span style='color: #007700'>(</span><span style='color: #0000BB'>true</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> is float bool(false) bool(false) bool(true) bool(true) bool(false) </pre></div> </div> </div><p> </p> </div> <a name='function.is-float.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.is-bool.php' class='function' rel='rdfs-seeAlso'>is_bool()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function' rel='rdfs-seeAlso'>is_numeric()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; um array</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</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="is_finite" value="<div id='function.is-finite' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-finite.php'>is_finite</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>is_finite</span> &amp;mdash; <span class='dc-title'>Verifica se um valor &amp;eacute; um n&amp;uacute;mero finito</span></p> </div> <a name='function.is-finite.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>is_finite</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$val</tt></span> )</div> <p class='para rdfs-comment'> Verifica se <i><tt class='parameter'>val</tt></i> &amp;eacute; n&amp;uacute;mero finito legal na plataforma. </p> </div> <a name='function.is-finite.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'>val</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The value to check </p> </dd> </dl> <p> </p> </div> <a name='function.is-finite.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>val</tt></i> &amp;eacute; um n&amp;uacute;mero finito legal dentro do limite permitido para um float do PHP na plataforma, caso contr&amp;aacute;rio <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.is-finite.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.is-infinite.php' class='function' rel='rdfs-seeAlso'>is_infinite()</a> - Descri&amp;ccedil;&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-nan.php' class='function' rel='rdfs-seeAlso'>is_nan()</a> - Verifica se um valor n&amp;atilde;o &amp;eacute; um n&amp;uacute;mero</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="is_file" value="<div id='function.is-file' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-file.php'>is_file</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_file</span> &amp;mdash; <span class='dc-title'>Informa se o arquivo &amp;eacute; um arquivo comum (n&amp;atilde;o &amp;eacute; diret&amp;oacute;rio)</span></p> </div> <a name='function.is-file.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>is_file</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Informa se o dado arquivo &amp;eacute; um arquivo regular. </p> </div> <a name='function.is-file.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para o arquivo. </p> </dd> </dl> <p> </p> </div> <a name='function.is-file.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o nome do arquivo existe e &amp;eacute; um arquivo regular, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-file.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_file()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_file</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'a_file.txt'</span><span style='color: #007700'>))&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_file</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'/usr/bin/'</span><span style='color: #007700'>))&amp;nbsp;.&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> bool(true) bool(false) </pre></div> </div> </div><p> </p> </div> <a name='function.is-file.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> </div> <a name='function.is-file.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.is-dir.php' class='function' rel='rdfs-seeAlso'>is_dir()</a> - Diz se o caminho &amp;eacute; um diret&amp;oacute;rio</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-link.php' class='function' rel='rdfs-seeAlso'>is_link()</a> - Diz se o arquivo &amp;eacute; um link simb&amp;oacute;lico (symbolic link)</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="is_executable" value="<div id='function.is-executable' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-executable.php'>is_executable</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_executable</span> &amp;mdash; <span class='dc-title'>Diz se um arquivo &amp;eacute; execut&amp;aacute;vel</span></p> </div> <a name='function.is-executable.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>is_executable</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Diz se no nomedoarquivo existe e &amp;eacute; execut&amp;aacute;vel. </p> </div> <a name='function.is-executable.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para o arquivo. </p> </dd> </dl> <p> </p> </div> <a name='function.is-executable.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o nome do arquivo existe e &amp;eacute; execut&amp;aacute;vel, ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> <a name='function.is-executable.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.0.0</td> <td align='left'> <b>is_executable()</b> tornou-se dispon&amp;iacute;vel em <span class='productname'>Windows</span> </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.is-executable.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_executable()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$file&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'/home/vincent/arquivo.sh'</span><span style='color: #007700'>;<br /><br />if(</span><span style='color: #0000BB'>is_executable</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$file</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #0000BB'>$file</span><span style='color: #007700'>.</span><span style='color: #DD0000'>'&amp;nbsp;&amp;eacute;&amp;nbsp;execut&amp;aacute;vel'</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: #0000BB'>$file</span><span style='color: #007700'>.</span><span style='color: #DD0000'>'&amp;nbsp;n&amp;atilde;o&amp;nbsp;&amp;eacute;&amp;nbsp;execut&amp;aacute;vel'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.is-executable.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> </div> <a name='function.is-executable.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.is-file.php' class='function' rel='rdfs-seeAlso'>is_file()</a> - Informa se o arquivo &amp;eacute; um arquivo comum (n&amp;atilde;o &amp;eacute; diret&amp;oacute;rio)</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-link.php' class='function' rel='rdfs-seeAlso'>is_link()</a> - Diz se o arquivo &amp;eacute; um link simb&amp;oacute;lico (symbolic link)</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="is_double" value="<div id='function.is-double' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-double.php'>is_double</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_double</span> &amp;mdash; <span class='dc-title'>Sin&amp;ocirc;nimo de <a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function'>is_float()</a></span></p> </div> <a name='function.is-double.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; um apelido para: <a href='http://www.php.net/manual/pt_BR/function.is-float.php' class='function'>is_float()</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="is_dir" value="<div id='function.is-dir' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-dir.php'>is_dir</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_dir</span> &amp;mdash; <span class='dc-title'>Diz se o caminho &amp;eacute; um diret&amp;oacute;rio</span></p> </div> <a name='function.is-dir.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>is_dir</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Informa se o dado nome de arquivo &amp;eacute; um diret&amp;oacute;rio. </p> </div> <a name='function.is-dir.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para o arquivo. Se <i><tt class='parameter'>filename</tt></i> &amp;eacute; um nome de arquivo relativo, ir&amp;aacute; ser verificado relativamente ao atual diret&amp;oacute;rio. </p> </dd> </dl> <p> </p> </div> <a name='function.is-dir.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o nome do arquivo existe e &amp;eacute; um diret&amp;oacute;rio, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-dir.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_dir()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_dir</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'a_file.txt'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_dir</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'bogus_dir/abc'</span><span style='color: #007700'>));<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_dir</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'..'</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;um&amp;nbsp;diret&amp;oacute;rio&amp;nbsp;acima<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> bool(false) bool(false) bool(true) </pre></div> </div> </div><p> </p> </div> <a name='function.is-dir.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O resultado desta fun&amp;ccedil;&amp;atilde;o &amp;eacute; cacheada. Veja <a href='http://www.php.net/manual/pt_BR/function.clearstatcache.php' class='function'>clearstatcache()</a> para mais detalhes.</span></p></blockquote> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>A partir do PHP 5.0.0, esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m pode ser utilizada com <em class='emphasis'>alguns</em> wrappers URL. Veja <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de quais wrappers s&amp;atilde;o suportados pela fam&amp;iacute;lia de fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.stat.php' class='function'>stat()</a>.</p></div> </div> <a name='function.is-dir.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.chdir.php' class='function' rel='rdfs-seeAlso'>chdir()</a> - Muda o diret&amp;oacute;rio</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/class.dir.php' class='link'>dir</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.opendir.php' class='function' rel='rdfs-seeAlso'>opendir()</a> - Abre um manipulador de diret&amp;oacute;rio</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-file.php' class='function' rel='rdfs-seeAlso'>is_file()</a> - Informa se o arquivo &amp;eacute; um arquivo comum (n&amp;atilde;o &amp;eacute; diret&amp;oacute;rio)</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-link.php' class='function' rel='rdfs-seeAlso'>is_link()</a> - Diz se o arquivo &amp;eacute; um link simb&amp;oacute;lico (symbolic link)</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="is_callable" value="<div id='function.is-callable' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-callable.php'>is_callable</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>is_callable</span> &amp;mdash; <span class='dc-title'> Verifica se o conte&amp;uacute;do da vari&amp;aacute;vel pode ser chamado como fun&amp;ccedil;&amp;atilde;o </span></p> </div> <a name='function.is-callable.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>is_callable</b></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'>$var</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$syntax_only</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter reference'>&amp;amp;$callable_name</tt></span> ]] )</div> <p class='para rdfs-comment'> Verifica se o conte&amp;uacute;do da vari&amp;aacute;vel pode ser chamado como uma fun&amp;ccedil;&amp;atilde;o. Isto pode verificar se uma simples vari&amp;aacute;vel cont&amp;ecirc;m o nome de uma fun&amp;ccedil;&amp;atilde;o v&amp;aacute;lida, ou que um array cont&amp;ecirc;m uma propriedade de um objeto e nome de fun&amp;ccedil;&amp;atilde;o. </p> </div> <a name='function.is-callable.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Pode ser qualquer nome de uma fun&amp;ccedil;&amp;atilde;o armazenada na string, ou um objeto e o nome de um do m&amp;eacute;todo dentro do objeto, como isto: <div class='example-contents screen'>array($SomeObject, &amp;#039;MethodName&amp;#039;)</div> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>syntax_only</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se definido como <b><tt class='constant'>TRUE</tt></b> a fun&amp;ccedil;&amp;atilde;o somente verifica se <i><tt class='parameter'>var</tt></i> &amp;eacute; uma fun&amp;ccedil;&amp;atilde;o ou m&amp;eacute;todo. Ir&amp;aacute; somente rejeitar simples vari&amp;aacute;veis que n&amp;atilde;o s&amp;atilde;o strings, ou um array que n&amp;atilde;o tem uma estrutura v&amp;aacute;lida para ser usada como um callback. O valor v&amp;aacute;lido suposto teria somente 2 entradas, a primeira que &amp;eacute; um objeto ou uma string. e o segundo uma string. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>callable_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Recebe o &amp;quot;nome cham&amp;aacute;vel&amp;quot;. No exemplo acima seria &amp;quot;someClass::someMethod&amp;quot;. Note, contudo, que apesar da implica&amp;ccedil;&amp;atilde;o que someClass::SomeMethod() &amp;eacute; um cham&amp;aacute;vel m&amp;eacute;todo est&amp;aacute;tico, este n&amp;atilde;o &amp;eacute; o caso. </p> </dd> </dl> <p> </p> </div> <a name='function.is-callable.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; cham&amp;aacute;vel, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-callable.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>is_callable()</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;&amp;nbsp;How&amp;nbsp;to&amp;nbsp;check&amp;nbsp;a&amp;nbsp;variable&amp;nbsp;to&amp;nbsp;see&amp;nbsp;if&amp;nbsp;it&amp;nbsp;can&amp;nbsp;be&amp;nbsp;called<br />//&amp;nbsp;&amp;nbsp;as&amp;nbsp;a&amp;nbsp;function.<br /><br />//<br />//&amp;nbsp;&amp;nbsp;Simple&amp;nbsp;variable&amp;nbsp;containing&amp;nbsp;a&amp;nbsp;function<br />//<br /><br /></span><span style='color: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>someFunction</span><span style='color: #007700'>()<br />{<br />}<br /><br /></span><span style='color: #0000BB'>$functionVariable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'someFunction'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_callable</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$functionVariable</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>false</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$callable_name</span><span style='color: #007700'>));&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;bool(true)<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>$callable_name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;someFunction<br /><br />//<br />//&amp;nbsp;&amp;nbsp;Array&amp;nbsp;containing&amp;nbsp;a&amp;nbsp;method<br />//<br /><br /></span><span style='color: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>someClass&amp;nbsp;</span><span style='color: #007700'>{<br /><br />&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>someMethod</span><span style='color: #007700'>()<br />&amp;nbsp;&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;}<br /><br />}<br /><br /></span><span style='color: #0000BB'>$anObject&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>someClass</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>$methodVariable&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #0000BB'>$anObject</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'someMethod'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>is_callable</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$methodVariable</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$callable_name</span><span style='color: #007700'>));&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;&amp;nbsp;bool(true)<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>$callable_name</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;&amp;nbsp;someClass::someMethod<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.is-callable.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.function-exists.php' class='function' rel='rdfs-seeAlso'>function_exists()</a> - Retorna TRUE se a fun&amp;ccedil;&amp;atilde;o dada est&amp;aacute; definida</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.method-exists.php' class='function' rel='rdfs-seeAlso'>method_exists()</a> - Checa se o m&amp;eacute;todo da classe existe</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="is_bool" value="<div id='function.is-bool' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-bool.php'>is_bool</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_bool</span> &amp;mdash; <span class='dc-title'> Verifica se a vari&amp;aacute;vel &amp;eacute; um boleano </span></p> </div> <a name='function.is-bool.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>is_bool</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se uma dada vari&amp;aacute;vel &amp;eacute; <a href='http://www.php.net/manual/pt_BR/language.types.boolean.php' class='type boolean'>boolean</a>. </p> </div> <a name='function.is-bool.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The variable being evaluated. </p> </dd> </dl> <p> </p> </div> <a name='function.is-bool.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.boolean.php' class='type boolean'>boolean</a>, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-bool.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>is_bool()</b></b></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'>false</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'>0</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Verifica&amp;nbsp;se&amp;nbsp;$a&amp;nbsp;&amp;eacute;&amp;nbsp;boolean,&amp;nbsp;retorna&amp;nbsp;true<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>is_bool</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;vari&amp;aacute;vel&amp;nbsp;$a&amp;nbsp;&amp;eacute;&amp;nbsp;um&amp;nbsp;valor&amp;nbsp;booleano'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Verifica&amp;nbsp;se&amp;nbsp;$b&amp;nbsp;&amp;eacute;&amp;nbsp;boolean,&amp;nbsp;retorna&amp;nbsp;false<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>is_bool</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$b</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;vari&amp;aacute;vel&amp;nbsp;$b&amp;nbsp;&amp;eacute;&amp;nbsp;um&amp;nbsp;valor&amp;nbsp;booleano'</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.is-bool.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.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-array.php' class='function' rel='rdfs-seeAlso'>is_array()</a> - Verifica se a vari&amp;aacute;vel &amp;eacute; 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="is_array" value="<div id='function.is-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-array.php'>is_array</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>is_array</span> &amp;mdash; <span class='dc-title'>Verifica se a vari&amp;aacute;vel &amp;eacute; um array</span></p> </div> <a name='function.is-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'>bool</span> <span class='methodname'><b>is_array</b></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'>$var</tt></span> )</div> <p class='para rdfs-comment'> Verifica se uma dada vari&amp;aacute;vel &amp;eacute; um array. </p> </div> <a name='function.is-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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A vari&amp;aacute;vel a ser avaliada. </p> </dd> </dl> <p> </p> </div> <a name='function.is-array.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>var</tt></i> &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.array.php' class='type array'>array</a>, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.is-array.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Verificando se a vari&amp;aacute;vel &amp;eacute; um array</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$yes&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'this'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'is'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'an&amp;nbsp;array'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>is_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$yes</span><span style='color: #007700'>)&amp;nbsp;?&amp;nbsp;</span><span style='color: #DD0000'>'Array'&amp;nbsp;</span><span style='color: #007700'>:&amp;nbsp;</span><span style='color: #DD0000'>'not&amp;nbsp;an&amp;nbsp;Array'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$no&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'this&amp;nbsp;is&amp;nbsp;a&amp;nbsp;string'</span><span style='color: #007700'>;<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>is_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$no</span><span style='color: #007700'>)&amp;nbsp;?&amp;nbsp;</span><span style='color: #DD0000'>'Array'&amp;nbsp;</span><span style='color: #007700'>:&amp;nbsp;</span><span style='color: #DD0000'>'not&amp;nbsp;an&amp;nbsp;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>O exemplo acima ir&amp;aacute; imprimir:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Array not an Array </pre></div> </div> </div><p> </p> </div> <a name='function.is-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.is-float.php' class='function' rel='rdfs-seeAlso'>is_float()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo float</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-int.php' class='function' rel='rdfs-seeAlso'>is_int()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo inteiro</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-string.php' class='function' rel='rdfs-seeAlso'>is_string()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; do tipo string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-object.php' class='function' rel='rdfs-seeAlso'>is_object()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um objeto</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="is_a" value="<div id='function.is-a' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.is-a.php'>is_a</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>is_a</span> &amp;mdash; <span class='dc-title'>Verifica se o objeto &amp;eacute; de uma classe ou de sua classe pai</span></p> </div> <a name='function.is-a.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>is_a</b></span> ( <span class='methodparam'><span class='type'>object</span> <tt class='parameter'>$object</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$class_name</tt></span> )</div> <p class='para rdfs-comment'> Verifica se o dado <i><tt class='parameter'>object</tt></i> &amp;eacute; de uma classe ou de sua classe pai. </p> <blockquote><p><b class='note'>Nota</b>: A fun&amp;ccedil;&amp;atilde;o <b>is_a()</b> tornou-se obsoleta no PHP 5 pelo operador <a href='http://www.php.net/manual/pt_BR/language.operators.type.php' class='link'>instanceof</a>. <br /> </p></blockquote> </div> <a name='function.is-a.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'>object</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The tested object </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>class_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The class name </p> </dd> </dl> <p> </p> </div> <a name='function.is-a.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 object is of this class or has this class as one of its parents, <b><tt class='constant'>FALSE</tt></b> otherwise. </p> </div> <a name='function.is-a.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>is_a()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;define&amp;nbsp;a&amp;nbsp;class<br /></span><span style='color: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory<br /></span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;var&amp;nbsp;</span><span style='color: #0000BB'>$oink&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'moo'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;create&amp;nbsp;a&amp;nbsp;new&amp;nbsp;object<br /></span><span style='color: #0000BB'>$WF&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory</span><span style='color: #007700'>();<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>is_a</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$WF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'WidgetFactory'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'yes,&amp;nbsp;\$WF&amp;nbsp;is&amp;nbsp;still&amp;nbsp;a&amp;nbsp;WidgetFactory\n'</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 Using the <em class='emphasis'>instanceof</em> operator in PHP 5</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: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$WF&amp;nbsp;</span><span style='color: #007700'>instanceof&amp;nbsp;</span><span style='color: #0000BB'>WidgetFactory</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Yes,&amp;nbsp;$WF&amp;nbsp;is&amp;nbsp;a&amp;nbsp;WidgetFactory'</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.is-a.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.get-class.php' class='function' rel='rdfs-seeAlso'>get_class()</a> - Retorna o nome da classe de um objeto</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.get-parent-class.php' class='function' rel='rdfs-seeAlso'>get_parent_class()</a> - Recupera o nome da classe pai para o objeto ou classe</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-subclass-of.php' class='function' rel='rdfs-seeAlso'>is_subclass_of()</a> - Verifica se o objeto tem esta classe como uma de suas classes pai</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="iptcparse" value="<div id='function.iptcparse' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.iptcparse.php'>iptcparse</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>iptcparse</span> &amp;mdash; <span class='dc-title'>Analisa um bloco bin&amp;aacute;rio IPTC em tags simples.</span></p> </div> <a name='function.iptcparse.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>iptcparse</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$iptcblock</tt></span> )</div> <p class='para rdfs-comment'> Analisa um bloco <a href='http://www.iptc.org/' class='link external'>&amp;raquo; IPTC</a> em tags simples. </p> </div> <a name='function.iptcparse.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'>iptcblock</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Um bloco bin&amp;aacute;rio IPTC </p> </dd> </dl> <p> </p> </div> <a name='function.iptcparse.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um array usando a tagmarker como um &amp;iacute;ndice e o valor como o valor. Ela retorna <b><tt class='constant'>FALSE</tt></b> em erro ou se n&amp;atilde;o h&amp;aacute; informa&amp;ccedil;&amp;atilde;o IPTC encontrada. </p> </div> <a name='function.iptcparse.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.getimagesize.php' class='function' rel='rdfs-seeAlso'>getimagesize()</a> - Obt&amp;eacute;m o tamanho de uma imagem para um exemplo</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="iptcembed" value="<div id='function.iptcembed' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.iptcembed.php'>iptcembed</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>iptcembed</span> &amp;mdash; <span class='dc-title'>Embute dados bin&amp;aacute;rios IPTC em uma imagem JPEG</span></p> </div> <a name='function.iptcembed.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>iptcembed</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$iptcdata</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$jpeg_file_name</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$spool</tt></span> ] )</div> <p class='para rdfs-comment'> <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> </p> </div> <a name='function.iptcembed.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'>iptcdata</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>jpeg_file_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>spool</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <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="ip2long" value="<div id='function.ip2long' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ip2long.php'>ip2long</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ip2long</span> &amp;mdash; <span class='dc-title'>Converts a string containing an (IPv4) Internet Protocol dotted address into a proper address</span></p> </div> <a name='function.ip2long.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>ip2long</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$ip_address</tt></span> )</div> <p class='para rdfs-comment'> The function <b>ip2long()</b> generates an IPv4 Internet network address from its Internet standard format (dotted string) representation. </p> <p class='para'> <b>ip2long()</b> will also work with non-complete IP addresses. Read <a href='http://publibn.boulder.ibm.com/doc_link/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm' class='link external'>&amp;raquo; http://publibn.boulder.ibm.com/doc_link/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm</a> for more info. </p> </div> <a name='function.ip2long.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'>ip_address</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A standard format address. </p> </dd> </dl> <p> </p> </div> <a name='function.ip2long.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the IPv4 address or <b><tt class='constant'>FALSE</tt></b> if <i><tt class='parameter'>ip_address</tt></i> is invalid. </p> </div> <a name='function.ip2long.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.0.0</td> <td align='left'> Prior to this version, <b>ip2long()</b> returned -1 on failure. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.ip2long.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>ip2long()</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 />$ip&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>gethostbyname</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'www.example.com'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$out&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'The&amp;nbsp;following&amp;nbsp;URLs&amp;nbsp;are&amp;nbsp;equivalent:&amp;lt;br&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$out&amp;nbsp;</span><span style='color: #007700'>.=&amp;nbsp;</span><span style='color: #DD0000'>'http://www.example.com/,&amp;nbsp;http://'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>$ip&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #DD0000'>'/,&amp;nbsp;and&amp;nbsp;http://'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>sprintf</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'%u'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>ip2long</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ip</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 />echo&amp;nbsp;</span><span style='color: #0000BB'>$out</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 Displaying an IP address</b></p> <div class='example-contents para'><p> This second example shows how to print a converted address with the <a href='http://www.php.net/manual/pt_BR/function.printf.php' class='function'>printf()</a> function in both PHP 4 and PHP 5: </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$ip&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>gethostbyname</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'www.example.com'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$long&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ip2long</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ip</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$long&amp;nbsp;</span><span style='color: #007700'>==&amp;nbsp;-</span><span style='color: #0000BB'>1&amp;nbsp;</span><span style='color: #007700'>||&amp;nbsp;</span><span style='color: #0000BB'>$long&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;echo&amp;nbsp;</span><span style='color: #DD0000'>'Invalid&amp;nbsp;IP,&amp;nbsp;please&amp;nbsp;try&amp;nbsp;again'</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: #0000BB'>$ip&amp;nbsp;&amp;nbsp;&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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;192.0.34.166<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>$long&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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;-1073732954<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'>'%u\n'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>ip2long</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$ip</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;3221234342<br /></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 IP validation</b></p> <div class='example-contents para'><p> <b>ip2long()</b> should not be used as the sole form of IP validation. Combine it with <a href='http://www.php.net/manual/pt_BR/function.long2ip.php' class='function'>long2ip()</a>: </p></div> <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;make&amp;nbsp;sure&amp;nbsp;IPs&amp;nbsp;are&amp;nbsp;valid.&amp;nbsp;also&amp;nbsp;converts&amp;nbsp;a&amp;nbsp;non-complete&amp;nbsp;IP&amp;nbsp;into<br />//&amp;nbsp;a&amp;nbsp;proper&amp;nbsp;dotted&amp;nbsp;quad&amp;nbsp;as&amp;nbsp;explained&amp;nbsp;below.<br /></span><span style='color: #0000BB'>$ip&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>long2ip</span><span style='color: #007700'>(</span><span style='color: #0000BB'>ip2long</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'127.0.0.1'</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;'127.0.0.1'<br /></span><span style='color: #0000BB'>$ip&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>long2ip</span><span style='color: #007700'>(</span><span style='color: #0000BB'>ip2long</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'10.0.0'</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;'10.0.0.0'<br /></span><span style='color: #0000BB'>$ip&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>long2ip</span><span style='color: #007700'>(</span><span style='color: #0000BB'>ip2long</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'10.0.256'</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;'10.0.1.0'<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.ip2long.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Because PHP&amp;#039;s integer type is signed, and many IP addresses will result in negative integers, you need to use the &amp;quot;%u&amp;quot; formatter of <a href='http://www.php.net/manual/pt_BR/function.sprintf.php' class='function'>sprintf()</a> or <a href='http://www.php.net/manual/pt_BR/function.printf.php' class='function'>printf()</a> to get the string representation of the unsigned IP address. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <b>ip2long()</b> will return <b><tt class='constant'>FALSE</tt></b> for the IP <i>255.255.255.255</i> in PHP 5 &amp;lt;= 5.0.2. It was fixed in PHP 5.0.3 where it returns <i>-1</i> (same as PHP 4). <br /> </p></blockquote> </div> <a name='function.ip2long.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.long2ip.php' class='function' rel='rdfs-seeAlso'>long2ip()</a> - Converts an (IPv4) Internet network address into a string in Internet standard dotted format</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.sprintf.php' class='function' rel='rdfs-seeAlso'>sprintf()</a> - Retorna a string formatada</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="in_array" value="<div id='function.in-array' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.in-array.php'>in_array</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>in_array</span> &amp;mdash; <span class='dc-title'>Checa se um valor existe em um array</span></p> </div> <a name='function.in-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'>bool</span> <span class='methodname'><b>in_array</b></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'>$needle</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$haystack</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$strict</tt></span> ] )</div> <p class='para rdfs-comment'> Procura em <i><tt class='parameter'>haystack</tt></i> pelo valor <i><tt class='parameter'>needle</tt></i> . </p> </div> <a name='function.in-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'>needle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O valor procurado. </p> <blockquote><p><b class='note'>Nota</b>: Se <i><tt class='parameter'>needle</tt></i> for uma string, a compara&amp;ccedil;&amp;atilde;o &amp;eacute; feita diferenciando caracteres mai&amp;uacute;sculos e min&amp;uacute;sculos. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>haystack</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O array. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>strict</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se o terceiro par&amp;acirc;metro <i><tt class='parameter'>strict</tt></i> for <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o <b>in_array()</b> tamb&amp;eacute;m ir&amp;aacute; checar os <a href='http://www.php.net/manual/pt_BR/language.types.php' class='link'>tipos</a> de <i><tt class='parameter'>needle</tt></i> em <i><tt class='parameter'>haystack</tt></i> . </p> </dd> </dl> <p> </p> </div> <a name='function.in-array.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se <i><tt class='parameter'>needle</tt></i> &amp;eacute; encontrado no array, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.in-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.2.0</td> <td align='left'> <i><tt class='parameter'>needle</tt></i> pode agora ser um array. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.in-array.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>in_array()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$os&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'Mac'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'NT'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Irix'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Linux'</span><span style='color: #007700'>);&amp;nbsp;<br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Irix'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$os</span><span style='color: #007700'>))&amp;nbsp;{&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Tem&amp;nbsp;Irix'</span><span style='color: #007700'>;<br />}<br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'mac'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$os</span><span style='color: #007700'>))&amp;nbsp;{&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Tem&amp;nbsp;mac'</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> A segunda condicional falha pois <b>in_array()</b> diferencia letras min&amp;uacute;sculas e mai&amp;uacute;sculas. Ent&amp;atilde;o, a sa&amp;iacute;da seria: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> Tem Irix </pre></div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 <b>in_array()</b> com checagem de tipos</b></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;array(</span><span style='color: #DD0000'>'1.10'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12.4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1.13</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'12.4'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$a</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;echo&amp;nbsp;</span><span style='color: #DD0000'>''12.4'&amp;nbsp;encontrado&amp;nbsp;com&amp;nbsp;checagem&amp;nbsp;de&amp;nbsp;tipo\n'</span><span style='color: #007700'>;<br />}<br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1.13</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$a</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;echo&amp;nbsp;</span><span style='color: #DD0000'>'1.13&amp;nbsp;encontrado&amp;nbsp;com&amp;nbsp;checagem&amp;nbsp;de&amp;nbsp;tipo\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> 1.13 encontrado com checagem de tipo </pre></div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #3 Exemplo de <b>in_array()</b> passando um array para <i><tt class='parameter'>needle</tt></i> </b></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;array(array(</span><span style='color: #DD0000'>'p'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'h'</span><span style='color: #007700'>),&amp;nbsp;array(</span><span style='color: #DD0000'>'p'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'r'</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #DD0000'>'o'</span><span style='color: #007700'>);<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(array(</span><span style='color: #DD0000'>'p'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'h'</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>''ph'&amp;nbsp;foi&amp;nbsp;encontrado\n'</span><span style='color: #007700'>;<br />}<br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(array(</span><span style='color: #DD0000'>'f'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'i'</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>))&amp;nbsp;{&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>''fi'&amp;nbsp;foi&amp;nbsp;encontrado\n'</span><span style='color: #007700'>;<br />}<br />if&amp;nbsp;(</span><span style='color: #0000BB'>in_array</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'o'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>''o'&amp;nbsp;foi&amp;nbsp;encontrado\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> &amp;#039;ph&amp;#039; foi encontrado &amp;#039;o&amp;#039; foi encontrado </pre></div> </div> </div><p> </p> </div> <a name='function.in-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.array-search.php' class='function' rel='rdfs-seeAlso'>array_search()</a> - Procura por um valor em um array e retorna sua chave correspondente caso seja encontrado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.isset.php' class='function' rel='rdfs-seeAlso'>isset()</a> - Informa se a vari&amp;aacute;vel foi iniciada</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.array-key-exists.php' class='function' rel='rdfs-seeAlso'>array_key_exists()</a> - Checa se uma chave ou &amp;iacute;ndice existe em 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="InvalidArgumentException" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.invalidargumentexception.php'>The InvalidArgumentException class</a></h1> <div class='partintro'> <div id='invalidargumentexception.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> Exception thrown if an argument does not match with the expected value </p> </div> <div id='invalidargumentexception.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>InvalidArgumentException</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>InvalidArgumentException</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.logicexception.php' class='classname'>LogicException</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Inherited methods */</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getmessage.php' class='function'>Exception::getMessage</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>int</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getcode.php' class='function'>Exception::getCode</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getfile.php' class='function'>Exception::getFile</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.getline.php' class='function'>Exception::getLine</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>array</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.gettrace.php' class='function'>Exception::getTrace</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.gettraceasstring.php' class='function'>Exception::getTraceAsString</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.tostring.php' class='function'>Exception::__toString</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>final</span> <span class='modifier'>private</span> <span class='type'>string</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/exception.clone.php' class='function'>Exception::__clone</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </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="intval" value="<div id='function.intval' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.intval.php'>intval</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>intval</span> &amp;mdash; <span class='dc-title'>Retorna o valor inteiro da vari&amp;aacute;vel</span></p> </div> <a name='function.intval.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>intval</b></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'>$var</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$base</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna o valor <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> de <i><tt class='parameter'>var</tt></i> , usando a <i><tt class='parameter'>base</tt></i> especificada para a convers&amp;atilde;o (o padr&amp;atilde;o &amp;eacute; a base 10). </p> </div> <a name='function.intval.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'>var</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The scalar value being converted to an integer </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>base</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The base for the conversion (default is base 10) </p> </dd> </dl> <p> </p> </div> <a name='function.intval.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The integer value of <i><tt class='parameter'>var</tt></i> on success, or 0 on failure. Empty arrays and objects return 0, non-empty arrays and objects return 1. </p> <p class='para'> O valor m&amp;aacute;ximo depende do sistema. Sistemas 32 bit tem o m&amp;aacute;ximo de inteiro com sinal entre -2147483648 e 2147483647. Ent&amp;atilde;o por exemplo no sistema, <i>intval(&amp;#039;1000000000000&amp;#039;)</i> ir&amp;aacute; retornar 2147483647. O valor m&amp;aacute;ximo do inteiro com sinal para sistemas 64 bit &amp;eacute; 9223372036854775807. </p> <p class='para'> Strings retorna 0 embora isto dependa do caractere mais a esquerda da string. A regra comum aplicada de <a href='http://www.php.net/manual/pt_BR/language.types.integer.php#language.types.integer.casting' class='link'>convers&amp;atilde;o de inteiro</a>. </p> </div> <a name='function.intval.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplos da <b>intval()</b></b></p> <div class='example-contents para'><p> Os exemplos seguintes s&amp;atilde;o baseados em sistema 32 bit. </p></div> <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: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>42</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;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;42<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>4.2</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;</span><span style='color: #FF8000'>//&amp;nbsp;4<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'42'</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;</span><span style='color: #FF8000'>//&amp;nbsp;42<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'+42'</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: #FF8000'>//&amp;nbsp;42<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'-42'</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: #FF8000'>//&amp;nbsp;-42<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>042</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;</span><span style='color: #FF8000'>//&amp;nbsp;34<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'042'</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: #FF8000'>//&amp;nbsp;42<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1e10</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;</span><span style='color: #FF8000'>//&amp;nbsp;1410065408<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'1e10'</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: #FF8000'>//&amp;nbsp;1<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>0x1A</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;</span><span style='color: #FF8000'>//&amp;nbsp;26<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>42000000</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: #FF8000'>//&amp;nbsp;42000000<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>420000000000000000000</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;0<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'420000000000000000000'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;2147483647<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #0000BB'>42</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>8</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: #FF8000'>//&amp;nbsp;42<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>intval</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'42'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>8</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;34<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.intval.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: O par&amp;acirc;metro <i><tt class='parameter'>base</tt></i> n&amp;atilde;o tem efeito a menos que o par&amp;acirc;metro <i><tt class='parameter'>var</tt></i> seja string. <br /> </p></blockquote> </div> <a name='function.intval.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.floatval.php' class='function' rel='rdfs-seeAlso'>floatval()</a> - Retorna o valor float da vari&amp;aacute;vel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.strval.php' class='function' rel='rdfs-seeAlso'>strval()</a> - Retorna o valor string de uma vari&amp;aacute;vel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.settype.php' class='function' rel='rdfs-seeAlso'>settype()</a> - Atribui um tipo para a vari&amp;aacute;vel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.is-numeric.php' class='function' rel='rdfs-seeAlso'>is_numeric()</a> - Informa se a vari&amp;aacute;vel &amp;eacute; um n&amp;uacute;mero ou uma string num&amp;eacute;rica</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/language.types.type-juggling.php' class='link'>Manipula&amp;ccedil;&amp;atilde;o de tipos</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/ref.bc.php' class='link'>Fun&amp;ccedil;&amp;otilde;es matem&amp;aacute;ticas de precis&amp;atilde;o arbitr&amp;aacute;ria BCMath</a></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="interface_exists" value="<div id='function.interface-exists' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.interface-exists.php'>interface_exists</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.0.2)</p><p class='refpurpose'><span class='refname'>interface_exists</span> &amp;mdash; <span class='dc-title'>Checa se a interface foi definida</span></p> </div> <a name='function.interface-exists.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>interface_exists</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$interface_name</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$autoload</tt></span> ] )</div> <p class='para rdfs-comment'> Verifica se uma interface foi definida. </p> </div> <a name='function.interface-exists.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'>interface_name</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da interface. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>autoload</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se deve chamar <a href='http://www.php.net/manual/pt_BR/language.oop5.autoload.php' class='link'>__autoload</a> ou n&amp;atilde;o por padr&amp;atilde;o </p> </dd> </dl> <p> </p> </div> <a name='function.interface-exists.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Essa fun&amp;ccedil;&amp;atilde;o retorna <b><tt class='constant'>TRUE</tt></b> se a interface de nome <i><tt class='parameter'>interface_name</tt></i> j&amp;aacute; foi definida, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.interface-exists.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de uso de <b>interface_exists()</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;Check&amp;nbsp;the&amp;nbsp;interface&amp;nbsp;exists&amp;nbsp;before&amp;nbsp;trying&amp;nbsp;to&amp;nbsp;use&amp;nbsp;it<br /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>interface_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'MyInterface'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;class&amp;nbsp;</span><span style='color: #0000BB'>MyClass&amp;nbsp;</span><span style='color: #007700'>implements&amp;nbsp;</span><span style='color: #0000BB'>MyInterface<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</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'>//&amp;nbsp;Methods<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>}<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.interface-exists.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.class-exists.php' class='function' rel='rdfs-seeAlso'>class_exists()</a> - Checa se uma classe foi definida</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="ini_set" value="<div id='function.ini-set' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ini-set.php'>ini_set</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ini_set</span> &amp;mdash; <span class='dc-title'>Define o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.ini-set.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>ini_set</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$varname</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$newvalue</tt></span> )</div> <p class='para rdfs-comment'> Define um novo valor para a op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o indicada. A op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o ir&amp;aacute; manter o novo valor durante a execu&amp;ccedil;&amp;atilde;o do script e ser&amp;aacute; restaurado ao final da execu&amp;ccedil;&amp;atilde;o do script. </p> </div> <a name='function.ini-set.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'>varname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> <p class='para'> Nem todas as op&amp;ccedil;&amp;otilde;es dispon&amp;iacute;veis podem ser modificadas usando a fun&amp;ccedil;&amp;atilde;o <b>ini_set()</b>. H&amp;aacute; uma lista de todas as op&amp;ccedil;&amp;otilde;es dispon&amp;iacute;veis no PHP <a href='http://www.php.net/manual/pt_BR/ini.list.php' class='link'>ap&amp;ecirc;ndice</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>newvalue</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O novo valor para a op&amp;ccedil;&amp;atilde;o. </p> </dd> </dl> <p> </p> </div> <a name='function.ini-set.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o valor anterior em sucesso, <b><tt class='constant'>FALSE</tt></b> em falha. </p> </div> <a name='function.ini-set.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.get-cfg-var.php' class='function' rel='rdfs-seeAlso'>get_cfg_var()</a> - Obt&amp;eacute;m o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o do PHP</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ini-get.php' class='function' rel='rdfs-seeAlso'>ini_get()</a> - Obt&amp;eacute;m o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ini-get-all.php' class='function' rel='rdfs-seeAlso'>ini_get_all()</a> - Obt&amp;eacute;m todas as op&amp;ccedil;&amp;otilde;es de configura&amp;ccedil;&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ini-restore.php' class='function' rel='rdfs-seeAlso'>ini_restore()</a> - Restaura o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o</li> <li class='member'> <a href='http://www.php.net/manual/pt_BR/configuration.changes.php' class='link'>Como modificar a configura&amp;ccedil;&amp;atilde;o</a> </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="ini_restore" value="<div id='function.ini-restore' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ini-restore.php'>ini_restore</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ini_restore</span> &amp;mdash; <span class='dc-title'>Restaura o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.ini-restore.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>ini_restore</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$varname</tt></span> )</div> <p class='para rdfs-comment'> Restaura o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o para o seu valor original. </p> </div> <a name='function.ini-restore.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'>varname</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome da op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o. </p> </dd> </dl> <p> </p> </div> <a name='function.ini-restore.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.ini-restore.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.ini-get.php' class='function' rel='rdfs-seeAlso'>ini_get()</a> - Obt&amp;eacute;m o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ini-get-all.php' class='function' rel='rdfs-seeAlso'>ini_get_all()</a> - Obt&amp;eacute;m todas as op&amp;ccedil;&amp;otilde;es de configura&amp;ccedil;&amp;atilde;o</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.ini-set.php' class='function' rel='rdfs-seeAlso'>ini_set()</a> - Define o valor de uma op&amp;ccedil;&amp;atilde;o de configura&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="ini_get_all" value="<div id='function.ini-get-all' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ini-get-all.php'>ini_get_all</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.2.0, PHP 5)</p><p class='refpurpose'><span class='refname'>ini_get_all</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m todas as op&amp;ccedil;&amp;otilde;es de configura&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.ini-get-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>ini_get_all</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$extension</tt></span> ] )</div> <p class='para rdfs-comment'> Retorna todas as op&amp;ccedil;&amp;otilde;es de configura&amp;ccedil;&amp;atilde;o como uma matriz associativa. Se o par&amp;acirc;metro opcional <i><tt class='parameter'>extension</tt></i> estiver definido, apenas as op&amp;ccedil;&amp;otilde;es especificas para esta extens&amp;atilde;o ser&amp;atilde;o retornadas. </p> <p class='para'> A matriz retornada usa o nome da diretiva como chave da matriz sendo os os elementos <i>global_value</i> (definidos no <var class='filename'>php.ini</var>), <i>local_value</i> (talvez definidos com <a href='http://www.php.net/manual/pt_BR/function.ini-set.php' class='function'>ini_set()</a> ou <var class='filename'>.htaccess</var>), e <i>access</i> (o n&amp;iacute;vel de acesso). Veja a se&amp;ccedil;&amp;atilde;o do manual sobre <a href='http://www.php.net/manual/pt_BR/configuration.changes.php' class='link'>mudan&amp;ccedil;as de configura&amp;ccedil;&amp;atilde;o</a> para informa&amp;ccedil;&amp;otilde;es sobre o que s&amp;atilde;o os n&amp;iacute;veis. </p> <blockquote><p><b class='note'>Nota</b>: &amp;Eacute; poss&amp;iacute;vel para uma diretiva ter m&amp;uacute;ltiplos n&amp;iacute;veis de acesso, por isso <i>access</i> mostra os valores apropriados como um valor bitmask. <br /> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>ini_get_all()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$inis&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>ini_get_all</span><span style='color: #007700'>();<br /><br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$inis</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> Parte da sa&amp;iacute;da se parece com: </p></div> <div class='example-contents screen'> <div class='cdata'><pre> Array ( [allow_call_time_pass_reference] =&amp;gt; Array ( [global_value] =&amp;gt; 1 [local_value] =&amp;gt; 1 [access] =&amp;gt; 6 ) [allow_url_fopen] =&amp;gt; Array ( [global_value] =&amp;gt; 1 [local_value] =&amp;gt; 1 [access] =&amp;gt; 7 ) ... ) </pre></div> </div> </div><p> </p> <p class='para'> Veja tamb&amp;eacute;m: <a href='http://www.php.net/manual/pt_BR/function.ini-get.php' class='function'>ini_get()</a>, <a href='http://www.php.net/manual/pt_BR/function.ini-restore.php' class='function'>ini_restore()</a>, <a href='http://www.php.net/manual/pt_BR/function.ini-set.php' class='function'>ini_set()</a>, <a href='http://www.php.net/manual/pt_BR/function.get-loaded-extensions.php' class='function'>get_loaded_extensions()</a> e <a href='http://www.php.net/manual/pt_BR/function.phpinfo.php' class='function'>phpinfo()</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="ini_get" value="<div id='function.ini-get' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ini-get.php'>ini_get</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ini_get</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o valor de uma op&amp;ccedil;&amp;atilde;o de configura&amp;ccedil;&amp;atilde;o</span></p> </div> <a name='function.ini-get.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>ini_get</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$varname</tt></span> )</div> <p class='para rdfs-comment'> Retorna o valor da op&amp;ccedil;&amp;atilde;o em caso de sucesso. Em caso de falha, como tentar obter um valor que n&amp;atilde;o exista, ir&amp;aacute; retornar uma string vazia. </p> <blockquote><p><b class='note'>Nota</b>: <b>Quando obtendo valores booleanos</b><br /> Um valor booleano <i>off</i> ser&amp;aacute; retornado como uma string vazia enquanto um valor booleano <i>on</i> ser&amp;aacute; retornado como &amp;quot;1&amp;quot;. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <b>Quando obtendo valores de tamanho de mem&amp;oacute;ria</b><br /> V&amp;aacute;rios valores de defini&amp;ccedil;&amp;atilde;o de tamanho de mem&amp;oacute;ria, como <i>upload_max_filesize</i> s&amp;atilde;o guardados no arquivo <var class='filename'>php.ini</var> em uma anota&amp;ccedil;&amp;atilde;o curta. <b>ini_get()</b> ir&amp;aacute; retornar exatamente a string guardada no arquivo <var class='filename'>php.ini</var>, <em class='emphasis'>N&amp;Atilde;O</em> o seu valor inteiro equivalente. Tentar fun&amp;ccedil;&amp;otilde;es matem&amp;aacute;ticas comuns com estes valores n&amp;atilde;o trar&amp;aacute; o resultado esperado. </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 /></span><span style='color: #FF8000'>/*<br />Seu&amp;nbsp;php.ini&amp;nbsp;cont&amp;eacute;m&amp;nbsp;as&amp;nbsp;seguintes&amp;nbsp;defini&amp;ccedil;&amp;otilde;es:<br /><br />display_errors&amp;nbsp;=&amp;nbsp;On<br />register_globals&amp;nbsp;=&amp;nbsp;Off<br />post_max_size&amp;nbsp;=&amp;nbsp;8M<br />*/<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #DD0000'>'display_errors&amp;nbsp;=&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>ini_get</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'display_errors'</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'register_globals&amp;nbsp;=&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>ini_get</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'register_globals'</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'post_max_size&amp;nbsp;=&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>ini_get</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'post_max_size'</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #DD0000'>'post_max_size+1&amp;nbsp;=&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;(</span><span style='color: #0000BB'>ini_get</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'post_max_size'</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'>'\n'</span><span style='color: #007700'>;&amp;nbsp;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <p class='para'> Este script ir&amp;aacute; produzir: </p> <div class='example-contents screen'> <div class='cdata'><pre> display_errors = 1 register_globals = 0 post_max_size = 8M post_max_size+1 = 9 */ ?&amp;gt; </pre></div> </div> </div><p> <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.get-cfg-var.php' class='function'>get_cfg_var()</a>, <a href='http://www.php.net/manual/pt_BR/function.ini-get-all.php' class='function'>ini_get_all()</a>, <a href='http://www.php.net/manual/pt_BR/function.ini-restore.php' class='function'>ini_restore()</a> e <a href='http://www.php.net/manual/pt_BR/function.ini-set.php' class='function'>ini_set()</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="ini_alter" value="<div id='function.ini-alter' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ini-alter.php'>ini_alter</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ini_alter</span> &amp;mdash; <span class='dc-title'>Sin&amp;ocirc;nimo de <a href='http://www.php.net/manual/pt_BR/function.ini-set.php' class='function'>ini_set()</a></span></p> </div> <a name='function.ini-alter.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; um apelido para: <a href='http://www.php.net/manual/pt_BR/function.ini-set.php' class='function'>ini_set()</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="InfiniteIterator::__construct" value="<div id='infiniteiterator.construct' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/infiniteiterator.construct.php'>InfiniteIterator::__construct</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>InfiniteIterator::__construct</span> &amp;mdash; <span class='dc-title'>Constructs an InfiniteIterator</span></p> </div> <a name='infiniteiterator.construct.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='methodname'><b>InfiniteIterator::__construct</b></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='type Iterator'>Iterator</a></span> <tt class='parameter'>$iterator</tt></span> )</div> <p class='para rdfs-comment'> Constructs an <a href='http://www.php.net/manual/pt_BR/class.infiniteiterator.php' class='classname'>InfiniteIterator</a> from an <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='classname'>Iterator</a>. </p> </div> <a name='infiniteiterator.construct.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'>iterator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The iterator to infinitely iterate over. </p> </dd> </dl> <p> </p> </div> <a name='infiniteiterator.construct.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='infiniteiterator.construct.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> Throws an <b><tt class='constant'>E_RECOVERABLE_ERROR</tt></b> if the <i><tt class='parameter'>iterator</tt></i> parameter is not an <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='classname'>Iterator</a>. </p> </div> <a name='infiniteiterator.construct.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>InfiniteIterator::__construct()</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 />$arrayit&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>ArrayIterator</span><span style='color: #007700'>(array(</span><span style='color: #DD0000'>'cat'</span><span style='color: #007700'>,</span><span style='color: #DD0000'>'dog'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>$infinite&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>InfiniteIterator</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$arrayit</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$limit&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>LimitIterator</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$infinite</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'>7</span><span style='color: #007700'>);<br />foreach(</span><span style='color: #0000BB'>$limit&amp;nbsp;</span><span style='color: #007700'>as&amp;nbsp;</span><span style='color: #0000BB'>$value</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'</span><span style='color: #0000BB'>$value</span><span style='color: #DD0000'>\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> cat dog cat dog cat dog cat </pre></div> </div> </div><p> </p> </div> <a name='infiniteiterator.construct.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/infiniteiterator.next.php' class='function' rel='rdfs-seeAlso'>InfiniteIterator::next</a> - Moves the inner Iterator forward or rewinds it</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="InfiniteIterator::next" value="<div id='infiniteiterator.next' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/infiniteiterator.next.php'>InfiniteIterator::next</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>InfiniteIterator::next</span> &amp;mdash; <span class='dc-title'>Moves the inner Iterator forward or rewinds it</span></p> </div> <a name='infiniteiterator.next.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'><span class='type void'>void</span></span> <span class='methodname'><b>InfiniteIterator::next</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Moves the inner <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='classname'>Iterator</a> forward to its next element if there is one, otherwise rewinds the inner <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='classname'>Iterator</a> back to the beginning. </p> <blockquote><p><b class='note'>Nota</b>: Even an <a href='http://www.php.net/manual/pt_BR/class.infiniteiterator.php' class='classname'>InfiniteIterator</a> stops if its inner <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='classname'>Iterator</a> is empty. <br /> </p></blockquote> </div> <a name='infiniteiterator.next.parameters'></a><div class='refsect1 parameters'> <h3 class='title'>Par&amp;acirc;metros</h3> <p class='para'>Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o cont&amp;eacute;m par&amp;acirc;metros.</p> </div> <a name='infiniteiterator.next.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='infiniteiterator.next.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'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/infiniteiterator.construct.php' class='function' rel='rdfs-seeAlso'>InfiniteIterator::__construct</a> - Constructs an InfiniteIterator</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="InfiniteIterator" value="<div> <h1 class='title'><a class='info-url' href='http://www.php.net/manual/pt_br/class.infiniteiterator.php'>The InfiniteIterator class</a></h1> <div class='partintro'> <div id='infiniteiterator.intro' class='section'> <h2 class='title'>Introdu&amp;ccedil;&amp;atilde;o</h2> <p class='para'> The <b class='classname'>InfiniteIterator</b> allows one to infinitely iterate over an iterator without having to manually rewind the iterator upon reaching its end. </p> </div> <div id='infiniteiterator.synopsis' class='section'> <h2 class='title'>Sinopse da classe</h2> <div class='classsynopsis'> <div class='ooclass'><b class='classname'>InfiniteIterator</b></div> <div class='classsynopsisinfo'> <span class='ooclass'> <b class='classname'>InfiniteIterator</b> </span> <span class='ooclass'> <span class='modifier'>extends</span> <a href='http://www.php.net/manual/pt_BR/class.iteratoriterator.php' class='classname'>IteratorIterator</a> </span> <span class='oointerface'>implements <a href='http://www.php.net/manual/pt_BR/class.outeriterator.php' class='interfacename'>OuterIterator</a> </span> <span class='oointerface'>, <a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='interfacename'>Traversable</a> </span> <span class='oointerface'>, <a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='interfacename'>Iterator</a> </span> {</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Methods */</div> <div class='methodsynopsis dc-description'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/infiniteiterator.construct.php' class='function'>__construct</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.iterator.php' class='type Iterator'>Iterator</a></span> <tt class='parameter'>$iterator</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/infiniteiterator.next.php' class='function'>next</a></span> ( <span class='methodparam'>void</span> )</div> <div class='classsynopsisinfo classsynopsisinfo_comment'>/* Inherited methods */</div> <div class='methodsynopsis dc-description'> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.construct.php' class='function'>IteratorIterator::__construct</a></span> ( <span class='methodparam'><span class='type'><a href='http://www.php.net/manual/pt_BR/class.traversable.php' class='type Traversable'>Traversable</a></span> <tt class='parameter'>$iterator</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.current.php' class='function'>IteratorIterator::current</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.getinneriterator.php' class='function'>IteratorIterator::getInnerIterator</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.key.php' class='function'>IteratorIterator::key</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.next.php' class='function'>IteratorIterator::next</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>void</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.rewind.php' class='function'>IteratorIterator::rewind</a></span> ( <span class='methodparam'>void</span> )</div> <div class='methodsynopsis dc-description'> <span class='modifier'>public</span> <span class='type'>bool</span> <span class='methodname'><a href='http://www.php.net/manual/pt_BR/iteratoriterator.valid.php' class='function'>IteratorIterator::valid</a></span> ( <span class='methodparam'>void</span> )</div> }</div> </div> </div> <h2>&amp;Iacute;ndice</h2><ul class='chunklist chunklist_reference'><li><a href='http://www.php.net/manual/pt_BR/infiniteiterator.construct.php'>InfiniteIterator::__construct</a> &amp;mdash; Constructs an InfiniteIterator</li><li><a href='http://www.php.net/manual/pt_BR/infiniteiterator.next.php'>InfiniteIterator::next</a> &amp;mdash; Moves the inner Iterator forward or rewinds it</li></ul> </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="import_request_variables" value="<div id='function.import-request-variables' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.import-request-variables.php'>import_request_variables</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.1.0, PHP 5)</p><p class='refpurpose'><span class='refname'>import_request_variables</span> &amp;mdash; <span class='dc-title'>Importa vari&amp;aacute;veis GET/POST/Cookie para o escopo global</span></p> </div> <a name='function.import-request-variables.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>import_request_variables</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$types</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$prefix</tt></span> ] )</div> <p class='para rdfs-comment'> Importa vari&amp;aacute;veis GET/POST/Cookie para o escopo global. &amp;Eacute; &amp;uacute;til se voc&amp;ecirc; desabilita <a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.register-globals' class='link'>register_globals</a>, mas voc&amp;ecirc; poderia ver algunas vari&amp;aacute;veis no escopo global. </p> <p class='para'> Se voc&amp;ecirc; est&amp;aacute; interessado em importar outras vari&amp;aacute;veis para o escopo global, como uma a SERVER, utilize a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.extract.php' class='function'>extract()</a>. </p> </div> <a name='function.import-request-variables.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'>types</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Usando o par&amp;acirc;metro <i><tt class='parameter'>types</tt></i> , voc&amp;ecirc; pode especificar que vari&amp;aacute;veis ser&amp;atilde;o importadas. Voc&amp;ecirc; pode usar os caracteres &amp;#039;G&amp;#039;, &amp;#039;P&amp;#039; e &amp;#039;C&amp;#039; respectivamente para GET, POST e Cookie. Estes caracteres n&amp;atilde;o s&amp;atilde;o case sensitive, ent&amp;atilde;o voc&amp;ecirc; pode tamb&amp;eacute;m usar qualquer combina&amp;ccedil;&amp;atilde;o de &amp;#039;g&amp;#039;, &amp;#039;p&amp;#039; e &amp;#039;c&amp;#039;. POST inclue informa&amp;ccedil;&amp;atilde;o sobre arquivos enviados. </p> <blockquote><p><b class='note'>Nota</b>: Note que a ordem das letras, como usando &amp;quot;gp&amp;quot;, a vari&amp;aacute;vel POST ir&amp;aacute; sobreescrever vari&amp;aacute;veis GET com mesmo nome. Algumas outras letras como GPC s&amp;atilde;o descartadas. <br /> </p></blockquote> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>prefix</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Prefixo no nome de vari&amp;aacute;veis, prepara todos os nomes de vari&amp;aacute;veis antes de ser importadas para o escopo global. Ent&amp;atilde;o se voc&amp;ecirc; tem um valor GET nomeado &amp;quot;userid&amp;quot;, e fornece &amp;quot;pref_&amp;quot; como prefixo, ent&amp;atilde;o voc&amp;ecirc; ter&amp;aacute; uma vari&amp;aacute;vel global chamada <var class='varname'>$pref_userid</var>. </p> <blockquote><p><b class='note'>Nota</b>: Embora o par&amp;acirc;metro <i><tt class='parameter'>prefix</tt></i> seja opcional, voc&amp;ecirc; ir&amp;aacute; receber <a href='http://www.php.net/manual/pt_BR/errorfunc.constants.php#errorfunc.constants.errorlevels.e-notice' class='link'>E_NOTICE</a> se voc&amp;ecirc; especificar n&amp;atilde;o especificar prefixo, ou se o prefixo for uma string vazia. Isto &amp;eacute; poss&amp;iacute;vel perigo. Notices n&amp;atilde;o s&amp;atilde;o mostrados usando o padr&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/errorfunc.configuration.php#ini.error-reporting' class='link'>error reporting</a> level. <br /> </p></blockquote> </dd> </dl> <p> </p> </div> <a name='function.import-request-variables.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.import-request-variables.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>import_request_variables()</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;This&amp;nbsp;will&amp;nbsp;import&amp;nbsp;GET&amp;nbsp;and&amp;nbsp;POST&amp;nbsp;vars<br />//&amp;nbsp;with&amp;nbsp;an&amp;nbsp;'rvar_'&amp;nbsp;prefix<br /></span><span style='color: #0000BB'>import_request_variables</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'gp'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'rvar_'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$rvar_foo</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.import-request-variables.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/reserved.variables.request.php' class='link'>$_REQUEST</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.register-globals' class='link'>register_globals</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/language.variables.predefined.php' class='link'>Vari&amp;aacute;veis Pr&amp;eacute;-definidas</a></li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.extract.php' class='function' rel='rdfs-seeAlso'>extract()</a> - Importa vari&amp;aacute;veis para a tabela de s&amp;iacute;mbolos a partir de 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="implode" value="<div id='function.implode' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.implode.php'>implode</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>implode</span> &amp;mdash; <span class='dc-title'>Junta elementos de uma matriz em uma string</span></p> </div> <a name='function.implode.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>implode</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$glue</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$pieces</tt></span> )</div> <p class='para rdfs-comment'> Retorna uma string contendo os elementos da matriz na mesma ordem com uma liga&amp;ccedil;&amp;atilde;o entre cada elemento. </p><div class='example'> <p><b>Exemplo #1 <b>implode()</b> exemplo</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$array&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'lastname'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'email'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'phone'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$comma_separated&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>implode</span><span style='color: #007700'>(</span><span style='color: #DD0000'>','</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$array</span><span style='color: #007700'>);<br /><br />print&amp;nbsp;</span><span style='color: #0000BB'>$comma_separated</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;lastname,email,phone<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: <b>implode()</b> pode, por raz&amp;otilde;es hist&amp;oacute;ricas, aceitar seus par&amp;acirc;metros nas duas ordens. Para consist&amp;ecirc;ncia com <a href='http://www.php.net/manual/pt_BR/function.explode.php' class='function'>explode()</a>, entretando, ela pode ser menos confusa por usar a ordem documentada dos argumentos. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Apartir do PHP 4.3.0, o parametro glue da fun&amp;ccedil;&amp;atilde;o <b>implode()</b> &amp;eacute; opcional e seu padr&amp;atilde;o &amp;eacute; uma string em branco(&amp;#039;&amp;#039;). Este n&amp;atilde;o &amp;eacute; o uso preferido de <b>implode()</b>. N&amp;oacute;s recomendamos sempre usar dois parametros para compatibilidade com vers&amp;otilde;es anteriores. <br /> </p></blockquote> <p class='simpara'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.explode.php' class='function'>explode()</a>, e <a href='http://www.php.net/manual/pt_BR/function.split.php' class='function'>split()</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="image_type_to_mime_type" value="<div id='function.image-type-to-mime-type' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.image-type-to-mime-type.php'>image_type_to_mime_type</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>image_type_to_mime_type</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m o Mime-Type para um tipo de imagem retornado por getimagesize, exif_read_data, exif_thumbnail, exif_imagetype</span></p> </div> <a name='function.image-type-to-mime-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'><span class='type string '>string </span></span> <span class='methodname'><b>image_type_to_mime_type</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$imagetype</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>image_type_to_mime_type()</b> ir&amp;aacute; determinar o tipo Mime para uma constante IMAGETYPE. </p> </div> <a name='function.image-type-to-mime-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'>imagetype</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Uma das constantes <i>IMAGETYPE_XXX</i> </p> </dd> </dl> <p> </p> </div> <a name='function.image-type-to-mime-type.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Os valores retornado s&amp;atilde;o como a seguir </p><table class='doctable table'> <caption><b>Constantes de valores retornados</b></caption> <thead valign='middle'> <tr valign='middle'> <th><i><tt class='parameter'>imagetype</tt></i> </th> <th>Returned value</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_GIF</tt></b></td> <td align='left'><i>image/gif</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_JPEG</tt></b></td> <td align='left'><i>image/jpeg</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_PNG</tt></b></td> <td align='left'><i>image/png</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_SWF</tt></b></td> <td align='left'><i>application/x-shockwave-flash</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_PSD</tt></b></td> <td align='left'><i>image/psd</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_BMP</tt></b></td> <td align='left'><i>image/bmp</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_TIFF_II</tt></b> (intel byte order)</td> <td align='left'><i>image/tiff</i></td> </tr> <tr valign='middle'> <td align='left'> <b><tt class='constant'>IMAGETYPE_TIFF_MM</tt></b> (motorola byte order) </td> <td align='left'><i>image/tiff</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_JPC</tt></b></td> <td align='left'><i>application/octet-stream</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_JP2</tt></b></td> <td align='left'><i>image/jp2</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_JPX</tt></b></td> <td align='left'><i>application/octet-stream</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_JB2</tt></b></td> <td align='left'><i>application/octet-stream</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_SWC</tt></b></td> <td align='left'><i>application/x-shockwave-flash</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_IFF</tt></b></td> <td align='left'><i>image/iff</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_WBMP</tt></b></td> <td align='left'><i>image/vnd.wap.wbmp</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_XBM</tt></b></td> <td align='left'><i>image/xbm</i></td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>IMAGETYPE_ICO</tt></b></td> <td align='left'><i>image/vnd.microsoft.icon</i></td> </tr> </tbody> </table> <p> </p> </div> <a name='function.image-type-to-mime-type.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 image_type_to_mime_type (arquivo)</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>image_type_to_mime_type</span><span style='color: #007700'>(</span><span style='color: #0000BB'>IMAGETYPE_PNG</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.image-type-to-mime-type.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 n&amp;atilde;o precisa da biblioteca de imagem GD. <br /> </p></blockquote> </div> <a name='function.image-type-to-mime-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.getimagesize.php' class='function' rel='rdfs-seeAlso'>getimagesize()</a> - Obt&amp;eacute;m o tamanho de uma imagem</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.exif-imagetype.php' class='function' rel='rdfs-seeAlso'>exif_imagetype()</a> - Verifica o tipo de uma imagem</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.exif-read-data.php' class='function' rel='rdfs-seeAlso'>exif_read_data()</a> - L&amp;ecirc; os cabe&amp;ccedil;alhos EXIF de imagens JPEG ou TIFF. Deste modo voc&amp;ecirc; poder&amp;aacute; ler meta dados gerados por cam&amp;ecirc;ras digitais.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.exif-thumbnail.php' class='function' rel='rdfs-seeAlso'>exif_thumbnail()</a> - Recupera a miniatura embutida de uma imagem TIFF ou JPEG</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="image_type_to_extension" value="<div id='function.image-type-to-extension' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.image-type-to-extension.php'>image_type_to_extension</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>image_type_to_extension</span> &amp;mdash; <span class='dc-title'>Get file extension for image type</span></p> </div> <a name='function.image-type-to-extension.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>image_type_to_extension</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$imagetype</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$include_dot</tt></span> ] )</div> <p class='para rdfs-comment'> Returns the extension for the given <i>IMAGETYPE_XXX</i> constant. </p> </div> <a name='function.image-type-to-extension.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'>imagetype</tt></i> </span> </dt><dd class='listitem'> <p class='para'> One of the <i>IMAGETYPE_XXX</i> constant. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>include_dot</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Whether to prepend a dot to the extension or not. Default to <b><tt class='constant'>TRUE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.image-type-to-extension.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> A string with the extension corresponding to the given image type. </p> </div> <a name='function.image-type-to-extension.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>image_type_to_extension()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;image&amp;nbsp;instance<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Save&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'./test'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>image_type_to_extension</span><span style='color: #007700'>(</span><span style='color: #0000BB'>IMAGETYPE_PNG</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.image-type-to-extension.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 n&amp;atilde;o requer a biblioteca de fun&amp;ccedil;&amp;otilde;es de imagem GD.<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="imagexbm" value="<div id='function.imagexbm' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagexbm.php'>imagexbm</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>imagexbm</span> &amp;mdash; <span class='dc-title'>Output XBM image to browser or file</span></p> </div> <a name='function.imagexbm.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>imagexbm</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$foreground</tt></span> ] )</div> <p class='para rdfs-comment'> Outputs or save an <acronym title='X Bitmap'>XBM</acronym> version of the given <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagexbm.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The path to save the file to. If not set or <b><tt class='constant'>NULL</tt></b>, the raw image stream will be outputted directly. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>foreground</tt></i> </span> </dt><dd class='listitem'> <p class='para'> You can set the foreground color with this parameter by setting an identifier obtained from <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a>. The default foreground color is black. </p> </dd> </dl> <p> </p> </div> <a name='function.imagexbm.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.imagexbm.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Saving an XBM file</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;Create&amp;nbsp;a&amp;nbsp;blank&amp;nbsp;image&amp;nbsp;and&amp;nbsp;add&amp;nbsp;some&amp;nbsp;text<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>120</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$text_color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>233</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>14</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>91</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;Simple&amp;nbsp;Text&amp;nbsp;String'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$text_color</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Save&amp;nbsp;the&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagexbm</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'simpletext.xbm'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Free&amp;nbsp;up&amp;nbsp;memory<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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 Saving an XBM file with a different foreground color</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;Create&amp;nbsp;a&amp;nbsp;blank&amp;nbsp;image&amp;nbsp;and&amp;nbsp;add&amp;nbsp;some&amp;nbsp;text<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>120</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$text_color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>233</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>14</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>91</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;Simple&amp;nbsp;Text&amp;nbsp;String'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$text_color</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;a&amp;nbsp;replacement&amp;nbsp;foreground&amp;nbsp;color<br /></span><span style='color: #0000BB'>$foreground_color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Save&amp;nbsp;the&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagexbm</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>NULL</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$foreground_color</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Free&amp;nbsp;up&amp;nbsp;memory<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagexbm.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></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="imagewbmp" value="<div id='function.imagewbmp' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagewbmp.php'>imagewbmp</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>imagewbmp</span> &amp;mdash; <span class='dc-title'>Envia uma imagem para o browser ou arquivo</span></p> </div> <a name='function.imagewbmp.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>imagewbmp</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$foreground</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>imagewbmp()</b> mostra ou salva uma vers&amp;atilde;o <acronym title='Wireless Bitmap'>WBMP</acronym> da dada <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagewbmp.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O caminho para salvar o arquivo. Se n&amp;atilde;o definido ou <b><tt class='constant'>NULL</tt></b>, o stream da imagem ser&amp;aacute; mostrado diretamente. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>foreground</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Voc&amp;ecirc; pode definir a cor de primeiro plano com este par&amp;acirc;metro passando um identificador de cor obtido a partir de <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a>. A cor padr&amp;atilde;o &amp;eacute; preto. </p> </dd> </dl> <p> </p> </div> <a name='function.imagewbmp.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.imagewbmp.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Suporte a WBMP est&amp;aacute; somente dispon&amp;iacute;vel se o PHP foi compilado com GD-1.8 ou superior. <br /> </p></blockquote> </div> <a name='function.imagewbmp.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.image2wbmp.php' class='function' rel='rdfs-seeAlso'>image2wbmp()</a> - Envia uma imagem para o browser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagepng.php' class='function' rel='rdfs-seeAlso'>imagepng()</a> - Envia uma imagem PNG para o browser ou para um arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagegif.php' class='function' rel='rdfs-seeAlso'>imagegif()</a> - Envia uma imagem para o browser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagejpeg.php' class='function' rel='rdfs-seeAlso'>imagejpeg()</a> - Envia a imagem para o borwser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagetypes.php' class='function' rel='rdfs-seeAlso'>imagetypes()</a> - Retorna os tipos de imagens suportados por esta instala&amp;ccedil;&amp;atilde;o do PHP</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="imagetypes" value="<div id='function.imagetypes' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagetypes.php'>imagetypes</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.2, PHP 5)</p><p class='refpurpose'><span class='refname'>imagetypes</span> &amp;mdash; <span class='dc-title'>Retorna os tipos de imagens suportados por esta instala&amp;ccedil;&amp;atilde;o do PHP</span></p> </div> <a name='function.imagetypes.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>imagetypes</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Retorna os tipos de imagens suportados pela instala&amp;ccedil;&amp;atilde;o atual do PHP. </p> </div> <a name='function.imagetypes.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o bit-field correspondendo o formato de imagem suportado pela vers&amp;atilde;o da GD linkada no PHP. Os seguintes bits s&amp;atilde;o retornados, <b><tt class='constant'>IMG_GIF</tt></b> | <b><tt class='constant'>IMG_JPG</tt></b> | <b><tt class='constant'>IMG_PNG</tt></b> | <b><tt class='constant'>IMG_WBMP</tt></b> | <b><tt class='constant'>IMG_XPM</tt></b>. </p> </div> <a name='function.imagetypes.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Verificando o suporte a PNG</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: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>imagetypes</span><span style='color: #007700'>()&amp;nbsp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>IMG_PNG</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'O&amp;nbsp;suporte&amp;nbsp;a&amp;nbsp;PNG&amp;nbsp;esta&amp;nbsp;ativado'</span><span style='color: #007700'>;<br />}<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="imagettftext" value="<div id='function.imagettftext' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagettftext.php'>imagettftext</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagettftext</span> &amp;mdash; <span class='dc-title'>Escreve texto na imagem usando fontes TrueType</span></p> </div> <a name='function.imagettftext.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>imagettftext</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$size</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$fontfile</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> )</div> <p class='para rdfs-comment'> <b>imagettftext()</b> desenha a string <i><tt class='parameter'>text</tt></i> na imagem identificada por <i><tt class='parameter'>image</tt></i> , come&amp;ccedil;ando nas coordenadas <i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> (o canto superior esquerdo &amp;eacute; 0, 0), em um &amp;acirc;ngulo de <i><tt class='parameter'>angle</tt></i> na cor <i><tt class='parameter'>color</tt></i> , usando o arquivo de fonte TrueType identificado por <i><tt class='parameter'>fontfile</tt></i> . Dependendo de qual vers&amp;atilde;o da biblioteca GD o PHP estiver usando o <i><tt class='parameter'>fontfile</tt></i> n&amp;atilde;o come&amp;ccedil;a com &amp;#039;/&amp;#039;, &amp;#039;.ttf&amp;#039; ser&amp;aacute; adicionado ao nome do arquivo e a biblioteca tentar&amp;aacute; encontrar o nome do arquivo entre o caminho de fonte definido na biblioteca. </p> <p class='para'> As coordenadas dadas por <i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> ir&amp;atilde;o definir o ponto base para o primeiro caractere (o canto inferior esquerdo do caractere). Isto &amp;eacute; diferente de <a href='http://www.php.net/manual/pt_BR/function.imagestring.php' class='function'>imagestring()</a>, aonde x, y definem o canto superior direito do primeiro caractere. </p> <p class='para'> <i><tt class='parameter'>angle</tt></i> &amp;eacute; em graus, sendo 0 graus da esqueda para a direita (dire&amp;ccedil;&amp;atilde;o de 3 horas no rel&amp;oacute;gio), e valores maiores representando um rota&amp;ccedil;&amp;atilde;o anti-hor&amp;aacute;ria. (ex. um valor de 90 ir&amp;aacute; resultar em um exto de baixo para cima). </p> <p class='para'> <i><tt class='parameter'>fontfile</tt></i> &amp;eacute; o caminho para a TrueType que voc&amp;ecirc; quer usar. </p> <p class='para'> <i><tt class='parameter'>text</tt></i> &amp;eacute; a string com o texto que pode incluir caracteres UTF-8 (na forma de: &amp;amp;#123;) para acessar caracteres na fonte alem do 255. </p> <p class='para'> <i><tt class='parameter'>color</tt></i> &amp;eacute; o &amp;iacute;ndice da cor. Usando um &amp;iacute;ndice de cor negativo tem o efeito de desativar o antialiasing. </p> <p class='para'> <b>imagettftext()</b> retorna uma matriz com 8 elementos representando quatro pontos fazendo uma caixa em torno do texto. A ordem dos pontos &amp;eacute; inferior esquerdo, inferior direito, superior direito, superior esquerdo. Os pontos s&amp;atilde;o relativos ao texto, sem se importar com o &amp;acirc;ngulo, assim &amp;quot;superior esquerdo&amp;quot; indica o canto superior esquerdo quando voc&amp;ecirc; v&amp;ecirc; o texto horizontalmente. </p> <p class='para'> Este script de exemplo ir&amp;aacute; produzir um JPEG predo de 400x30 pixels, com as palavras &amp;quot;Testing...&amp;quot; em branco na fonte Arial. </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagettftext()</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;header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>400</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Replace&amp;nbsp;path&amp;nbsp;by&amp;nbsp;your&amp;nbsp;own&amp;nbsp;font&amp;nbsp;path<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagettftext</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</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'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'/path/arial.ttf'</span><span style='color: #007700'>,<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'Testing...&amp;nbsp;Omega:&amp;nbsp;&amp;amp;amp;#937;'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o requer a biblioteca GD e a biblioteca <a href='http://www.freetype.org/' class='link external'>&amp;raquo; FreeType</a>. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagettfbbox.php' class='function'>imagettfbbox()</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="imagettfbbox" value="<div id='function.imagettfbbox' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagettfbbox.php'>imagettfbbox</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagettfbbox</span> &amp;mdash; <span class='dc-title'>Retorna uma caixa com o limites de um texto usando fontes TrueType</span></p> </div> <a name='function.imagettfbbox.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>imagettfbbox</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$size</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$fontfile</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o calcula e retorna uma caixa com os limites de um texto para uma fonte TrueType. </p> </div> <a name='function.imagettfbbox.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'>size</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O tamanho da fonte em pixels </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>angle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O &amp;acirc;ngulo em graus no qual <i><tt class='parameter'>text</tt></i> ser&amp;aacute; medido </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>fontfile</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O nome do arquivo de fonte TrueType (Tamb&amp;eacute;m pode ser uma URL). Dependendo de qual vers&amp;atilde;o da biblioteca GD que o PHP esta usando, ele pode tentar procurar por arquivos que n&amp;atilde;o comecem com &amp;#039;/&amp;#039; adicionando &amp;#039;.ttf&amp;#039; ao nome do arquivo e procurando nos caminhos definidos pela biblioteca de fonte </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string a ser medida </p> </dd> </dl> <p> </p> </div> <a name='function.imagettfbbox.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>imagettfbbox()</b> retorna uma matriz com 8 elementos representando os quatro pontos fazendo o contorno do texto: </p><table class='doctable informaltable'> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>Canto inferior esquerdo, posi&amp;ccedil;&amp;atilde;o X</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>Canto inferior esquerdo, posi&amp;ccedil;&amp;atilde;o Y</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>Canto inferior direito, posi&amp;ccedil;&amp;atilde;o X</td> </tr> <tr valign='middle'> <td align='left'>3</td> <td align='left'>Canto inferior direito, posi&amp;ccedil;&amp;atilde;o Y</td> </tr> <tr valign='middle'> <td align='left'>4</td> <td align='left'>Canto superior direito, posi&amp;ccedil;&amp;atilde;o X</td> </tr> <tr valign='middle'> <td align='left'>5</td> <td align='left'>Canto superior direito, posi&amp;ccedil;&amp;atilde;o Y</td> </tr> <tr valign='middle'> <td align='left'>6</td> <td align='left'>Canto superior esquerdo, posi&amp;ccedil;&amp;atilde;o X</td> </tr> <tr valign='middle'> <td align='left'>7</td> <td align='left'>Canto superior esquerdo, posi&amp;ccedil;&amp;atilde;o Y</td> </tr> </tbody> </table> <p> </p> <p class='para'> Os pontos s&amp;atilde;o relativos ao <em class='emphasis'>text</em> sem importar o &amp;acirc;ngulo, assim &amp;quot;superior esquerdo&amp;quot; indica o canto superior esquerdo quando se v&amp;ecirc; o texto horizontalmente. </p> </div> <a name='function.imagettfbbox.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o requer tanto biblioteca GD e a biblioteca <a href='http://www.freetype.org/' class='link external'>&amp;raquo; FreeType</a>. <br /> </p></blockquote> </div> <a name='function.imagettfbbox.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.imagettftext.php' class='function' rel='rdfs-seeAlso'>imagettftext()</a> - Escreve texto na imagem usando fontes TrueType</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="imagetruecolortopalette" value="<div id='function.imagetruecolortopalette' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagetruecolortopalette.php'>imagetruecolortopalette</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagetruecolortopalette</span> &amp;mdash; <span class='dc-title'>Converte uma imagem true color para uma imagem de paleta</span></p> </div> <a name='function.imagetruecolortopalette.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>imagetruecolortopalette</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$dither</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$ncolors</tt></span> )</div> <p class='para rdfs-comment'> <b>imagetruecolortopalette()</b> converte uma imagem truecolor para uma imagem de paleta. O c&amp;oacute;digo para esta fun&amp;ccedil;&amp;atilde;o foi escrito originalmente pelo Independent JPEG Group library code, o qual &amp;eacute; excelente. O c&amp;oacute;digo foi modificado para preservar tanta informa&amp;ccedil;&amp;atilde;o do alpha channel quanto poss&amp;iacute;vel na paleta de resultado, em adi&amp;ccedil;&amp;atilde;o a preservar as cores t&amp;atilde;o bem quanto poss&amp;iacute;vel. Isto n&amp;atilde;o funciona t&amp;atilde;o bem quanto podia ser esperado. Normalmente &amp;eacute; melhor simplesmente produzir e enviar uma imagem truecolor, a qual tem garantidamente uma qualidade de sa&amp;iacute;da melhor. </p> </div> <a name='function.imagetruecolortopalette.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dither</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>dither</tt></i> indica se a imagem deve ser estremecida - se ele &amp;eacute; <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o o estremecimento ser&amp;aacute; usado, o que resulta em uma imagem mais manchada mas com melhor aproxima&amp;ccedil;&amp;atilde;o da cor. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>ncolors</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Define o n&amp;uacute;mero m&amp;aacute;ximo de cores que devem ser retidos na paleta. </p> </dd> </dl> <p> </p> </div> <a name='function.imagetruecolortopalette.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.imagetruecolortopalette.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></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="imagesy" value="<div id='function.imagesy' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesy.php'>imagesy</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesy</span> &amp;mdash; <span class='dc-title'>Obt&amp;eacute;m a altura da imagem</span></p> </div> <a name='function.imagesy.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>imagesy</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> )</div> <p class='para rdfs-comment'> Retorna a altura do dado resource <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagesy.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.imagesy.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a altura da <i><tt class='parameter'>image</tt></i> ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> <a name='function.imagesy.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Usando <b>imagesy()</b></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;create&amp;nbsp;a&amp;nbsp;300*200&amp;nbsp;image<br /></span><span style='color: #0000BB'>$img&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>imagesy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;200<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.imagesy.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.imagecreatetruecolor.php' class='function' rel='rdfs-seeAlso'>imagecreatetruecolor()</a> - Cria uma nova imagem true color</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.getimagesize.php' class='function' rel='rdfs-seeAlso'>getimagesize()</a> - Obt&amp;eacute;m o tamanho de uma imagem</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagesx.php' class='function' rel='rdfs-seeAlso'>imagesx()</a> - Obtem a largura da imagem</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="imagesx" value="<div id='function.imagesx' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesx.php'>imagesx</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesx</span> &amp;mdash; <span class='dc-title'>Obtem a largura da imagem</span></p> </div> <a name='function.imagesx.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>imagesx</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> )</div> <p class='para rdfs-comment'> Retorna a largura do dado resource <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagesx.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.imagesx.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a largura da <i><tt class='parameter'>image</tt></i> ou <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> <a name='function.imagesx.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Usando <b>imagesx()</b></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;cria&amp;nbsp;uma&amp;nbsp;imagem&amp;nbsp;de&amp;nbsp;300*200<br /></span><span style='color: #0000BB'>$img&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;300<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.imagesx.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.imagecreatetruecolor.php' class='function' rel='rdfs-seeAlso'>imagecreatetruecolor()</a> - Cria uma nova imagem true color</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.getimagesize.php' class='function' rel='rdfs-seeAlso'>getimagesize()</a> - Obt&amp;eacute;m o tamanho de uma imagem</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagesy.php' class='function' rel='rdfs-seeAlso'>imagesy()</a> - Obt&amp;eacute;m a altura da imagem</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="imagestringup" value="<div id='function.imagestringup' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagestringup.php'>imagestringup</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagestringup</span> &amp;mdash; <span class='dc-title'>Desenha uma string verticalmente</span></p> </div> <a name='function.imagestringup.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>imagestringup</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$font</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$s</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$col</tt></span> )</div> <p class='para rdfs-comment'> <b>imagestringup()</b> desenha a string <i><tt class='parameter'>s</tt></i> verticalmente na imagem identificada por <i><tt class='parameter'>image</tt></i> nas coordenadas <i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> (em cima na esquerda &amp;eacute; 0, 0) na cor <i><tt class='parameter'>col</tt></i> . Se a fonte for 1, 2, 3, 4 ou 5, uma fonte interna &amp;eacute; usada. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function'>imageloadfont()</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="imagestring" value="<div id='function.imagestring' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagestring.php'>imagestring</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagestring</span> &amp;mdash; <span class='dc-title'>Desenha uma string horizontalmente</span></p> </div> <a name='function.imagestring.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>imagestring</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$font</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> Desenha uma <i><tt class='parameter'>string</tt></i> nas dadas coordenadas. </p> </div> <a name='function.imagestring.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'> font</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Pode ser 1, 2, 3, 4, 5 para as fontes embutidas na codifica&amp;ccedil;&amp;atilde;o latin2 (aonde n&amp;uacute;meros maiores correspondem a fontes mais largas) ou qualquer um dos seus pr&amp;oacute;pios identificadores de fonte registrado com <a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function'>imageloadfont()</a>. </p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Coordenada x superior &amp;agrave; esquerda </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Coordenada y superior &amp;agrave; esquerda </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string a ser escrita </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>color</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Um identificador de cor criado com <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a> </p> </dd> </dl> <p> </p> </div> <a name='function.imagestring.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.imagestring.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>imagestring()</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;</span><span style='color: #FF8000'>//&amp;nbsp;cria&amp;nbsp;uma&amp;nbsp;imagem&amp;nbsp;de&amp;nbsp;100*30<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>);<br /><br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;fundo&amp;nbsp;branco&amp;nbsp;e&amp;nbsp;texto&amp;nbsp;azul<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$textcolor&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;escreve&amp;nbsp;a&amp;nbsp;string&amp;nbsp;em&amp;nbsp;cima&amp;nbsp;na&amp;nbsp;esquerda<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Hello&amp;nbsp;world!'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$textcolor</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;envia&amp;nbsp;a&amp;nbsp;imagem<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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='mediaobject'> <div class='imageobject'> <img src='images/d481d625821a97b9a5eb2cec99dca50e-image.imagestring.png' /> </div> </div> </div><p> </p> </div> <a name='function.imagestring.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.imageloadfont.php' class='function' rel='rdfs-seeAlso'>imageloadfont()</a> - Carrega uma nova fonte</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagettftext.php' class='function' rel='rdfs-seeAlso'>imagettftext()</a> - Escreve texto na imagem usando fontes TrueType</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="imagesettile" value="<div id='function.imagesettile' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesettile.php'>imagesettile</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesettile</span> &amp;mdash; <span class='dc-title'>Set the tile image for filling</span></p> </div> <a name='function.imagesettile.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>imagesettile</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$tile</tt></span> )</div> <p class='para rdfs-comment'> <b>imagesettile()</b> sets the tile image to be used by all region filling functions (such as <a href='http://www.php.net/manual/pt_BR/function.imagefill.php' class='function'>imagefill()</a> and <a href='http://www.php.net/manual/pt_BR/function.imagefilledpolygon.php' class='function'>imagefilledpolygon()</a>) when filling with the special color <b><tt class='constant'>IMG_COLOR_TILED</tt></b>. </p> <p class='para'> A tile is an image used to fill an area with a repeated pattern. <em class='emphasis'>Any</em> GD image can be used as a tile, and by setting the transparent color index of the tile image with <a href='http://www.php.net/manual/pt_BR/function.imagecolortransparent.php' class='function'>imagecolortransparent()</a>, a tile allows certain parts of the underlying area to shine through can be created. </p> <blockquote><p><b class='note'>Nota</b>: You need not take special action when you are finished with a tile, but if you destroy the tile image, you must not use the <b><tt class='constant'>IMG_COLOR_TILED</tt></b> color until you have set a new tile image! <br /> </p></blockquote> </div> <a name='function.imagesettile.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>tile</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The image resource to be used as a tile. </p> </dd> </dl> <p> </p> </div> <a name='function.imagesettile.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.imagesettile.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagesettile()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;an&amp;nbsp;external&amp;nbsp;image<br /></span><span style='color: #0000BB'>$zend&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromgif</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./zend.gif'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;200x200&amp;nbsp;image<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;the&amp;nbsp;tile<br /></span><span style='color: #0000BB'>imagesettile</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$zend</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Make&amp;nbsp;the&amp;nbsp;image&amp;nbsp;repeat<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>199</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>199</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_COLOR_TILED</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;image&amp;nbsp;to&amp;nbsp;the&amp;nbsp;browser<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$zend</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagesettile.png' /> </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="imagesetthickness" value="<div id='function.imagesetthickness' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesetthickness.php'>imagesetthickness</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesetthickness</span> &amp;mdash; <span class='dc-title'>Define a espessura para o desenho de linhas</span></p> </div> <a name='function.imagesetthickness.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>imagesetthickness</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$thickness</tt></span> )</div> <p class='para rdfs-comment'> <b>imagesetthickness()</b> define a espessura das linhas desenhadas quando esta desenhando retangulos, poligonos, elipses, etc. para <i><tt class='parameter'>thickness</tt></i> pixels. </p> </div> <a name='function.imagesetthickness.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>thickness</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagesetthickness.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.imagesetthickness.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></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="imagesetstyle" value="<div id='function.imagesetstyle' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesetstyle.php'>imagesetstyle</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesetstyle</span> &amp;mdash; <span class='dc-title'>Set the style for line drawing</span></p> </div> <a name='function.imagesetstyle.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>imagesetstyle</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$style</tt></span> )</div> <p class='para rdfs-comment'> <b>imagesetstyle()</b> sets the style to be used by all line drawing functions (such as <a href='http://www.php.net/manual/pt_BR/function.imageline.php' class='function'>imageline()</a> and <a href='http://www.php.net/manual/pt_BR/function.imagepolygon.php' class='function'>imagepolygon()</a>) when drawing with the special color <b><tt class='constant'>IMG_COLOR_STYLED</tt></b> or lines of images with color <b><tt class='constant'>IMG_COLOR_STYLEDBRUSHED</tt></b>. </p> </div> <a name='function.imagesetstyle.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>style</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An array of pixel colors. You can use the <b><tt class='constant'>IMG_COLOR_TRANSPARENT</tt></b> constant to add a transparent pixel. </p> </dd> </dl> <p> </p> </div> <a name='function.imagesetstyle.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.imagesetstyle.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> Following example script draws a dashed line from upper left to lower right corner of the canvas: </p><div class='example'> <p><b>Exemplo #1 <b>imagesetstyle()</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 />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$im&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$w&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$red&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Draw&amp;nbsp;a&amp;nbsp;dashed&amp;nbsp;line,&amp;nbsp;5&amp;nbsp;red&amp;nbsp;pixels,&amp;nbsp;5&amp;nbsp;white&amp;nbsp;pixels&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$style&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagesetstyle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$style</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imageline</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_COLOR_STYLED</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Draw&amp;nbsp;a&amp;nbsp;line&amp;nbsp;of&amp;nbsp;happy&amp;nbsp;faces&amp;nbsp;using&amp;nbsp;imagesetbrush()&amp;nbsp;with&amp;nbsp;imagesetstyle&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$style&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagesetstyle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$style</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$brush&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'http://www.libpng.org/pub/png/images/smile.happy.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$w2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$brush</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagecolortransparent</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$brush</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$w2</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagesetbrush</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$brush</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imageline</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_COLOR_STYLEDBRUSHED</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagesetstyle.jpg' /> </div> </div> </div><p> </p> </div> <a name='function.imagesetstyle.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.imagesetbrush.php' class='function' rel='rdfs-seeAlso'>imagesetbrush()</a> - Set the brush image for line drawing</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imageline.php' class='function' rel='rdfs-seeAlso'>imageline()</a> - Desenha uma linha</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="imagesetpixel" value="<div id='function.imagesetpixel' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesetpixel.php'>imagesetpixel</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesetpixel</span> &amp;mdash; <span class='dc-title'>Define um &amp;uacute;nico pixel</span></p> </div> <a name='function.imagesetpixel.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>imagesetpixel</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagesetpixel()</b> desenha um pixel em <i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> (em cima na esquerda &amp;eacute; 0, 0) na imagem <i><tt class='parameter'>image</tt></i> com a cor <i><tt class='parameter'>color</tt></i> . </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecreate.php' class='function'>imagecreate()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</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="imagesetbrush" value="<div id='function.imagesetbrush' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesetbrush.php'>imagesetbrush</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesetbrush</span> &amp;mdash; <span class='dc-title'>Set the brush image for line drawing</span></p> </div> <a name='function.imagesetbrush.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>imagesetbrush</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$brush</tt></span> )</div> <p class='para rdfs-comment'> <b>imagesetbrush()</b> sets the brush image to be used by all line drawing functions (such as <a href='http://www.php.net/manual/pt_BR/function.imageline.php' class='function'>imageline()</a> and <a href='http://www.php.net/manual/pt_BR/function.imagepolygon.php' class='function'>imagepolygon()</a>) when drawing with the special colors <b><tt class='constant'>IMG_COLOR_BRUSHED</tt></b> or <b><tt class='constant'>IMG_COLOR_STYLEDBRUSHED</tt></b>. </p> </div> <a name='function.imagesetbrush.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>brush</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An image resource. </p> </dd> </dl> <p> </p> </div> <a name='function.imagesetbrush.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.imagesetbrush.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagesetbrush()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;a&amp;nbsp;mini&amp;nbsp;php&amp;nbsp;logo<br /></span><span style='color: #0000BB'>$php&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./php.png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;main&amp;nbsp;image,&amp;nbsp;100x100<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Fill&amp;nbsp;the&amp;nbsp;background&amp;nbsp;with&amp;nbsp;white<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>299</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>99</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;the&amp;nbsp;brush<br /></span><span style='color: #0000BB'>imagesetbrush</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$php</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Draw&amp;nbsp;a&amp;nbsp;couple&amp;nbsp;of&amp;nbsp;brushes,&amp;nbsp;each&amp;nbsp;overlaying&amp;nbsp;each<br /></span><span style='color: #0000BB'>imageline</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>60</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_COLOR_BRUSHED</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;image&amp;nbsp;to&amp;nbsp;the&amp;nbsp;browser<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$php</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagesetbrush.png' /> </div> </div> </div><p> </p> </div> <a name='function.imagesetbrush.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: You need not take special action when you are finished with a brush, but if you destroy the brush image, you must not use the <b><tt class='constant'>IMG_COLOR_BRUSHED</tt></b> or <b><tt class='constant'>IMG_COLOR_STYLEDBRUSHED</tt></b> colors until you have set a new brush image! <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="imagesavealpha" value="<div id='function.imagesavealpha' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagesavealpha.php'>imagesavealpha</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.2, PHP 5)</p><p class='refpurpose'><span class='refname'>imagesavealpha</span> &amp;mdash; <span class='dc-title'> Define a op&amp;ccedil;&amp;atilde;o para salvar a informa&amp;ccedil;&amp;atilde;o completa do alpha channel (ao inv&amp;eacute;s de a transparencia de uma cor s&amp;oacute;) quando estiver salvando imagens PNG. </span></p> </div> <a name='function.imagesavealpha.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>imagesavealpha</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$saveflag</tt></span> )</div> <p class='para rdfs-comment'> <b>imagesavealpha()</b> define a op&amp;ccedil;&amp;atilde;o para tentas salvar toda a informa&amp;ccedil;&amp;atilde;o de alpha channel (ao inv&amp;eacute;s de a trnaparencia de uma cor s&amp;oacute;) quando estiver salvando imagens PNG. </p> <p class='para'> Voc&amp;ecirc; deve desabilitar o alphablending (<i>imagealphablending($im, false)</i>), para poder usa-la. </p> <p class='para'> Alpha channel n&amp;atilde;o &amp;eacute; suportado por todos os browsers, se voc&amp;ecirc; tiver problema com o seu browser, tente carregar o seu script em um browser com suporte ao alpha channel browser, ex. a vers&amp;atilde;o mais recente do Mozilla. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagealphablending.php' class='function'>imagealphablending()</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="imagerotate" value="<div id='function.imagerotate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagerotate.php'>imagerotate</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>imagerotate</span> &amp;mdash; <span class='dc-title'>Gira uma imagem com o &amp;acirc;ngulo dado</span></p> </div> <a name='function.imagerotate.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>imagerotate</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$src_im</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$bgd_color</tt></span> )</div> <p class='para rdfs-comment'> Gira a imagem <i><tt class='parameter'>src_im</tt></i> usando o &amp;acirc;ngulo <i><tt class='parameter'>angle</tt></i> dado em graus. <i><tt class='parameter'>bgd_color</tt></i> especifica a cor da zona descoberta ap&amp;oacute;s a rota&amp;ccedil;&amp;atilde;o. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></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="imagerectangle" value="<div id='function.imagerectangle' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagerectangle.php'>imagerectangle</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagerectangle</span> &amp;mdash; <span class='dc-title'>Desenha um ret&amp;acirc;ngulo</span></p> </div> <a name='function.imagerectangle.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>imagerectangle</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$col</tt></span> )</div> <p class='para rdfs-comment'> <b>imagerectangle()</b> cria um ret&amp;acirc;ngulo de cor <i><tt class='parameter'>col</tt></i> na imagem <i><tt class='parameter'>image</tt></i> come&amp;ccedil;ando na coordenada superior esquerda x1, y1 e terminando na coordenada inferior direita x2, y2. 0, 0 &amp;eacute; o canto superior esquerdo da imagem. </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="imagepstext" value="<div id='function.imagepstext' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepstext.php'>imagepstext</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepstext</span> &amp;mdash; <span class='dc-title'>Draws a text over an image using PostScript Type1 fonts</span></p> </div> <a name='function.imagepstext.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>imagepstext</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$font_index</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$size</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$foreground</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$background</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$space</tt><span class='initializer'> = 0</span></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$tightness</tt><span class='initializer'> = 0</span></span> [, <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt><span class='initializer'> = 0.0</span></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$antialias_steps</tt><span class='initializer'> = 4</span></span> ]]]] )</div> <p class='para rdfs-comment'> Draws a text on an image using PostScript Type1 fonts. </p> <p class='para'> Refer to PostScript documentation about fonts and their measuring system if you have trouble understanding how this works. </p> </div> <a name='function.imagepstext.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The text to be written. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>font_index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A font resource, returned by <a href='http://www.php.net/manual/pt_BR/function.imagepsloadfont.php' class='function'>imagepsloadfont()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>size</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>size</tt></i> is expressed in pixels. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>foreground</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The color in which the text will be painted. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>background</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The color to which the text will try to fade in with antialiasing. No pixels with the color <i><tt class='parameter'>background</tt></i> are actually painted, so the background image does not need to be of solid color. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate for the lower-left corner of the first character. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate for the lower-left corner of the first character. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>space</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Allows you to change the default value of a space in a font. This amount is added to the normal value and can also be negative. Expressed in character space units, where 1 unit is 1/1000th of an em-square. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>tightness</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>tightness</tt></i> allows you to control the amount of white space between characters. This amount is added to the normal character width and can also be negative. Expressed in character space units, where 1 unit is 1/1000th of an em-square. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>angle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>angle</tt></i> is in degrees. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>antialias_steps</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Allows you to control the number of colours used for antialiasing text. Allowed values are 4 and 16. The higher value is recommended for text sizes lower than 20, where the effect in text quality is quite visible. With bigger sizes, use 4. It&amp;#039;s less computationally intensive. </p> </dd> </dl> <p> </p> </div> <a name='function.imagepstext.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> This function returns an array containing the following elements: </p><table class='doctable informaltable'> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>lower left x-coordinate</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>lower left y-coordinate</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>upper right x-coordinate</td> </tr> <tr valign='middle'> <td align='left'>3</td> <td align='left'>upper right y-coordinate</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.imagepstext.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 <b>imagepstext()</b> usage</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;Create&amp;nbsp;image&amp;nbsp;handle<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Allocate&amp;nbsp;colors<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;the&amp;nbsp;PostScript&amp;nbsp;Font<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'font.pfm'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Write&amp;nbsp;the&amp;nbsp;font&amp;nbsp;to&amp;nbsp;the&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagepstext</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Sample&amp;nbsp;text&amp;nbsp;is&amp;nbsp;simple'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;and&amp;nbsp;free&amp;nbsp;memory<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> </div> <a name='function.imagepstext.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></p></blockquote> </div> <a name='function.imagepstext.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.imagepsbbox.php' class='function' rel='rdfs-seeAlso'>imagepsbbox()</a> - Give the bounding box of a text rectangle using PostScript Type1 fonts</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="imagepsslantfont" value="<div id='function.imagepsslantfont' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepsslantfont.php'>imagepsslantfont</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepsslantfont</span> &amp;mdash; <span class='dc-title'>Slant a font</span></p> </div> <a name='function.imagepsslantfont.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>imagepsslantfont</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$font_index</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$slant</tt></span> )</div> <p class='para rdfs-comment'> Slant a given font given. </p> </div> <a name='function.imagepsslantfont.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'>font_index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A font resource, returned by <a href='http://www.php.net/manual/pt_BR/function.imagepsloadfont.php' class='function'>imagepsloadfont()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>slant</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Slant level. </p> </dd> </dl> <p> </p> </div> <a name='function.imagepsslantfont.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.imagepsslantfont.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagepsslantfont()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;a&amp;nbsp;.pfb&amp;nbsp;font&amp;nbsp;file<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./px3l.pfb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Slant&amp;nbsp;the&amp;nbsp;font&amp;nbsp;by&amp;nbsp;22.5<br /></span><span style='color: #0000BB'>imagepsslantfont</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>22.5</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Do&amp;nbsp;any&amp;nbsp;operations&amp;nbsp;with&amp;nbsp;the&amp;nbsp;font&amp;nbsp;here<br /><br />//&amp;nbsp;Free&amp;nbsp;the&amp;nbsp;font&amp;nbsp;from&amp;nbsp;memory<br /></span><span style='color: #0000BB'>imagepsfreefont</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</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.imagepsslantfont.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></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="imagepsloadfont" value="<div id='function.imagepsloadfont' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepsloadfont.php'>imagepsloadfont</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepsloadfont</span> &amp;mdash; <span class='dc-title'>Carrega uma fonte PostScript Type 1 a partir de um arquivo</span></p> </div> <a name='function.imagepsloadfont.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>imagepsloadfont</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> Carrega uma fonte PostScript Type 1 do dado <i><tt class='parameter'>filename</tt></i> . </p> </div> <a name='function.imagepsloadfont.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagepsloadfont.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Se tudo for feito corretamente, um &amp;iacute;ndice de fonte v&amp;aacute;lida ser&amp;aacute; retornado e poder&amp;aacute; ser usado para v&amp;aacute;rios prop&amp;oacute;sitos. Caso contr&amp;aacute;rio a fun&amp;ccedil;&amp;atilde;o retorna <b><tt class='constant'>FALSE</tt></b>. </p> </div> <a name='function.imagepsloadfont.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>imagepsloadfont()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>350</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>45</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>349</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>44</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'bchbi.pfb'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;or&amp;nbsp;locate&amp;nbsp;your&amp;nbsp;.pfb&amp;nbsp;files&amp;nbsp;on&amp;nbsp;your&amp;nbsp;machine<br /></span><span style='color: #0000BB'>imagepstext</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Testing...&amp;nbsp;It&amp;nbsp;worked!'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>32</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>32</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>32</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepsfreefont</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagepsloadfont.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></p></blockquote> </div> <a name='function.imagepsloadfont.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.imagepsfreefont.php' class='function' rel='rdfs-seeAlso'>imagepsfreefont()</a> - Libera a mem&amp;oacute;ria usada por uma fonte PostScript Type</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="imagepsfreefont" value="<div id='function.imagepsfreefont' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepsfreefont.php'>imagepsfreefont</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepsfreefont</span> &amp;mdash; <span class='dc-title'>Libera a mem&amp;oacute;ria usada por uma fonte PostScript Type</span></p> </div> <a name='function.imagepsfreefont.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>imagepsfreefont</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$fontindex</tt></span> )</div> <p class='para rdfs-comment'> <b>imagepsfreefont()</b> libera a mem&amp;oacute;ria usada por uma fonte PostScript Type 1. </p> </div> <a name='function.imagepsfreefont.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'>fontindex</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagepsfreefont.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.imagepsfreefont.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></p></blockquote> </div> <a name='function.imagepsfreefont.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.imagepsloadfont.php' class='function' rel='rdfs-seeAlso'>imagepsloadfont()</a> - Carrega uma fonte PostScript Type 1 a partir de um arquivo</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="imagepsextendfont" value="<div id='function.imagepsextendfont' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepsextendfont.php'>imagepsextendfont</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepsextendfont</span> &amp;mdash; <span class='dc-title'>Extend or condense a font</span></p> </div> <a name='function.imagepsextendfont.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>imagepsextendfont</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$font_index</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$extend</tt></span> )</div> <p class='para rdfs-comment'> Extend or condense a font (<i><tt class='parameter'>font_index</tt></i> ), if the value of the <i><tt class='parameter'>extend</tt></i> parameter is less than one you will be condensing the font. </p> </div> <a name='function.imagepsextendfont.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'>font_index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A font resource, returned by <a href='http://www.php.net/manual/pt_BR/function.imagepsloadfont.php' class='function'>imagepsloadfont()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>extend</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Extension value, must be greater than 0. </p> </dd> </dl> <p> </p> </div> <a name='function.imagepsextendfont.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.imagepsextendfont.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagepsextendfont()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;a&amp;nbsp;.pfb&amp;nbsp;font&amp;nbsp;file<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./px3l.pfb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Extend&amp;nbsp;the&amp;nbsp;font&amp;nbsp;by&amp;nbsp;2.5<br /></span><span style='color: #0000BB'>imagepsextendfont</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2.5</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Do&amp;nbsp;any&amp;nbsp;operations&amp;nbsp;with&amp;nbsp;the&amp;nbsp;font&amp;nbsp;here<br /><br />//&amp;nbsp;Free&amp;nbsp;the&amp;nbsp;font&amp;nbsp;from&amp;nbsp;memory<br /></span><span style='color: #0000BB'>imagepsfreefont</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</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.imagepsextendfont.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></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="imagepsencodefont" value="<div id='function.imagepsencodefont' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepsencodefont.php'>imagepsencodefont</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepsencodefont</span> &amp;mdash; <span class='dc-title'>Change the character encoding vector of a font</span></p> </div> <a name='function.imagepsencodefont.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>imagepsencodefont</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$font_index</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$encodingfile</tt></span> )</div> <p class='para rdfs-comment'> Loads a character encoding vector from a file and changes the fonts encoding vector to it. As a PostScript fonts default vector lacks most of the character positions above 127, you&amp;#039;ll definitely want to change this if you use an other language than English. </p> <p class='para'> If you find yourself using this function all the time, a much better way to define the encoding is to set ps.default_encoding in the <a href='http://www.php.net/manual/pt_BR/configuration.file.php' class='link'>configuration file</a> to point to the right encoding file and all fonts you load will automatically have the right encoding. </p> </div> <a name='function.imagepsencodefont.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'>font_index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A font resource, returned by <a href='http://www.php.net/manual/pt_BR/function.imagepsloadfont.php' class='function'>imagepsloadfont()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>encodingfile</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The exact format of this file is described in T1libs documentation. T1lib comes with two ready-to-use files, <var class='filename'>IsoLatin1.enc</var> and <var class='filename'>IsoLatin2.enc</var>. </p> </dd> </dl> <p> </p> </div> <a name='function.imagepsencodefont.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.imagepsencodefont.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagepsencodefont()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;a&amp;nbsp;.pfb&amp;nbsp;font&amp;nbsp;file<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./px3l.pfb'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Tell&amp;nbsp;T1lib&amp;nbsp;to&amp;nbsp;use&amp;nbsp;ISO&amp;nbsp;Latin&amp;nbsp;1&amp;nbsp;encoding<br /></span><span style='color: #0000BB'>imagepsencode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'./IsoLatin1.enc'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Do&amp;nbsp;any&amp;nbsp;operations&amp;nbsp;with&amp;nbsp;the&amp;nbsp;font&amp;nbsp;here<br /><br />//&amp;nbsp;Free&amp;nbsp;the&amp;nbsp;font&amp;nbsp;from&amp;nbsp;memory<br /></span><span style='color: #0000BB'>imagepsfreefont</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$font</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.imagepsencodefont.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></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="imagepsbbox" value="<div id='function.imagepsbbox' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepsbbox.php'>imagepsbbox</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepsbbox</span> &amp;mdash; <span class='dc-title'>Give the bounding box of a text rectangle using PostScript Type1 fonts</span></p> </div> <a name='function.imagepsbbox.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>imagepsbbox</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$font</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$size</tt></span> )</div> <div class='methodsynopsis dc-description'> <span class='type'>array</span> <span class='methodname'><b>imagepsbbox</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$font</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$size</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$space</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$tightness</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt></span> )</div> <p class='para rdfs-comment'> Gives the bounding box of a text rectangle using PostScript Type1 fonts. </p> <p class='para'> The bounding box is calculated using information available from character metrics, and unfortunately tends to differ slightly from the results achieved by actually rasterizing the text. If the angle is 0 degrees, you can expect the text to need 1 pixel more to every direction. </p> </div> <a name='function.imagepsbbox.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'>text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The text to be written. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>font_index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A font resource, returned by <a href='http://www.php.net/manual/pt_BR/function.imagepsloadfont.php' class='function'>imagepsloadfont()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>size</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>size</tt></i> is expressed in pixels. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>space</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Allows you to change the default value of a space in a font. This amount is added to the normal value and can also be negative. Expressed in character space units, where 1 unit is 1/1000th of an em-square. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>tightness</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>tightness</tt></i> allows you to control the amount of white space between characters. This amount is added to the normal character width and can also be negative. Expressed in character space units, where 1 unit is 1/1000th of an em-square. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>angle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>angle</tt></i> is in degrees. </p> </dd> </dl> <p> </p> </div> <a name='function.imagepsbbox.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an array containing the following elements: </p><table class='doctable informaltable'> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>left x-coordinate</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>upper y-coordinate</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>right x-coordinate</td> </tr> <tr valign='middle'> <td align='left'>3</td> <td align='left'>lower y-coordinate</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.imagepsbbox.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 <b>imagepsbbox()</b> usage</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;Create&amp;nbsp;image&amp;nbsp;handle<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Allocate&amp;nbsp;colors<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Load&amp;nbsp;the&amp;nbsp;PostScript&amp;nbsp;Font<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'font.pfm'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Make&amp;nbsp;a&amp;nbsp;bounding&amp;nbsp;box&amp;nbsp;for&amp;nbsp;the&amp;nbsp;font<br /></span><span style='color: #0000BB'>$bbox&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagepsbbox</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Sample&amp;nbsp;text&amp;nbsp;is&amp;nbsp;simple'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Define&amp;nbsp;our&amp;nbsp;X&amp;nbsp;and&amp;nbsp;Y&amp;nbsp;cordinates<br /></span><span style='color: #0000BB'>$x&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;(</span><span style='color: #0000BB'>$bbox</span><span style='color: #007700'>[</span><span style='color: #0000BB'>2</span><span style='color: #007700'>]&amp;nbsp;/&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$y&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;(</span><span style='color: #0000BB'>$bbox</span><span style='color: #007700'>[</span><span style='color: #0000BB'>3</span><span style='color: #007700'>]&amp;nbsp;/&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Write&amp;nbsp;the&amp;nbsp;font&amp;nbsp;to&amp;nbsp;the&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagepstext</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Sample&amp;nbsp;text&amp;nbsp;is&amp;nbsp;simple'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>12</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;and&amp;nbsp;free&amp;nbsp;memory<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> </div> <a name='function.imagepsbbox.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com <span class='option'>--with-t1lib[=DIR]</span>. </span></p></blockquote> </div> <a name='function.imagepsbbox.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.imagepstext.php' class='function' rel='rdfs-seeAlso'>imagepstext()</a> - Draws a text over an image using PostScript Type1 fonts</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="imagepolygon" value="<div id='function.imagepolygon' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepolygon.php'>imagepolygon</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepolygon</span> &amp;mdash; <span class='dc-title'>Desenha um poligono</span></p> </div> <a name='function.imagepolygon.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>imagepolygon</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$points</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$num_points</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagepolygon()</b> cria um poligono em uma imagem. <i><tt class='parameter'>points</tt></i> &amp;eacute; uma matriz PHP contendo os v&amp;eacute;rtices do poligono, ex. points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. <i><tt class='parameter'>num_points</tt></i> &amp;eacute; o n&amp;uacute;mero total de pontos(v&amp;eacute;rtices). </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagepolygon()</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;cria&amp;nbsp;uma&amp;nbsp;imagem&amp;nbsp;em&amp;nbsp;branco<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>400</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;prenche&amp;nbsp;a&amp;nbsp;cor&amp;nbsp;do&amp;nbsp;fundo<br /></span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;escolhe&amp;nbsp;uma&amp;nbsp;cor&amp;nbsp;para&amp;nbsp;o&amp;nbsp;poligono<br /></span><span style='color: #0000BB'>$col_poly&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;desenha&amp;nbsp;o&amp;nbsp;poligono<br /></span><span style='color: #0000BB'>imagepolygon</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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;array&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: #0000BB'>0</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;&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'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</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;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200<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: #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;</span><span style='color: #0000BB'>3</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;</span><span style='color: #0000BB'>$col_poly</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;envia&amp;nbsp;a&amp;nbsp;imagem<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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.imagecreate.php' class='function'>imagecreate()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</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="imagepng" value="<div id='function.imagepng' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepng.php'>imagepng</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepng</span> &amp;mdash; <span class='dc-title'>Envia uma imagem PNG para o browser ou para um arquivo</span></p> </div> <a name='function.imagepng.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>imagepng</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> ] )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>imagepng()</b> envia um stream GD de imagem (<i><tt class='parameter'>image</tt></i> ) no formato PNG para a sa&amp;iacute;da padr&amp;atilde;o (normalmente o browser) ou, se for dado um nome de arquivo no par&amp;acirc;metro <i><tt class='parameter'>filename</tt></i> ele envia a imagem para um arquivo. </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 />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'test.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagegif.php' class='function'>imagegif()</a>, <a href='http://www.php.net/manual/pt_BR/function.imagewbmp.php' class='function'>imagewbmp()</a>, <a href='http://www.php.net/manual/pt_BR/function.imagejpeg.php' class='function'>imagejpeg()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagetypes.php' class='function'>imagetypes()</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="imagepalettecopy" value="<div id='function.imagepalettecopy' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagepalettecopy.php'>imagepalettecopy</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>imagepalettecopy</span> &amp;mdash; <span class='dc-title'>Copia a paleta de uma imagem para a outra</span></p> </div> <a name='function.imagepalettecopy.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>imagepalettecopy</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$destination</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$source</tt></span> )</div> <p class='para rdfs-comment'> <b>imagepalettecopy()</b> copia a paleta da imagem de <i><tt class='parameter'>source</tt></i> para a imagem <i><tt class='parameter'>destination</tt></i> . </p> </div> <a name='function.imagepalettecopy.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'>destination</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O resource da imagem de destino </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>source</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O resource do fonte da imagem </p> </dd> </dl> <p> </p> </div> <a name='function.imagepalettecopy.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> </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="imageloadfont" value="<div id='function.imageloadfont' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageloadfont.php'>imageloadfont</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imageloadfont</span> &amp;mdash; <span class='dc-title'>Carrega uma nova fonte</span></p> </div> <a name='function.imageloadfont.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>imageloadfont</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$file</tt></span> )</div> <p class='para rdfs-comment'> <b>imageloadfont()</b> carrega uma fonte bitmap do usu&amp;aacute;rio e retorna um identificador. </p> </div> <a name='function.imageloadfont.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'>file</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O formato do arquivo de fonte &amp;eacute; atualmente bin&amp;aacute;rio e dependente da arquitetura. Isto indica que voc&amp;ecirc; dever&amp;aacute; gerar os arquivos de fonte no mesmo tipo de CPU no qual esta executando o PHP. </p> <p class='para'> </p><table class='doctable table'> <caption><b>Formato do arquivo de fonte</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Posi&amp;ccedil;&amp;atilde;o do byte</th> <th>Tipo de dados C</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>byte 0-3</td> <td align='left'>int</td> <td align='left'>N&amp;uacute;mero de caracteres na fonte</td> </tr> <tr valign='middle'> <td align='left'>byte 4-7</td> <td align='left'>int</td> <td align='left'> Valor do primeiro caractere na fonte (normalmente 32 para o espa&amp;ccedil;o) </td> </tr> <tr valign='middle'> <td align='left'>byte 8-11</td> <td align='left'>int</td> <td align='left'>A largura em pixel de cada caractere</td> </tr> <tr valign='middle'> <td align='left'>byte 12-15</td> <td align='left'>int</td> <td align='left'>A altura em pixel de cada caractere</td> </tr> <tr valign='middle'> <td align='left'>byte 16-</td> <td align='left'>char</td> <td align='left'> Matriz com os dados dos caracteres, um byte por pixel em cada caractere para um total de (caracteres*largura*altura). </td> </tr> </tbody> </table> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.imageloadfont.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The font identifier which is always bigger than 5 to avoid conflicts with built-in fonts or <b><tt class='constant'>FALSE</tt></b> on errors. </p> </div> <a name='function.imageloadfont.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Usando imageloadfont</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>49</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>19</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imageloadfont</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'04b.gdf'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$font</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Hello'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imageloadfont.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.imagefontwidth.php' class='function' rel='rdfs-seeAlso'>imagefontwidth()</a> - Retorna a largura da fonte</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagefontheight.php' class='function' rel='rdfs-seeAlso'>imagefontheight()</a> - Retorna a altura da fonte</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="imageline" value="<div id='function.imageline' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageline.php'>imageline</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imageline</span> &amp;mdash; <span class='dc-title'>Desenha uma linha</span></p> </div> <a name='function.imageline.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>imageline</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imageline()</b> desenha uma linha de <i><tt class='parameter'>x1</tt></i> , <i><tt class='parameter'>y1</tt></i> at&amp;eacute; <i><tt class='parameter'>x2</tt></i> , <i><tt class='parameter'>y2</tt></i> (o canto superior esquerdo &amp;eacute; 0, 0) na imagem <i><tt class='parameter'>image</tt></i> de cor <i><tt class='parameter'>color</tt></i> . </p> <div class='example'> <p><b>Exemplo #1 Desenhando uma linha</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: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>imagelinethick</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$color</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$thick&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>)&amp;nbsp;<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;this&amp;nbsp;way&amp;nbsp;it&amp;nbsp;works&amp;nbsp;well&amp;nbsp;only&amp;nbsp;for&amp;nbsp;orthogonal&amp;nbsp;lines<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;imagesetthickness($image,&amp;nbsp;$thick);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;imageline($image,&amp;nbsp;$x1,&amp;nbsp;$y1,&amp;nbsp;$x2,&amp;nbsp;$y2,&amp;nbsp;$color);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>$thick&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;return&amp;nbsp;</span><span style='color: #0000BB'>imageline</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$color</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'>$t&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$thick&amp;nbsp;</span><span style='color: #007700'>/&amp;nbsp;</span><span style='color: #0000BB'>2&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>0.5</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if&amp;nbsp;(</span><span style='color: #0000BB'>$x1&amp;nbsp;</span><span style='color: #007700'>==&amp;nbsp;</span><span style='color: #0000BB'>$x2&amp;nbsp;</span><span style='color: #007700'>||&amp;nbsp;</span><span style='color: #0000BB'>$y1&amp;nbsp;</span><span style='color: #007700'>==&amp;nbsp;</span><span style='color: #0000BB'>$y2</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$x1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>$t</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>min</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$y1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>$t</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$x1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x2</span><span style='color: #007700'>)&amp;nbsp;+&amp;nbsp;</span><span style='color: #0000BB'>$t</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>max</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$y1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y2</span><span style='color: #007700'>)&amp;nbsp;+&amp;nbsp;</span><span style='color: #0000BB'>$t</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>$color</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'>$k&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;(</span><span style='color: #0000BB'>$y2&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$y1</span><span style='color: #007700'>)&amp;nbsp;/&amp;nbsp;(</span><span style='color: #0000BB'>$x2&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$x1</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//y&amp;nbsp;=&amp;nbsp;kx&amp;nbsp;+&amp;nbsp;q<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$a&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$t&amp;nbsp;</span><span style='color: #007700'>/&amp;nbsp;</span><span style='color: #0000BB'>sqrt</span><span style='color: #007700'>(</span><span style='color: #0000BB'>1&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;</span><span style='color: #0000BB'>pow</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>));<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$points&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$x1&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>+</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$y1&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>-</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</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'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$x1&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>-</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$y1&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>+</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</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'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$x2&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>+</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$y2&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>-</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</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'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$x2&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>-</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>),&amp;nbsp;</span><span style='color: #0000BB'>round</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$y2&amp;nbsp;</span><span style='color: #007700'>+&amp;nbsp;(</span><span style='color: #0000BB'>1</span><span style='color: #007700'>+</span><span style='color: #0000BB'>$k</span><span style='color: #007700'>)*</span><span style='color: #0000BB'>$a</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;</span><span style='color: #0000BB'>imagefilledpolygon</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$points</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$color</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>imagepolygon</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$points</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$color</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecreate.php' class='function'>imagecreate()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</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="imagelayereffect" value="<div id='function.imagelayereffect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagelayereffect.php'>imagelayereffect</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>imagelayereffect</span> &amp;mdash; <span class='dc-title'>Set the alpha blending flag to use the bundled libgd layering effects</span></p> </div> <a name='function.imagelayereffect.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>imagelayereffect</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$effect</tt></span> )</div> <p class='para rdfs-comment'> Set the alpha blending flag to use the bundled libgd layering effects. </p> </div> <a name='function.imagelayereffect.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>effect</tt></i> </span> </dt><dd class='listitem'> <p class='para'> One of the following constants: </p><dl> <dt class='varlistentry'> <br /><span class='term'><b><tt class='constant'>IMG_EFFECT_REPLACE</tt></b></span> </dt><dd class='listitem'> <span class='simpara'> Use pixel replacement (equivalent of passing <b><tt class='constant'>TRUE</tt></b> to <a href='http://www.php.net/manual/pt_BR/function.imagealphablending.php' class='function'>imagealphablending()</a>) </span> </dd> <dt class='varlistentry'> <span class='term'><b><tt class='constant'>IMG_EFFECT_ALPHABLEND</tt></b></span> </dt><dd class='listitem'> <span class='simpara'> Use normal pixel blending (equivalent of passing <b><tt class='constant'>FALSE</tt></b> to <a href='http://www.php.net/manual/pt_BR/function.imagealphablending.php' class='function'>imagealphablending()</a>) </span> </dd> <dt class='varlistentry'> <span class='term'><b><tt class='constant'>IMG_EFFECT_NORMAL</tt></b></span> </dt><dd class='listitem'> <span class='simpara'> Same as <b><tt class='constant'>IMG_EFFECT_ALPHABLEND</tt></b>. </span> </dd> <dt class='varlistentry'> <span class='term'><b><tt class='constant'>IMG_EFFECT_OVERLAY</tt></b></span> </dt><dd class='listitem'> <span class='simpara'> Overlay has the effect that black background pixels will remain black, white background pixels will remain white, but grey background pixels will take the colour of the foreground pixel. </span> </dd> </dl> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.imagelayereffect.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.imagelayereffect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 <b>imagelayereffect()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Setup&amp;nbsp;an&amp;nbsp;image<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;a&amp;nbsp;background<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>220</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>220</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>220</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Apply&amp;nbsp;the&amp;nbsp;overlay&amp;nbsp;alpha&amp;nbsp;blending&amp;nbsp;flag<br /></span><span style='color: #0000BB'>imagelayereffect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_EFFECT_OVERLAY</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Draw&amp;nbsp;two&amp;nbsp;grey&amp;nbsp;ellipses<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>40</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>40</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>80</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>80</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagelayereffect.png' /> </div> </div> </div> </div> <a name='function.imagelayereffect.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></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="imagejpeg" value="<div id='function.imagejpeg' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagejpeg.php'>imagejpeg</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagejpeg</span> &amp;mdash; <span class='dc-title'>Envia a imagem para o borwser ou arquivo</span></p> </div> <a name='function.imagejpeg.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>imagejpeg</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$quality</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>imagejpeg()</b> cria um arquivo <acronym title='Joint Photographic Experts Group'>JPEG</acronym> em a partir da <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagejpeg.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O caminho para salvar o arquivo. Se n&amp;atilde;o definido ou <b><tt class='constant'>NULL</tt></b>, o stream da imagem ser&amp;aacute; mostrado diretamente. </p> <p class='para'> Para pular este argumento para fornecer o par&amp;acirc;metro <i><tt class='parameter'>quality</tt></i> , use <b><tt class='constant'>NULL</tt></b>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>quality</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>quality</tt></i> &amp;eacute; opcional, e vai de 0 (pior qualidade, menor arquivo) a 100 (melhor qualidade, maior arquivo). O padr&amp;atilde;o &amp;eacute; a qualidade IJG (aproximadamente 75). </p> </dd> </dl> <p> </p> </div> <a name='function.imagejpeg.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.imagejpeg.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O suporte a JPEG esta dispon&amp;iacute;vel apenas se o PHP for compilado com GD-1.8 ou posterior.</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: Se voc&amp;ecirc; quiser criar JPEGs progressivos, voce precisa definir o interlace com a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.imageinterlace.php' class='function'>imageinterlace()</a>. <br /> </p></blockquote> </div> <a name='function.imagejpeg.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.imagepng.php' class='function' rel='rdfs-seeAlso'>imagepng()</a> - Envia uma imagem PNG para o browser ou para um arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagegif.php' class='function' rel='rdfs-seeAlso'>imagegif()</a> - Envia uma imagem para o browser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagewbmp.php' class='function' rel='rdfs-seeAlso'>imagewbmp()</a> - Envia uma imagem para o browser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imageinterlace.php' class='function' rel='rdfs-seeAlso'>imageinterlace()</a> - Ativa ou desativa o entrela&amp;ccedil;amento</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagetypes.php' class='function' rel='rdfs-seeAlso'>imagetypes()</a> - Retorna os tipos de imagens suportados por esta instala&amp;ccedil;&amp;atilde;o do PHP</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="imageistruecolor" value="<div id='function.imageistruecolor' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageistruecolor.php'>imageistruecolor</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.2, PHP 5)</p><p class='refpurpose'><span class='refname'>imageistruecolor</span> &amp;mdash; <span class='dc-title'>Indica quando uma imagem &amp;eacute; uma imagem truecolor</span></p> </div> <a name='function.imageistruecolor.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>imageistruecolor</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> )</div> <p class='para rdfs-comment'> <b>imageistruecolor()</b> indica quando a imagem <i><tt class='parameter'>image</tt></i> &amp;eacute; uma imagem truecolor. </p> </div> <a name='function.imageistruecolor.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.imageistruecolor.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna <b><tt class='constant'>TRUE</tt></b> se o <i><tt class='parameter'>image</tt></i> &amp;eacute; truecolor, <b><tt class='constant'>FALSE</tt></b> caso contr&amp;aacute;rio. </p> </div> <a name='function.imageistruecolor.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> </div> <a name='function.imageistruecolor.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.imagecreatetruecolor.php' class='function' rel='rdfs-seeAlso'>imagecreatetruecolor()</a> - Cria uma nova imagem true color</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="imageinterlace" value="<div id='function.imageinterlace' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageinterlace.php'>imageinterlace</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imageinterlace</span> &amp;mdash; <span class='dc-title'>Ativa ou desativa o entrela&amp;ccedil;amento</span></p> </div> <a name='function.imageinterlace.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>imageinterlace</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$interlace</tt></span> ] )</div> <p class='para rdfs-comment'> <b>imageinterlace()</b> muda o bit de entrela&amp;ccedil;amento para on ou off. </p> <p class='para'> Se o bit de entrelace for definido e a imagem usada for uma imagem JPEG, a imagem ser&amp;aacute; criada como um JPEG progressivo. </p> </div> <a name='function.imageinterlace.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>interlace</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se diferente de zero, a imagem ser&amp;aacute; entrela&amp;ccedil;ada, ent&amp;atilde;o o bit de entrelace &amp;eacute; desativado. </p> </dd> </dl> <p> </p> </div> <a name='function.imageinterlace.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna 1 se o bit de entrelace &amp;eacute; definido para a imagem, 0 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="imagegrabwindow" value="<div id='function.imagegrabwindow' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagegrabwindow.php'>imagegrabwindow</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.2)</p><p class='refpurpose'><span class='refname'>imagegrabwindow</span> &amp;mdash; <span class='dc-title'>Captures a window</span></p> </div> <a name='function.imagegrabwindow.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>imagegrabwindow</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$window</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$client_area</tt><span class='initializer'> = 0</span></span> ] )</div> <p class='para rdfs-comment'> Grabs a window or its client area using a windows handle (HWND property in COM instance) </p> </div> <a name='function.imagegrabwindow.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'>window</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The HWND window ID. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>client_area</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Include the client area of the application window. </p> </dd> </dl> <p> </p> </div> <a name='function.imagegrabwindow.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an image resource identifier on success, <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.imagegrabwindow.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> E_NOTICE is issued if <i><tt class='parameter'>window_handle</tt></i> is invalid window handle. E_WARNING is issued if the Windows API is too old. </p> </div> <a name='function.imagegrabwindow.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagegrabwindow()</b> example</b></p> <div class='example-contents para'><p> Capture a window (IE for example) </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$browser&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>COM</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'InternetExplorer.Application'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$handle&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>HWND</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Visible&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagegrabwindow</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$handle</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Quit</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'iesnap.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> Capture a window (IE for example) but with its content </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$browser&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>COM</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'InternetExplorer.Application'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$handle&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>HWND</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Visible&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Navigate</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'http://www.libgd.org'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Still&amp;nbsp;working?&amp;nbsp;*/<br /></span><span style='color: #007700'>while&amp;nbsp;(</span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Busy</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>com_message_pump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>4000</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagegrabwindow</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$handle</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$browser</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>Quit</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'iesnap.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagegrabwindow.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function is only available on Windows. <br /> </p></blockquote> </div> <a name='function.imagegrabwindow.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.imagegrabscreen.php' class='function' rel='rdfs-seeAlso'>imagegrabscreen()</a> - Captures the whole screen</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="imagegrabscreen" value="<div id='function.imagegrabscreen' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagegrabscreen.php'>imagegrabscreen</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.2.2)</p><p class='refpurpose'><span class='refname'>imagegrabscreen</span> &amp;mdash; <span class='dc-title'>Captures the whole screen</span></p> </div> <a name='function.imagegrabscreen.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>imagegrabscreen</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> Grabs a screenshot of the whole screen. </p> </div> <a name='function.imagegrabscreen.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an image resource identifier on success, <b><tt class='constant'>FALSE</tt></b> on failure. </p> </div> <a name='function.imagegrabscreen.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagegrabscreen()</b> example</b></p> <div class='example-contents para'><p> This example demonstrates how to take a screenshot of the current screen and save it as a png image. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagegrabscreen</span><span style='color: #007700'>();<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'myscreenshot.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagegrabscreen.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: This function is only available on Windows. <br /> </p></blockquote> </div> <a name='function.imagegrabscreen.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.imagegrabwindow.php' class='function' rel='rdfs-seeAlso'>imagegrabwindow()</a> - Captures a window</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="imagegif" value="<div id='function.imagegif' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagegif.php'>imagegif</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagegif</span> &amp;mdash; <span class='dc-title'>Envia uma imagem para o browser ou arquivo</span></p> </div> <a name='function.imagegif.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>imagegif</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> ] )</div> <p class='para rdfs-comment'> <b>imagegif()</b> cria um arquivo <acronym title='Graphic Interchange Format'>GIF</acronym> em <i><tt class='parameter'>filename</tt></i> a partir da imagem <i><tt class='parameter'>image</tt></i> . O par&amp;acirc;metro <i><tt class='parameter'>image</tt></i> &amp;eacute; o retorno da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.imagecreate.php' class='function'>imagecreate()</a> ou <i>imagecreatefrom*</i>. </p> <p class='para'> O formato da imagem ser&amp;aacute; <acronym>GIF87a</acronym> a menos que a imagem tenha sido feita transparente com <a href='http://www.php.net/manual/pt_BR/function.imagecolortransparent.php' class='function'>imagecolortransparent()</a>, neste caso o formato da imagem ser&amp;aacute; <acronym>GIF89a</acronym>. </p> </div> <a name='function.imagegif.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O caminho para salvar o arquivo. Se n&amp;atilde;o definido ou <b><tt class='constant'>NULL</tt></b>, o stream da imagem ser&amp;aacute; mostrado diretamente. </p> </dd> </dl> <p> </p> </div> <a name='function.imagegif.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.imagegif.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: J&amp;aacute; que todo o suporte <acronym title='Graphic Interchange Format'>GIF</acronym> foi removido da biblioteca <acronym title='Graphics Draw'>GD</acronym> na vers&amp;atilde;o 1.6, esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o esta dispon&amp;iacute;vel se voc&amp;ecirc; esta usando esta vers&amp;atilde;o da biblioteca GD. O suporte &amp;eacute; esperado para retornar em uma vers&amp;atilde;o subsequente ao lan&amp;ccedil;amento do suporte <acronym title='Graphic Interchange Format'>GIF</acronym> na biblioteca GD no meio de 2004. Para maiores informa&amp;ccedil;&amp;otilde;es veja o site do projeto <a href='http://www.libgd.org/' class='link external'>&amp;raquo; GD Project</a>. <br /> O seguinte peda&amp;ccedil;o de c&amp;oacute;digo permite a voc&amp;ecirc; criar aplica&amp;ccedil;&amp;otilde;es PHP mais port&amp;aacute;veis auto-detectando o tipo de suporte GD que esta dispon&amp;iacute;vel. Substitua a sequencia <i>header (&amp;quot;Content-type: image/gif&amp;quot;); imagegif ($im);</i> por uma sequencia mais flex&amp;iacute;vel: </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 /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>function_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'imagegif'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/gif'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagegif</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}&amp;nbsp;elseif&amp;nbsp;(</span><span style='color: #0000BB'>function_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'imagejpeg'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0.5</span><span style='color: #007700'>);<br />}&amp;nbsp;elseif&amp;nbsp;(</span><span style='color: #0000BB'>function_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'imagepng'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}&amp;nbsp;elseif&amp;nbsp;(</span><span style='color: #0000BB'>function_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'imagewbmp'</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/vnd.wap.wbmp'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagewbmp</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;die(</span><span style='color: #DD0000'>'No&amp;nbsp;image&amp;nbsp;support&amp;nbsp;in&amp;nbsp;this&amp;nbsp;PHP&amp;nbsp;server'</span><span style='color: #007700'>);<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: A partir das vers&amp;otilde;es 3.0.18 e 4.0.2 voc&amp;ecirc; pode usar a fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.imagetypes.php' class='function'>imagetypes()</a> no lugar de <a href='http://www.php.net/manual/pt_BR/function.function-exists.php' class='function'>function_exists()</a> para conferir a presen&amp;ccedil;a dos v&amp;aacute;rios formatos de imagem suportados: </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 /></span><span style='color: #007700'>if&amp;nbsp;(</span><span style='color: #0000BB'>imagetypes</span><span style='color: #007700'>()&amp;nbsp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>IMG_GIF</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/gif'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagegif&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}&amp;nbsp;elseif&amp;nbsp;(</span><span style='color: #0000BB'>imagetypes</span><span style='color: #007700'>()&amp;nbsp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>IMG_JPG</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;...&amp;nbsp;etc.&amp;nbsp;*/<br /></span><span style='color: #007700'>}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> <br /> </p></blockquote> </div> <a name='function.imagegif.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.imagepng.php' class='function' rel='rdfs-seeAlso'>imagepng()</a> - Envia uma imagem PNG para o browser ou para um arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagewbmp.php' class='function' rel='rdfs-seeAlso'>imagewbmp()</a> - Envia uma imagem para o browser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagejpeg.php' class='function' rel='rdfs-seeAlso'>imagejpeg()</a> - Envia a imagem para o borwser ou arquivo</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagetypes.php' class='function' rel='rdfs-seeAlso'>imagetypes()</a> - Retorna os tipos de imagens suportados por esta instala&amp;ccedil;&amp;atilde;o do PHP</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="imagegd2" value="<div id='function.imagegd2' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagegd2.php'>imagegd2</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imagegd2</span> &amp;mdash; <span class='dc-title'>Envia uma imagem GD2</span></p> </div> <a name='function.imagegd2.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>imagegd2</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$chunk_size</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$type</tt></span> ]]] )</div> <p class='para rdfs-comment'> <b>imagegd2()</b> envia uma imagem GD2 para o browser ou um arquivo. </p> <p class='para'> O par&amp;acirc;metro opcional <i><tt class='parameter'>type</tt></i> pode ser <b><tt class='constant'>IMG_GD2_RAW</tt></b> ou <b><tt class='constant'>IMG_GD2_COMPRESSED</tt></b>. O padr&amp;atilde;o &amp;eacute; <b><tt class='constant'>IMG_GD2_RAW</tt></b>. </p> <blockquote><p><b class='note'>Nota</b>: Os par&amp;acirc;metros opcionais <i><tt class='parameter'>chunk_size</tt></i> e <i><tt class='parameter'>type</tt></i> tornaram-se dispon&amp;iacute;veis no PHP 4.3.2. <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="imagegd" value="<div id='function.imagegd' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagegd.php'>imagegd</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imagegd</span> &amp;mdash; <span class='dc-title'>Envia a imagem GD para o browser ou um arquivo</span></p> </div> <a name='function.imagegd.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>imagegd</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> ] )</div> <p class='para rdfs-comment'> <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> </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="imagegammacorrect" value="<div id='function.imagegammacorrect' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagegammacorrect.php'>imagegammacorrect</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagegammacorrect</span> &amp;mdash; <span class='dc-title'>Apply a gamma correction to a GD image</span></p> </div> <a name='function.imagegammacorrect.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>imagegammacorrect</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$inputgamma</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$outputgamma</tt></span> )</div> <p class='para rdfs-comment'> Applies gamma correction to the given gd <i><tt class='parameter'>image</tt></i> given an input and an output gamma. </p> </div> <a name='function.imagegammacorrect.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>inputgamma</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The input gamma. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>outputgamma</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The output gamma. </p> </dd> </dl> <p> </p> </div> <a name='function.imagegammacorrect.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.imagegammacorrect.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagegammacorrect()</b> usage</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;Create&amp;nbsp;image&amp;nbsp;instance<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromgif</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'php.gif'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Correct&amp;nbsp;gamma,&amp;nbsp;out&amp;nbsp;=&amp;nbsp;1.537<br /></span><span style='color: #0000BB'>imagegammacorrect</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1.537</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Save&amp;nbsp;and&amp;nbsp;free&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagegif</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'./php_gamma_corrected.gif'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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="imagefttext" value="<div id='function.imagefttext' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefttext.php'>imagefttext</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefttext</span> &amp;mdash; <span class='dc-title'>Escreve texto na imagem usando fontes FreeType 2</span></p> </div> <a name='function.imagefttext.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>imagefttext</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$size</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$col</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$font_file</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$extrainfo</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> <a name='function.imagefttext.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>size</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>angle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>col</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>font_file</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>extrainfo</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagefttext.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Esta fun&amp;ccedil;&amp;atilde;o retorna um array contendo os seguintes elementos: </p><table class='doctable informaltable'> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>coordenada x inferior &amp;agrave; esquerda</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>coordenada y inferior &amp;agrave; esquerda</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>coordenada x inferior &amp;agrave; direita</td> </tr> <tr valign='middle'> <td align='left'>3</td> <td align='left'>coordenada y inferior &amp;agrave; direita</td> </tr> <tr valign='middle'> <td align='left'>4</td> <td align='left'>coordenada x superior &amp;agrave; direita</td> </tr> <tr valign='middle'> <td align='left'>5</td> <td align='left'>coordenada y superior &amp;agrave; direita</td> </tr> <tr valign='middle'> <td align='left'>6</td> <td align='left'>coordenada x superior &amp;agrave; esquerda</td> </tr> <tr valign='middle'> <td align='left'>7</td> <td align='left'>coordenada y superior &amp;agrave; esquerda</td> </tr> </tbody> </table> <p> </p> </div> <a name='function.imagefttext.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o esta dispon&amp;iacute;vel apenas se o PHP for compilado com suporte a freetype (<span class='option'>--with-freetype-dir=DIR</span>) </span></p></blockquote> </div> <a name='function.imagefttext.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.5</td> <td align='left'> <i><tt class='parameter'>extrainfo</tt></i> tornou-se opcional. </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="imageftbbox" value="<div id='function.imageftbbox' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageftbbox.php'>imageftbbox</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imageftbbox</span> &amp;mdash; <span class='dc-title'>Give the bounding box of a text using fonts via freetype2</span></p> </div> <a name='function.imageftbbox.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>imageftbbox</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$size</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$angle</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$fontfile</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$text</tt></span> [, <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$extrainfo</tt></span> ] )</div> <p class='para rdfs-comment'> This function calculates and returns the bounding box in pixels for a FreeType text. </p> </div> <a name='function.imageftbbox.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'>size</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The font size. Depending on your version of GD, this should be specified as the pixel size (GD1) or point size (GD2). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>angle</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Angle in degrees in which <i><tt class='parameter'>text</tt></i> will be measured. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>fontfile</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The name of the TrueType font file (can be a URL). Depending on which version of the GD library that PHP is using, it may attempt to search for files that do not begin with a leading &amp;#039;/&amp;#039; by appending &amp;#039;.ttf&amp;#039; to the filename and searching along a library-defined font path. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The string to be measured. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>extrainfo</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><table class='doctable table'> <caption><b>Possible array indexes for <i><tt class='parameter'>extrainfo</tt></i> </b></caption> <thead valign='middle'> <tr valign='middle'> <th>Key</th> <th>Type</th> <th>Meaning</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><i>linespacing</i></td> <td align='left'><a href='http://www.php.net/manual/pt_BR/language.types.float.php' class='type float'>float</a></td> <td align='left'>Defines drawing linespacing</td> </tr> </tbody> </table> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.imageftbbox.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>imageftbbox()</b> returns an array with 8 elements representing four points making the bounding box of the text: </p><table class='doctable informaltable'> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>0</td> <td align='left'>lower left corner, X position</td> </tr> <tr valign='middle'> <td align='left'>1</td> <td align='left'>lower left corner, Y position</td> </tr> <tr valign='middle'> <td align='left'>2</td> <td align='left'>lower right corner, X position</td> </tr> <tr valign='middle'> <td align='left'>3</td> <td align='left'>lower right corner, Y position</td> </tr> <tr valign='middle'> <td align='left'>4</td> <td align='left'>upper right corner, X position</td> </tr> <tr valign='middle'> <td align='left'>5</td> <td align='left'>upper right corner, Y position</td> </tr> <tr valign='middle'> <td align='left'>6</td> <td align='left'>upper left corner, X position</td> </tr> <tr valign='middle'> <td align='left'>7</td> <td align='left'>upper left corner, Y position</td> </tr> </tbody> </table> <p> </p> <p class='para'> The points are relative to the <em class='emphasis'>text</em> regardless of the <i><tt class='parameter'>angle</tt></i> , so &amp;quot;upper left&amp;quot; means in the top left-hand corner seeing the text horizontally. </p> </div> <a name='function.imageftbbox.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imageftbbox()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;300x150&amp;nbsp;image<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;the&amp;nbsp;background&amp;nbsp;to&amp;nbsp;be&amp;nbsp;white<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>299</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>299</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Path&amp;nbsp;to&amp;nbsp;our&amp;nbsp;font&amp;nbsp;file<br /></span><span style='color: #0000BB'>$font&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'./arial.ttf'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;First&amp;nbsp;we&amp;nbsp;create&amp;nbsp;our&amp;nbsp;bounding&amp;nbsp;box<br /></span><span style='color: #0000BB'>$bbox&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imageftbbox</span><span style='color: #007700'>(</span><span style='color: #0000BB'>10</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'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'The&amp;nbsp;PHP&amp;nbsp;Documentation&amp;nbsp;Group'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;This&amp;nbsp;is&amp;nbsp;our&amp;nbsp;cordinates&amp;nbsp;for&amp;nbsp;X&amp;nbsp;and&amp;nbsp;Y<br /></span><span style='color: #0000BB'>$x&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$bbox</span><span style='color: #007700'>[</span><span style='color: #0000BB'>0</span><span style='color: #007700'>]&amp;nbsp;+&amp;nbsp;(</span><span style='color: #0000BB'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)&amp;nbsp;/&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;(</span><span style='color: #0000BB'>$bbox</span><span style='color: #007700'>[</span><span style='color: #0000BB'>4</span><span style='color: #007700'>]&amp;nbsp;/&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$y&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$bbox</span><span style='color: #007700'>[</span><span style='color: #0000BB'>1</span><span style='color: #007700'>]&amp;nbsp;+&amp;nbsp;(</span><span style='color: #0000BB'>imagesy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)&amp;nbsp;/&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;(</span><span style='color: #0000BB'>$bbox</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'>2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>imagefttext</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</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'>$x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$font</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'The&amp;nbsp;PHP&amp;nbsp;Documentation&amp;nbsp;Group'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;to&amp;nbsp;browser<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imageftbbox.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o esta dispon&amp;iacute;vel apenas se o PHP for compilado com suporte a freetype (<span class='option'>--with-freetype-dir=DIR</span>) </span></p></blockquote> </div> <a name='function.imageftbbox.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.5</td> <td align='left'> <i><tt class='parameter'>extrainfo</tt></i> was made optional. </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="imagefontwidth" value="<div id='function.imagefontwidth' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefontwidth.php'>imagefontwidth</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefontwidth</span> &amp;mdash; <span class='dc-title'>Retorna a largura da fonte</span></p> </div> <a name='function.imagefontwidth.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>imagefontwidth</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$font</tt></span> )</div> <p class='para rdfs-comment'> Retorna a largura em pixel de um caractere da fonte. </p> </div> <a name='function.imagefontwidth.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'> font</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Pode ser 1, 2, 3, 4, 5 para as fontes embutidas na codifica&amp;ccedil;&amp;atilde;o latin2 (aonde n&amp;uacute;meros maiores correspondem a fontes mais largas) ou qualquer um dos seus pr&amp;oacute;pios identificadores de fonte registrado com <a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function'>imageloadfont()</a>. </p></dd> </dl> <p> </p> </div> <a name='function.imagefontwidth.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a largura do pixel. </p> </div> <a name='function.imagefontwidth.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.imagefontheight.php' class='function' rel='rdfs-seeAlso'>imagefontheight()</a> - Retorna a altura da fonte</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function' rel='rdfs-seeAlso'>imageloadfont()</a> - Carrega uma nova fonte</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="imagefontheight" value="<div id='function.imagefontheight' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefontheight.php'>imagefontheight</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefontheight</span> &amp;mdash; <span class='dc-title'>Retorna a altura da fonte</span></p> </div> <a name='function.imagefontheight.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>imagefontheight</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$font</tt></span> )</div> <p class='para rdfs-comment'> Retorna a altura em pixel de um caractere na fonte especificada. </p> </div> <a name='function.imagefontheight.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'> font</tt></i> </span> </dt><dd class='listitem'> <p class='para'>Pode ser 1, 2, 3, 4, 5 para as fontes embutidas na codifica&amp;ccedil;&amp;atilde;o latin2 (aonde n&amp;uacute;meros maiores correspondem a fontes mais largas) ou qualquer um dos seus pr&amp;oacute;pios identificadores de fonte registrado com <a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function'>imageloadfont()</a>. </p></dd> </dl> <p> </p> </div> <a name='function.imagefontheight.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a altura do pixel. </p> </div> <a name='function.imagefontheight.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.imagefontwidth.php' class='function' rel='rdfs-seeAlso'>imagefontwidth()</a> - Retorna a largura da fonte</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function' rel='rdfs-seeAlso'>imageloadfont()</a> - Carrega uma nova fonte</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="imagefilter" value="<div id='function.imagefilter' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefilter.php'>imagefilter</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>imagefilter</span> &amp;mdash; <span class='dc-title'>Applies a filter to an image</span></p> </div> <a name='function.imagefilter.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>imagefilter</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$filtertype</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$arg1</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$arg2</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$arg3</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$arg4</tt></span> ]]]] )</div> <p class='para rdfs-comment'> <b>imagefilter()</b> applies the given filter <i><tt class='parameter'>filtertype</tt></i> on the <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagefilter.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filtertype</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <i><tt class='parameter'>filtertype</tt></i> can be one of the following: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_NEGATE</tt></b>: Reverses all colors of the image. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_GRAYSCALE</tt></b>: Converts the image into grayscale. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_BRIGHTNESS</tt></b>: Changes the brightness of the image. Use <i><tt class='parameter'>arg1</tt></i> to set the level of brightness. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_CONTRAST</tt></b>: Changes the contrast of the image. Use <i><tt class='parameter'>arg1</tt></i> to set the level of contrast. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_COLORIZE</tt></b>: Like <b><tt class='constant'>IMG_FILTER_GRAYSCALE</tt></b>, except you can specify the color. Use <i><tt class='parameter'>arg1</tt></i> , <i><tt class='parameter'>arg2</tt></i> and <i><tt class='parameter'>arg3</tt></i> in the form of <i><tt class='parameter'>red</tt></i> , <i><tt class='parameter'>blue</tt></i> , <i><tt class='parameter'>green</tt></i> and <i><tt class='parameter'>arg4</tt></i> for the <i><tt class='parameter'>alpha</tt></i> channel. The range for each color is 0 to 255. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_EDGEDETECT</tt></b>: Uses edge detection to highlight the edges in the image. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_EMBOSS</tt></b>: Embosses the image. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_GAUSSIAN_BLUR</tt></b>: Blurs the image using the Gaussian method. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_SELECTIVE_BLUR</tt></b>: Blurs the image. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_MEAN_REMOVAL</tt></b>: Uses mean removal to achieve a &amp;quot;sketchy&amp;quot; effect. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_SMOOTH</tt></b>: Makes the image smoother. Use <i><tt class='parameter'>arg1</tt></i> to set the level of smoothness. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_PIXELATE</tt></b>: Applies pixelation effect to the image, use <i><tt class='parameter'>arg1</tt></i> to set the block size and <i><tt class='parameter'>arg2</tt></i> to set the pixelation effect mode. </span> </li> </ul><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>arg1</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_BRIGHTNESS</tt></b>: Brightness level. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_CONTRAST</tt></b>: Contrast level. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_COLORIZE</tt></b>: Value of red component. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_SMOOTH</tt></b>: Smoothness level. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_PIXELATE</tt></b>: Block size in pixels. </span> </li> </ul><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>arg2</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_COLORIZE</tt></b>: Value of green component. </span> </li> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_PIXELATE</tt></b>: Whether to use advanced pixelation effect or not (defaults to <b><tt class='constant'>FALSE</tt></b>). </span> </li> </ul><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>arg3</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_COLORIZE</tt></b>: Value of blue component. </span> </li> </ul><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>arg4</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> <b><tt class='constant'>IMG_FILTER_COLORIZE</tt></b>: Alpha channel, A value between 0 and 127. 0 indicates completely opaque while 127 indicates completely transparent. </span> </li> </ul><p> </p> </dd> </dl> <p> </p> </div> <a name='function.imagefilter.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.imagefilter.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.3.0</td> <td align='left'> Pixelation support (<b><tt class='constant'>IMG_FILTER_PIXELATE</tt></b>) was added. </td> </tr> <tr valign='middle'> <td align='left'>5.2.5</td> <td align='left'> Alpha support for <b><tt class='constant'>IMG_FILTER_COLORIZE</tt></b> was added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.imagefilter.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagefilter()</b> grayscale example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'dave.png'</span><span style='color: #007700'>);<br /><br />if(</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>&amp;amp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilter</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_FILTER_GRAYSCALE</span><span style='color: #007700'>))<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Image&amp;nbsp;converted&amp;nbsp;to&amp;nbsp;grayscale.'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'dave.png'</span><span style='color: #007700'>);<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Conversion&amp;nbsp;to&amp;nbsp;grayscale&amp;nbsp;failed.'</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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 <b>imagefilter()</b> brightness example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'sean.png'</span><span style='color: #007700'>);<br /><br />if(</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>&amp;amp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilter</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_FILTER_BRIGHTNESS</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>))<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Image&amp;nbsp;brightness&amp;nbsp;changed.'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'sean.png'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Image&amp;nbsp;brightness&amp;nbsp;change&amp;nbsp;failed.'</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'> </p><div class='example'> <p><b>Exemplo #3 <b>imagefilter()</b> colorize example</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'philip.png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;R,&amp;nbsp;G,&amp;nbsp;B,&amp;nbsp;so&amp;nbsp;0,&amp;nbsp;255,&amp;nbsp;0&amp;nbsp;is&amp;nbsp;green&amp;nbsp;*/<br /></span><span style='color: #007700'>if(</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>&amp;amp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilter</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_FILTER_COLORIZE</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'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>))<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Image&amp;nbsp;successfully&amp;nbsp;shaded&amp;nbsp;green.'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'philip.png'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Green&amp;nbsp;shading&amp;nbsp;failed.'</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'> </p><div class='example'> <p><b>Exemplo #4 <b>imagefilter()</b> negate example</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;Define&amp;nbsp;our&amp;nbsp;negate&amp;nbsp;function&amp;nbsp;so&amp;nbsp;its&amp;nbsp;portable&amp;nbsp;for&amp;nbsp;<br />//&amp;nbsp;php&amp;nbsp;versions&amp;nbsp;without&amp;nbsp;imagefilter()<br /></span><span style='color: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>negate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if(</span><span style='color: #0000BB'>function_exists</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'imagefilter'</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;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>imagefilter</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_FILTER_NEGATE</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;for(</span><span style='color: #0000BB'>$x&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'>$x&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);&amp;nbsp;++</span><span style='color: #0000BB'>$x</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;&amp;nbsp;for(</span><span style='color: #0000BB'>$y&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'>$y&amp;nbsp;</span><span style='color: #007700'>&amp;lt;&amp;nbsp;</span><span style='color: #0000BB'>imagesy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);&amp;nbsp;++</span><span style='color: #0000BB'>$y</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$index&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorat</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y</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;</span><span style='color: #0000BB'>$rgb&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorsforindex</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$index</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;</span><span style='color: #0000BB'>$color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$rgb</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'red'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>255&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$rgb</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'green'</span><span style='color: #007700'>],&amp;nbsp;</span><span style='color: #0000BB'>255&amp;nbsp;</span><span style='color: #007700'>-&amp;nbsp;</span><span style='color: #0000BB'>$rgb</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'blue'</span><span style='color: #007700'>]);<br /><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;</span><span style='color: #0000BB'>imagesetpixel</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$y</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$color</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;}<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return(</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromjpeg</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'kalle.jpg'</span><span style='color: #007700'>);<br /><br />if(</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>&amp;amp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>negate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>))<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Image&amp;nbsp;successfully&amp;nbsp;converted&amp;nbsp;to&amp;nbsp;negative&amp;nbsp;colors.'</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'kalle.jpg'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br />}<br />else<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Converting&amp;nbsp;to&amp;nbsp;negative&amp;nbsp;colors&amp;nbsp;failed.'</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'> </p><div class='example'> <p><b>Exemplo #5 <b>imagefilter()</b> pixelate example</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;Load&amp;nbsp;the&amp;nbsp;PHP&amp;nbsp;logo,&amp;nbsp;we&amp;nbsp;need&amp;nbsp;to&amp;nbsp;create&amp;nbsp;two&amp;nbsp;instances&amp;nbsp;<br />//&amp;nbsp;to&amp;nbsp;show&amp;nbsp;the&amp;nbsp;differences<br /></span><span style='color: #0000BB'>$logo1&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./php.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$logo2&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'./php.png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;the&amp;nbsp;image&amp;nbsp;instance&amp;nbsp;we&amp;nbsp;want&amp;nbsp;to&amp;nbsp;show&amp;nbsp;the&amp;nbsp;<br />//&amp;nbsp;differences&amp;nbsp;on<br /></span><span style='color: #0000BB'>$output&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo1</span><span style='color: #007700'>)&amp;nbsp;*&amp;nbsp;</span><span style='color: #0000BB'>2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagesy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo1</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Apply&amp;nbsp;pixelation&amp;nbsp;to&amp;nbsp;each&amp;nbsp;instance,&amp;nbsp;with&amp;nbsp;a&amp;nbsp;block&amp;nbsp;<br />//&amp;nbsp;size&amp;nbsp;of&amp;nbsp;3<br /></span><span style='color: #0000BB'>imagefilter</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_FILTER_PIXELATE</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilter</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_FILTER_PIXELATE</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Merge&amp;nbsp;the&amp;nbsp;differences&amp;nbsp;onto&amp;nbsp;the&amp;nbsp;output&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagecopy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$output</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$logo1</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'>0</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo1</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagesy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo1</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagecopy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$output</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$logo2</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo2</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'>0</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'>imagesx</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagesy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo2</span><span style='color: #007700'>)&amp;nbsp;-&amp;nbsp;</span><span style='color: #0000BB'>1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo1</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$logo2</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;the&amp;nbsp;differences<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$output</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$output</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagefilterpixelate.png' /> </div> </div> </div><p> </p> </div> <a name='function.imagefilter.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></p></blockquote> </div> <a name='function.imagefilter.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.imageconvolution.php' class='function' rel='rdfs-seeAlso'>imageconvolution()</a> - Apply a 3x3 convolution matrix, using coefficient and offset</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="imagefilltoborder" value="<div id='function.imagefilltoborder' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefilltoborder.php'>imagefilltoborder</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefilltoborder</span> &amp;mdash; <span class='dc-title'>Flood fill to specific color</span></p> </div> <a name='function.imagefilltoborder.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>imagefilltoborder</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$border</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagefilltoborder()</b> performs a flood fill whose border color is defined by <i><tt class='parameter'>border</tt></i> . The starting point for the fill is <i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> (top left is 0, 0) and the region is filled with color <i><tt class='parameter'>color</tt></i> . </p> </div> <a name='function.imagefilltoborder.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of start. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of start. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>border</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The border color. A color identifier created with <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>color</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The fill color. A color identifier created with <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.imagefilltoborder.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.imagefilltoborder.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Filling an ellipse with a color</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;Create&amp;nbsp;the&amp;nbsp;image&amp;nbsp;handle,&amp;nbsp;set&amp;nbsp;the&amp;nbsp;background&amp;nbsp;to&amp;nbsp;white<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Draw&amp;nbsp;an&amp;nbsp;ellipse&amp;nbsp;to&amp;nbsp;fill&amp;nbsp;with&amp;nbsp;a&amp;nbsp;black&amp;nbsp;border<br /></span><span style='color: #0000BB'>imageellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;the&amp;nbsp;border&amp;nbsp;and&amp;nbsp;fill&amp;nbsp;colors<br /></span><span style='color: #0000BB'>$border&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$fill&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Fill&amp;nbsp;the&amp;nbsp;selection<br /></span><span style='color: #0000BB'>imagefilltoborder</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$border</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$fill</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;and&amp;nbsp;free&amp;nbsp;memory<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagefilltoborder.png' /> </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="imagefilledrectangle" value="<div id='function.imagefilledrectangle' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefilledrectangle.php'>imagefilledrectangle</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefilledrectangle</span> &amp;mdash; <span class='dc-title'>Desenha um ret&amp;acirc;ngulo prenchido</span></p> </div> <a name='function.imagefilledrectangle.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>imagefilledrectangle</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagefilledrectangle()</b> cria um ret&amp;acirc;ngulo prenchido da cor <i><tt class='parameter'>color</tt></i> na imagem <i><tt class='parameter'>image</tt></i> come&amp;ccedil;ando nas coordenadas de cima aesquerda <i><tt class='parameter'>x1</tt></i> , <i><tt class='parameter'>y1</tt></i> e terminando nas coordenadas de baixo a direita <i><tt class='parameter'>x2</tt></i> , <i><tt class='parameter'>y2</tt></i> . 0, 0 &amp;eacute; o canto superior esquerdo da imagem. </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="imagefilledpolygon" value="<div id='function.imagefilledpolygon' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefilledpolygon.php'>imagefilledpolygon</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefilledpolygon</span> &amp;mdash; <span class='dc-title'>Desenha um poligono prenchido</span></p> </div> <a name='function.imagefilledpolygon.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>imagefilledpolygon</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$points</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$num_points</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagefilledpolygon()</b> cria um poligono prenchido na imagem <i><tt class='parameter'>image</tt></i> . <i><tt class='parameter'>points</tt></i> &amp;eacute; uma matriz PHP contendo os vertives do poligono, ex. points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. <i><tt class='parameter'>num_points</tt></i> &amp;eacute; o n&amp;uacute;mero total de vertices. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagefilledpolygon()</b></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;este&amp;nbsp;exemplo&amp;nbsp;foi&amp;nbsp;dado&amp;nbsp;por&amp;nbsp;ecofarm&amp;nbsp;at&amp;nbsp;mullum&amp;nbsp;dot&amp;nbsp;com&amp;nbsp;dot&amp;nbsp;au<br /><br />//&amp;nbsp;define&amp;nbsp;uma&amp;nbsp;matriz&amp;nbsp;de&amp;nbsp;pontos&amp;nbsp;para&amp;nbsp;o&amp;nbsp;poligono<br /></span><span style='color: #0000BB'>$values&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>0&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>40</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;x1<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>1&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;y1<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>2&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;x2<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>3&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>240</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;y2<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>4&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>60</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;x3<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>5&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>60</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;y3<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>6&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>240</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;x4<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>7&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;y4<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>8&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;x5<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>9&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>40</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;y5<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>10&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;x6<br />&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>11&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;y6<br /></span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;cria&amp;nbsp;a&amp;nbsp;imagem<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>250</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>250</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;algumas&amp;nbsp;cores<br /></span><span style='color: #0000BB'>$bg&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$blue&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;desenha&amp;nbsp;um&amp;nbsp;poligono<br /></span><span style='color: #0000BB'>imagefilledpolygon</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$values</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>6</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$blue&amp;nbsp;</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;envia&amp;nbsp;a&amp;nbsp;imagem<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /><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="imagefilledellipse" value="<div id='function.imagefilledellipse' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefilledellipse.php'>imagefilledellipse</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefilledellipse</span> &amp;mdash; <span class='dc-title'>Desenha um elipse prenchido</span></p> </div> <a name='function.imagefilledellipse.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>imagefilledellipse</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cx</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cy</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagefilledellipse()</b> desenha um elipse centrado em <i><tt class='parameter'>cx</tt></i> , <i><tt class='parameter'>cy</tt></i> (em cima na esquerda &amp;eacute; 0, 0) na imagem representada por <i><tt class='parameter'>image</tt></i> . <i><tt class='parameter'>W</tt></i> e <i><tt class='parameter'>h</tt></i> especifica a largura e altura do elipse respectivamente. O elipse &amp;eacute; prenchido com a cor <i><tt class='parameter'>color</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> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o foi adicionada no PHP 4.0.6 e precisa da GD 2.0.1 ou posterior. <br /> </p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagefilledellipse()</b></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;cria&amp;nbsp;uma&amp;nbsp;imagem&amp;nbsp;em&amp;nbsp;branco<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>400</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;prenche&amp;nbsp;a&amp;nbsp;cor&amp;nbsp;do&amp;nbsp;fundo<br /></span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;escolhe&amp;nbsp;uma&amp;nbsp;cor&amp;nbsp;para&amp;nbsp;o&amp;nbsp;elipse<br /></span><span style='color: #0000BB'>$col_ellipse&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;desenha&amp;nbsp;o&amp;nbsp;elipse&amp;nbsp;branco<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col_ellipse</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;mostra&amp;nbsp;a&amp;nbsp;imagem<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imageellipse.php' class='function'>imageellipse()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagefilledarc.php' class='function'>imagefilledarc()</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="imagefilledarc" value="<div id='function.imagefilledarc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefilledarc.php'>imagefilledarc</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefilledarc</span> &amp;mdash; <span class='dc-title'>Draw a partial arc and fill it</span></p> </div> <a name='function.imagefilledarc.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>imagefilledarc</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cx</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cy</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$width</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$height</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$start</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$end</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$style</tt></span> )</div> <p class='para rdfs-comment'> Draws a partial arc centered at the specified coordinate in the given <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagefilledarc.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>cx</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of the center. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>cy</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of the center. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>width</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The arc width. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>height</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The arc height. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>start</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The arc start angle, in degrees. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>end</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The arc end angle, in degrees. 0&amp;deg; is located at the three-o&amp;#039;clock position, and the arc is drawn clockwise. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>color</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A color identifier created with <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a>. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>style</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A bitwise OR of the following possibilities: </p><ol type='1'> <li class='listitem'><span class='simpara'><b><tt class='constant'>IMG_ARC_PIE</tt></b></span></li> <li class='listitem'><span class='simpara'><b><tt class='constant'>IMG_ARC_CHORD</tt></b></span></li> <li class='listitem'><span class='simpara'><b><tt class='constant'>IMG_ARC_NOFILL</tt></b></span></li> <li class='listitem'><span class='simpara'><b><tt class='constant'>IMG_ARC_EDGED</tt></b></span></li> </ol><p> <b><tt class='constant'>IMG_ARC_PIE</tt></b> and <b><tt class='constant'>IMG_ARC_CHORD</tt></b> are mutually exclusive; <b><tt class='constant'>IMG_ARC_CHORD</tt></b> just connects the starting and ending angles with a straight line, while <b><tt class='constant'>IMG_ARC_PIE</tt></b> produces a rounded edge. <b><tt class='constant'>IMG_ARC_NOFILL</tt></b> indicates that the arc or chord should be outlined, not filled. <b><tt class='constant'>IMG_ARC_EDGED</tt></b>, used together with <b><tt class='constant'>IMG_ARC_NOFILL</tt></b>, indicates that the beginning and ending angles should be connected to the center - this is a good way to outline (rather than fill) a &amp;#039;pie slice&amp;#039;. </p> </dd> </dl> <p> </p> </div> <a name='function.imagefilledarc.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.imagefilledarc.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Creating a 3D looking pie</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;create&amp;nbsp;image<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;allocate&amp;nbsp;some&amp;nbsp;solors<br /></span><span style='color: #0000BB'>$white&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$gray&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xC0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xC0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xC0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$darkgray&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x90</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x90</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x90</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$navy&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x80</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$darknavy&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x50</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$red&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$darkred&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x90</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;make&amp;nbsp;the&amp;nbsp;3D&amp;nbsp;effect<br /></span><span style='color: #007700'>for&amp;nbsp;(</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>60</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #0000BB'>$i&amp;nbsp;</span><span style='color: #007700'>&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>50</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;</span><span style='color: #0000BB'>imagefilledarc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</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'>45</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$darknavy</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_ARC_PIE</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilledarc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>45</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>75&amp;nbsp;</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$darkgray</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_ARC_PIE</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilledarc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$i</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>75</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>360&amp;nbsp;</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$darkred</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_ARC_PIE</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>imagefilledarc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</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'>45</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$navy</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_ARC_PIE</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledarc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>45</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>75&amp;nbsp;</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$gray</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_ARC_PIE</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledarc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>75</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>360&amp;nbsp;</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>IMG_ARC_PIE</span><span style='color: #007700'>);<br /><br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;flush&amp;nbsp;image<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagefilledarc.png' /> </div> </div> </div><p> </p> </div> <a name='function.imagefilledarc.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></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="imagefill" value="<div id='function.imagefill' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagefill.php'>imagefill</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagefill</span> &amp;mdash; <span class='dc-title'>Flood fill</span></p> </div> <a name='function.imagefill.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>imagefill</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> Performs a flood fill starting at the given coordinate (top left is 0, 0) with the given <i><tt class='parameter'>color</tt></i> in the <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagefill.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of start point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of start point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>color</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The fill color. A color identifier created with <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a>. </p> </dd> </dl> <p> </p> </div> <a name='function.imagefill.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.imagefill.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagefill()</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 /><br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;sets&amp;nbsp;background&amp;nbsp;to&amp;nbsp;red<br /></span><span style='color: #0000BB'>$red&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefill</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagefill.png' /> </div> </div> </div><p> </p> </div> <a name='function.imagefill.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.imagecolorallocate.php' class='function' rel='rdfs-seeAlso'>imagecolorallocate()</a> - Aloca uma cor para uma imagem</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="imageellipse" value="<div id='function.imageellipse' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageellipse.php'>imageellipse</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imageellipse</span> &amp;mdash; <span class='dc-title'>Desenha um elipse</span></p> </div> <a name='function.imageellipse.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>imageellipse</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cx</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cy</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imageellipse()</b> desenha um elipse centrado na posi&amp;ccedil;&amp;atilde;o <i><tt class='parameter'>cx</tt></i> , <i><tt class='parameter'>cy</tt></i> (em cima a esquerda &amp;eacute; 0, 0) na imagem representada por <i><tt class='parameter'>image</tt></i> . <i><tt class='parameter'>W</tt></i> e <i><tt class='parameter'>h</tt></i> especifica a largura e altura do elipse, respectivamente. A cor do elipse &amp;eacute; especificada por <i><tt class='parameter'>color</tt></i> . </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o foi adicionada no PHP 4.0.6 e requer GD 2.0.2 ou posterior que pode ser obtida em <a href='http://www.libgd.org/' class='link external'>&amp;raquo; http://www.libgd.org/</a> <br /></p></blockquote> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imageellipse()</b></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;cria&amp;nbsp;uma&amp;nbsp;imagem&amp;nbsp;em&amp;nbsp;branco<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>400</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;prenche&amp;nbsp;a&amp;nbsp;cor&amp;nbsp;do&amp;nbsp;fundo<br /></span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;escolhe&amp;nbsp;uma&amp;nbsp;cor&amp;nbsp;para&amp;nbsp;o&amp;nbsp;elipse<br /></span><span style='color: #0000BB'>$col_ellipse&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;desenha&amp;nbsp;o&amp;nbsp;elipse<br /></span><span style='color: #0000BB'>imageellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$col_ellipse</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;mostra&amp;nbsp;a&amp;nbsp;imagem<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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.imagefilledellipse.php' class='function'>imagefilledellipse()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagearc.php' class='function'>imagearc()</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="imagedestroy" value="<div id='function.imagedestroy' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagedestroy.php'>imagedestroy</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagedestroy</span> &amp;mdash; <span class='dc-title'>Destr&amp;oacute;i uma imagem</span></p> </div> <a name='function.imagedestroy.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>imagedestroy</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> )</div> <p class='para rdfs-comment'> <b>imagedestroy()</b> libera qualquer mem&amp;oacute;ria associada com a imagem <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagedestroy.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.imagedestroy.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="imagedashedline" value="<div id='function.imagedashedline' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagedashedline.php'>imagedashedline</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagedashedline</span> &amp;mdash; <span class='dc-title'>Desenha uma linha pontilhada</span></p> </div> <a name='function.imagedashedline.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>imagedashedline</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y1</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y2</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o est&amp;aacute; obsoleta. Ao inv&amp;eacute;s use uma combina&amp;ccedil;&amp;atilde;o de <a href='http://www.php.net/manual/pt_BR/function.imagesetstyle.php' class='function'>imagesetstyle()</a> e <a href='http://www.php.net/manual/pt_BR/function.imageline.php' class='function'>imageline()</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="imagecreatetruecolor" value="<div id='function.imagecreatetruecolor' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatetruecolor.php'>imagecreatetruecolor</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatetruecolor</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem true color</span></p> </div> <a name='function.imagecreatetruecolor.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>imagecreatetruecolor</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x_size</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y_size</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatetruecolor()</b> retorna um identificador de imagem representando uma imagem preta de tamanho <i><tt class='parameter'>x_size</tt></i> por <i><tt class='parameter'>y_size</tt></i> . </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Criando um novo stream de imagem GD e enviando a imagem. </b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />header&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>50</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Cannot&amp;nbsp;Initialize&amp;nbsp;new&amp;nbsp;GD&amp;nbsp;image&amp;nbsp;stream'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$text_color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>233</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>14</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>91</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;Simple&amp;nbsp;Text&amp;nbsp;String'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$text_color</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o funcionar&amp;aacute; com arquivos de formato GIF. <br /> </p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagedestroy.php' class='function'>imagedestroy()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecreate.php' class='function'>imagecreate()</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="imagecreatefromxbm" value="<div id='function.imagecreatefromxbm' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromxbm.php'>imagecreatefromxbm</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromxbm</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem a a partir de um arquivo ou URL</span></p> </div> <a name='function.imagecreatefromxbm.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>imagecreatefromxbm</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatefromxbm()</b> retorna um identificador de imagem representando a imagem obtida atrav&amp;eacute;s do nome de arquivo dado. </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </p></div> </div> <a name='function.imagecreatefromxbm.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para imagem XBM </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefromxbm.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um resource identificador da imagem em sucesso, <b><tt class='constant'>FALSE</tt></b> em erros. </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="imagecreatefromwbmp" value="<div id='function.imagecreatefromwbmp' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromwbmp.php'>imagecreatefromwbmp</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromwbmp</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem a apratir de um arquivo ou URL</span></p> </div> <a name='function.imagecreatefromwbmp.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>imagecreatefromwbmp</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatefromwbmp()</b> retorna um identificador de imagem representando a imagem obtida atrav&amp;eacute;s do nome de arquivo dado. </p> <p class='para'> <b>imagecreatefromwbmp()</b> retorna uma string vazia em caso de falha. Tamb&amp;eacute;m mostra uma mensagem de erro, a qual infelizmente aparece como um link quebrado no browser. Para facilitar o debug, o exemplo asseguir ir&amp;aacute; prodizir um <acronym title='Wireless Bitmap'>WBMP</acronym> de erro: </p><div class='example'> <p><b>Exemplo #1 Exemplo de como manipular um erro durante a cria&amp;ccedil;&amp;atilde;o</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: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>LoadWBMP</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>)&amp;nbsp;<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>imagecreatefromwbmp</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Attempt&amp;nbsp;to&amp;nbsp;open&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)&amp;nbsp;{&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;See&amp;nbsp;if&amp;nbsp;it&amp;nbsp;failed&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>20</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;blank&amp;nbsp;image&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$bgc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>$tc&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$bgc</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'>/*&amp;nbsp;Output&amp;nbsp;an&amp;nbsp;errmsg&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Error&amp;nbsp;loading&amp;nbsp;</span><span style='color: #0000BB'>$imgname</span><span style='color: #DD0000'>'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$tc</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> </div> <a name='function.imagecreatefromwbmp.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para imagem WBMP </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefromwbmp.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um resource identificador da imagem em sucesso, <b><tt class='constant'>FALSE</tt></b> em erros. </p> </div> <a name='function.imagecreatefromwbmp.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O suporte a WBMP esta dispon&amp;iacute;vel apenas se o PHP for compilado com GD-1.8 ou posterior.</span></p></blockquote> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreatefromstring" value="<div id='function.imagecreatefromstring' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromstring.php'>imagecreatefromstring</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromstring</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem a apartir da imagem na string</span></p> </div> <a name='function.imagecreatefromstring.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>imagecreatefromstring</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$image</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatefromstring()</b> retorna um identificador de imagem representando a imagem obtida a apartir da string dada. </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="imagecreatefrompng" value="<div id='function.imagecreatefrompng' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefrompng.php'>imagecreatefrompng</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefrompng</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem a apratir de um arquivo ou URL</span></p> </div> <a name='function.imagecreatefrompng.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>imagecreatefrompng</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatefrompng()</b> retorna um identificador de imagem representando a imagem obtida atrav&amp;eacute;s do nome de arquivo dado. </p> <p class='para'> <b>imagecreatefrompng()</b> retorna uma string vazia em caso de falha. Tamb&amp;eacute;m mostra uma mensagem de erro, a qual infelizmente aparece como um link quebrado no browser. Para facilitar o debug, o exemplo asseguir ir&amp;aacute; prodizir um <acronym title='Portable Network Graphics'>PNG</acronym> de erro: </p><div class='example'> <p><b>Exemplo #1 Exemplo de como manipular um erro durante a cria&amp;ccedil;&amp;atilde;o</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: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>LoadPNG</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>)&amp;nbsp;<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Attempt&amp;nbsp;to&amp;nbsp;open&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)&amp;nbsp;{&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;See&amp;nbsp;if&amp;nbsp;it&amp;nbsp;failed&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;blank&amp;nbsp;image&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$bgc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>$tc&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$bgc</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'>/*&amp;nbsp;Output&amp;nbsp;an&amp;nbsp;errmsg&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Error&amp;nbsp;loading&amp;nbsp;</span><span style='color: #0000BB'>$imgname</span><span style='color: #DD0000'>'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$tc</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$img&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>LoadPNG</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'bogus.image'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</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='mediaobject'> <div class='imageobject'> <img src='images/d481d625821a97b9a5eb2cec99dca50e-image.imagecreatefrompng.png' /> </div> </div> </div><p> </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> </div> <a name='function.imagecreatefrompng.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para a imagem PNG </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefrompng.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um identificador de resource de imagem em sucesso, <b><tt class='constant'>FALSE</tt></b> em erros. </p> </div> <a name='function.imagecreatefrompng.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreatefromjpeg" value="<div id='function.imagecreatefromjpeg' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromjpeg.php'>imagecreatefromjpeg</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromjpeg</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem a a partir de um arquivo ou URL</span></p> </div> <a name='function.imagecreatefromjpeg.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>imagecreatefromjpeg</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatefromjpeg()</b> retorna um identificador de imagem representando a imagem obtida atrav&amp;eacute;s do nome de arquivo dado. </p> <p class='para'> Em falha <b>imagecreatefromjpeg()</b> exibe mensagem de erro. A qual infelizmente aparece como um link quebrado no browser. Para facilitar o debug, o exemplo asseguir ir&amp;aacute; prodizir um <acronym title='Joint Photographic Experts Group'>JPEG</acronym> de erro: </p><div class='example'> <p><b>Exemplo #1 Exemplo de como manipular um erro durante a cria&amp;ccedil;&amp;atilde;o</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: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>LoadJpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>)&amp;nbsp;<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>imagecreatefromjpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Attempt&amp;nbsp;to&amp;nbsp;open&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)&amp;nbsp;{&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;See&amp;nbsp;if&amp;nbsp;it&amp;nbsp;failed&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;black&amp;nbsp;image&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$bgc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>$tc&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$bgc</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'>/*&amp;nbsp;Output&amp;nbsp;an&amp;nbsp;errmsg&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Error&amp;nbsp;loading&amp;nbsp;</span><span style='color: #0000BB'>$imgname</span><span style='color: #DD0000'>'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$tc</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$img&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>LoadJpeg</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'bogus.image'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</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='mediaobject'> <div class='imageobject'> <img src='images/d481d625821a97b9a5eb2cec99dca50e-image.imagecreatefromjpeg.jpg' /> </div> </div> </div><p> </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> </div> <a name='function.imagecreatefromjpeg.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho da imagem JPEG </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefromjpeg.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um resource identificador da imagem em sucesso, <b><tt class='constant'>FALSE</tt></b> em erros. </p> </div> <a name='function.imagecreatefromjpeg.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>O suporte a JPEG esta dispon&amp;iacute;vel apenas se o PHP for compilado com GD-1.8 ou posterior.</span></p></blockquote> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreatefromgif" value="<div id='function.imagecreatefromgif' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromgif.php'>imagecreatefromgif</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromgif</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem a partir de um arquivo ou URL</span></p> </div> <a name='function.imagecreatefromgif.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>imagecreatefromgif</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreatefromgif()</b> retorna um identificador de imagem representando a imagem obtida a partir de um nome de arquivo dado. </p> <p class='para'> Para facilmente debugar o seguinte exemplo ir&amp;aacute; produzir um GIF errado: </p><div class='example'> <p><b>Exemplo #1 Exemplo de como manipular um erro durante a cria&amp;ccedil;&amp;atilde;o</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: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>LoadGif&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>)&amp;nbsp;<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>imagecreatefromgif&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$imgname</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Attempt&amp;nbsp;to&amp;nbsp;open&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>)&amp;nbsp;{&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;See&amp;nbsp;if&amp;nbsp;it&amp;nbsp;failed&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;blank&amp;nbsp;image&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$bgc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>$tc&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagefilledrectangle&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$bgc</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'>/*&amp;nbsp;Output&amp;nbsp;an&amp;nbsp;errmsg&amp;nbsp;*/<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>imagestring&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Error&amp;nbsp;loading&amp;nbsp;</span><span style='color: #0000BB'>$imgname</span><span style='color: #DD0000'>'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$tc</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>;<br />}<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/gif'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$img&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>LoadGif</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'bogus.image'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagegif</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</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='mediaobject'> <div class='imageobject'> <img src='images/d481d625821a97b9a5eb2cec99dca50e-image.imagefromgif.png' /> </div> </div> </div><p> </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> </div> <a name='function.imagecreatefromgif.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para a imagem GIF </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefromgif.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um resource identificador da imagem em sucesso, <b><tt class='constant'>FALSE</tt></b> em erro. </p> </div> <a name='function.imagecreatefromgif.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: O suporte a GIF foi removido da biblioteca GD na vers&amp;atilde;o 1.6, e adicionado novamente na vers&amp;atilde;o 2.0.28. Esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o est&amp;aacute; dispon&amp;iacute;vel entre essas vers&amp;otilde;es. <br /> </p></blockquote> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreatefromgd2part" value="<div id='function.imagecreatefromgd2part' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromgd2part.php'>imagecreatefromgd2part</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromgd2part</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem apartir de uma parte de um arquivo GD ou URL</span></p> </div> <a name='function.imagecreatefromgd2part.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>imagecreatefromgd2part</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$srcX</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$srcY</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$width</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$height</tt></span> )</div> <p class='para rdfs-comment'> <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> </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreatefromgd2" value="<div id='function.imagecreatefromgd2' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromgd2.php'>imagecreatefromgd2</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromgd2</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem apartir de um arquivo GD2 ou URL</span></p> </div> <a name='function.imagecreatefromgd2.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>imagecreatefromgd2</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</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 class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> </div> <a name='function.imagecreatefromgd2.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefromgd2.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreatefromgd" value="<div id='function.imagecreatefromgd' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreatefromgd.php'>imagecreatefromgd</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.7, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreatefromgd</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem apartir de um arquivo GD ou URL</span></p> </div> <a name='function.imagecreatefromgd.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>imagecreatefromgd</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> )</div> <p class='para rdfs-comment'> <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> </p> <div class='tip'><b class='tip'>Dica</b><p class='simpara'>Voc&amp;ecirc; pode usar uma URL como um nome de arquivo nesta fun&amp;ccedil;&amp;atilde;o se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'> fopen wrappers</a> estiver habilitado. Veja <a href='http://www.php.net/manual/pt_BR/function.fopen.php' class='function'>fopen()</a> para mais detalhes em como especificar o nome do arquivo e <a href='http://www.php.net/manual/pt_BR/wrappers.php' class='xref'>List of Supported Protocols/Wrappers</a> para uma lista de protocolos URL suportados.</p></div> </div> <a name='function.imagecreatefromgd.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'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreatefromgd.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <div class='warning'><b class='warning'>Aviso</b><p class='para'>A vers&amp;otilde;es Windows do PHP anteriores ao PHP 4.3.0 n&amp;atilde;o suportam acesso a arquivos remotos atrav&amp;eacute;s desta fun&amp;ccedil;&amp;atilde;o, mesmo se <a href='http://www.php.net/manual/pt_BR/filesystem.configuration.php#ini.allow-url-fopen' class='link'>allow_url_fopen</a> estiver ativado. </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="imagecreate" value="<div id='function.imagecreate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecreate.php'>imagecreate</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecreate</span> &amp;mdash; <span class='dc-title'>Cria uma nova imagem baseada em paleta</span></p> </div> <a name='function.imagecreate.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>imagecreate</b></span> ( <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$width</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$height</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecreate()</b> retorna um identificadir de imagem representando uma imagem em branco do tamanho especificado. </p> <p class='para'> N&amp;oacute;s recomendamos o uso de <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>. </p> </div> <a name='function.imagecreate.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'>width</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A largura da imagem </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>height</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A altura da imagem </p> </dd> </dl> <p> </p> </div> <a name='function.imagecreate.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um resource identificador da imagem em sucesso, <b><tt class='constant'>FALSE</tt></b> em erros. </p> </div> <a name='function.imagecreate.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Criando um novo stream de imagem GD e mostrando uma imagem. </b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;@</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>110</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>)<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;or&amp;nbsp;die(</span><span style='color: #DD0000'>'Cannot&amp;nbsp;Initialize&amp;nbsp;new&amp;nbsp;GD&amp;nbsp;image&amp;nbsp;stream'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$background_color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$text_color&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>233</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>14</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>91</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;Simple&amp;nbsp;Text&amp;nbsp;String'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$text_color</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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='mediaobject'> <div class='imageobject'> <img src='images/d481d625821a97b9a5eb2cec99dca50e-image.imagecreate.png' /> </div> </div> </div><p> </p> </div> <a name='function.imagecreate.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.imagedestroy.php' class='function' rel='rdfs-seeAlso'>imagedestroy()</a> - Destr&amp;oacute;i uma imagem</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function' rel='rdfs-seeAlso'>imagecreatetruecolor()</a> - Cria uma nova imagem true color</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="imagecopyresized" value="<div id='function.imagecopyresized' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecopyresized.php'>imagecopyresized</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecopyresized</span> &amp;mdash; <span class='dc-title'>Copy and resize part of an image</span></p> </div> <a name='function.imagecopyresized.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>imagecopyresized</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$dst_image</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$src_image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_h</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecopyresized()</b> copies a rectangular portion of one image to another image. <i><tt class='parameter'>dst_image</tt></i> is the destination image, <i><tt class='parameter'>src_image</tt></i> is the source image identifier. </p> <p class='para'> In other words, <b>imagecopyresized()</b> will take an rectangular area from <i><tt class='parameter'>src_image</tt></i> of width <i><tt class='parameter'>src_w</tt></i> and height <i><tt class='parameter'>src_h</tt></i> at position (<i><tt class='parameter'>src_x</tt></i> ,<i><tt class='parameter'>src_y</tt></i> ) and place it in a rectangular area of <i><tt class='parameter'>dst_image</tt></i> of width <i><tt class='parameter'>dst_w</tt></i> and height <i><tt class='parameter'>dst_h</tt></i> at position (<i><tt class='parameter'>dst_x</tt></i> ,<i><tt class='parameter'>dst_y</tt></i> ). </p> <p class='para'> If the source and destination coordinates and width and heights differ, appropriate stretching or shrinking of the image fragment will be performed. The coordinates refer to the upper left corner. This function can be used to copy regions within the same image (if <i><tt class='parameter'>dst_image</tt></i> is the same as <i><tt class='parameter'>src_image</tt></i> ) but if the regions overlap the results will be unpredictable. </p> </div> <a name='function.imagecopyresized.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'>dst_im</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination image link resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_im</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source image link resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of destination point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of destination point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of source point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of source point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_w</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination width. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_h</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination height. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_w</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source width. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_h</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source height. </p> </dd> </dl> <p> </p> </div> <a name='function.imagecopyresized.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.imagecopyresized.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Resizing an image</b></p> <div class='example-contents para'><p> This example will display the image at half size. </p></div> <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;File&amp;nbsp;and&amp;nbsp;new&amp;nbsp;size<br /></span><span style='color: #0000BB'>$filename&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'test.jpg'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$percent&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0.5</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Content&amp;nbsp;type<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Get&amp;nbsp;new&amp;nbsp;sizes<br /></span><span style='color: #007700'>list(</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>)&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>getimagesize</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$newwidth&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$width&amp;nbsp;</span><span style='color: #007700'>*&amp;nbsp;</span><span style='color: #0000BB'>$percent</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$newheight&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$height&amp;nbsp;</span><span style='color: #007700'>*&amp;nbsp;</span><span style='color: #0000BB'>$percent</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Load<br /></span><span style='color: #0000BB'>$thumb&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$newwidth</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$newheight</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$source&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromjpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Resize<br /></span><span style='color: #0000BB'>imagecopyresized</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$thumb</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$source</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'>0</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$newwidth</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$newheight</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output<br /></span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$thumb</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagecopyresized.jpg' /> </div> </div> <div class='example-contents para'><p> The image will be output at half size, though better quality could be obtained using <a href='http://www.php.net/manual/pt_BR/function.imagecopyresampled.php' class='function'>imagecopyresampled()</a>. </p></div> </div><p> </p> </div> <a name='function.imagecopyresized.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: There is a problem due to palette image limitations (255+1 colors). Resampling or filtering an image commonly needs more colors than 255, a kind of approximation is used to calculate the new resampled pixel and its color. With a palette image we try to allocate a new color, if that failed, we choose the closest (in theory) computed color. This is not always the closest visual color. That may produce a weird result, like blank (or visually blank) images. To skip this problem, please use a truecolor image as a destination image, such as one created by <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>. <br /> </p></blockquote> </div> <a name='function.imagecopyresized.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/function.imagecopyresampled.php' class='function' rel='rdfs-seeAlso'>imagecopyresampled()</a> - Copy and resize part of an image with resampling </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="imagecopyresampled" value="<div id='function.imagecopyresampled' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecopyresampled.php'>imagecopyresampled</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecopyresampled</span> &amp;mdash; <span class='dc-title'>Copy and resize part of an image with resampling</span></p> </div> <a name='function.imagecopyresampled.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>imagecopyresampled</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$dst_image</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$src_image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_h</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecopyresampled()</b> copies a rectangular portion of one image to another image, smoothly interpolating pixel values so that, in particular, reducing the size of an image still retains a great deal of clarity. </p> <p class='para'> In other words, <b>imagecopyresampled()</b> will take an rectangular area from <i><tt class='parameter'>src_image</tt></i> of width <i><tt class='parameter'>src_w</tt></i> and height <i><tt class='parameter'>src_h</tt></i> at position (<i><tt class='parameter'>src_x</tt></i> ,<i><tt class='parameter'>src_y</tt></i> ) and place it in a rectangular area of <i><tt class='parameter'>dst_image</tt></i> of width <i><tt class='parameter'>dst_w</tt></i> and height <i><tt class='parameter'>dst_h</tt></i> at position (<i><tt class='parameter'>dst_x</tt></i> ,<i><tt class='parameter'>dst_y</tt></i> ). </p> <p class='para'> If the source and destination coordinates and width and heights differ, appropriate stretching or shrinking of the image fragment will be performed. The coordinates refer to the upper left corner. This function can be used to copy regions within the same image (if <i><tt class='parameter'>dst_image</tt></i> is the same as <i><tt class='parameter'>src_image</tt></i> ) but if the regions overlap the results will be unpredictable. </p> </div> <a name='function.imagecopyresampled.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'>dst_im</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination image link resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_im</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source image link resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of destination point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of destination point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of source point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of source point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_w</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination width. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_h</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination height. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_w</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source width. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_h</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source height. </p> </dd> </dl> <p> </p> </div> <a name='function.imagecopyresampled.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.imagecopyresampled.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Simple example</b></p> <div class='example-contents para'><p> This example will resample an image to half its original size. </p></div> <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;The&amp;nbsp;file<br /></span><span style='color: #0000BB'>$filename&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'test.jpg'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$percent&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>0.5</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Content&amp;nbsp;type<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Get&amp;nbsp;new&amp;nbsp;dimensions<br /></span><span style='color: #007700'>list(</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>)&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>getimagesize</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$new_width&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$width&amp;nbsp;</span><span style='color: #007700'>*&amp;nbsp;</span><span style='color: #0000BB'>$percent</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$new_height&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$height&amp;nbsp;</span><span style='color: #007700'>*&amp;nbsp;</span><span style='color: #0000BB'>$percent</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Resample<br /></span><span style='color: #0000BB'>$image_p&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$new_width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$new_height</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromjpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagecopyresampled</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image_p</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$image</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'>0</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$new_width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$new_height</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output<br /></span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image_p</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>null</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagecopyresampled.jpg' /> </div> </div> </div><p> </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #2 Resampling an image proportionally</b></p> <div class='example-contents para'><p> This example will display an image with the maximum width, or height, of 200 pixels. </p></div> <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;The&amp;nbsp;file<br /></span><span style='color: #0000BB'>$filename&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'test.jpg'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;a&amp;nbsp;maximum&amp;nbsp;height&amp;nbsp;and&amp;nbsp;width<br /></span><span style='color: #0000BB'>$width&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$height&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Content&amp;nbsp;type<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/jpeg'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Get&amp;nbsp;new&amp;nbsp;dimensions<br /></span><span style='color: #007700'>list(</span><span style='color: #0000BB'>$width_orig</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height_orig</span><span style='color: #007700'>)&amp;nbsp;=&amp;nbsp;</span><span style='color: #0000BB'>getimagesize</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$ratio_orig&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$width_orig</span><span style='color: #007700'>/</span><span style='color: #0000BB'>$height_orig</span><span style='color: #007700'>;<br /><br />if&amp;nbsp;(</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>/</span><span style='color: #0000BB'>$height&amp;nbsp;</span><span style='color: #007700'>&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>$ratio_orig</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$width&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>*</span><span style='color: #0000BB'>$ratio_orig</span><span style='color: #007700'>;<br />}&amp;nbsp;else&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$height&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>/</span><span style='color: #0000BB'>$ratio_orig</span><span style='color: #007700'>;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Resample<br /></span><span style='color: #0000BB'>$image_p&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromjpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagecopyresampled</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image_p</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$image</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'>0</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$width</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$width_orig</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$height_orig</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output<br /></span><span style='color: #0000BB'>imagejpeg</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image_p</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>null</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imagecopyresampled_2.jpg' /> </div> </div> </div><p> </p> </div> <a name='function.imagecopyresampled.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: There is a problem due to palette image limitations (255+1 colors). Resampling or filtering an image commonly needs more colors than 255, a kind of approximation is used to calculate the new resampled pixel and its color. With a palette image we try to allocate a new color, if that failed, we choose the closest (in theory) computed color. This is not always the closest visual color. That may produce a weird result, like blank (or visually blank) images. To skip this problem, please use a truecolor image as a destination image, such as one created by <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>. <br /> </p></blockquote> </div> <a name='function.imagecopyresampled.seealso'></a><div class='refsect1 seealso'> <h3 class='title'>Veja Tamb&amp;eacute;m</h3> <p class='para'> <a href='http://www.php.net/manual/pt_BR/function.imagecopyresized.php' class='function' rel='rdfs-seeAlso'>imagecopyresized()</a> - Copy and resize part of an image </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="imagecopymergegray" value="<div id='function.imagecopymergegray' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecopymergegray.php'>imagecopymergegray</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecopymergegray</span> &amp;mdash; <span class='dc-title'>Copy and merge part of an image with gray scale</span></p> </div> <a name='function.imagecopymergegray.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>imagecopymergegray</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$dst_im</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$src_im</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$pct</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecopymergegray()</b> copy a part of <i><tt class='parameter'>src_im</tt></i> onto <i><tt class='parameter'>dst_im</tt></i> starting at the x,y coordinates <i><tt class='parameter'>src_x</tt></i> , <i><tt class='parameter'>src_y </tt></i> with a width of <i><tt class='parameter'>src_w</tt></i> and a height of <i><tt class='parameter'>src_h</tt></i> . The portion defined will be copied onto the x,y coordinates, <i><tt class='parameter'>dst_x</tt></i> and <i><tt class='parameter'>dst_y</tt></i> . </p> <p class='para'> This function is identical to <a href='http://www.php.net/manual/pt_BR/function.imagecopymerge.php' class='function'>imagecopymerge()</a> except that when merging it preserves the hue of the source by converting the destination pixels to gray scale before the copy operation. </p> </div> <a name='function.imagecopymergegray.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'>dst_im</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Destination image link resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_im</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source image link resource. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of destination point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>dst_y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of destination point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> x-coordinate of source point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> y-coordinate of source point. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_w</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source width. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>src_h</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Source height. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>pct</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The <i><tt class='parameter'>src_im</tt></i> will be changed to grayscale according to <i><tt class='parameter'>pct</tt></i> where 0 is fully grayscale and 100 is unchanged. When <i><tt class='parameter'>pct</tt></i> = 100 this function behaves identically to <a href='http://www.php.net/manual/pt_BR/function.imagecopy.php' class='function'>imagecopy()</a> for pallete images, while it implements alpha transparency for true colour images. </p> </dd> </dl> <p> </p> </div> <a name='function.imagecopymergegray.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.imagecopymergegray.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagecopymergegray()</b> usage</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;Create&amp;nbsp;image&amp;nbsp;instances<br /></span><span style='color: #0000BB'>$dest&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromgif</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'php.gif'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$src&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromgif</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'php.gif'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Copy&amp;nbsp;and&amp;nbsp;merge&amp;nbsp;-&amp;nbsp;Gray&amp;nbsp;=&amp;nbsp;20%<br /></span><span style='color: #0000BB'>imagecopymergegray</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dest</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$src</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>47</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>20</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;and&amp;nbsp;free&amp;nbsp;from&amp;nbsp;memory<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/gif'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagegif</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dest</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$dest</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$src</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="imagecopymerge" value="<div id='function.imagecopymerge' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecopymerge.php'>imagecopymerge</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.1, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecopymerge</span> &amp;mdash; <span class='dc-title'>Copia e combina uma parte de uma imagem</span></p> </div> <a name='function.imagecopymerge.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>imagecopymerge</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$dst_im</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$src_im</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$pct</tt></span> )</div> <p class='para rdfs-comment'> Copia parte de <i><tt class='parameter'>src_im</tt></i> em <i><tt class='parameter'>dst_im</tt></i> come&amp;ccedil;ando nas coordenadas <i><tt class='parameter'>src_x</tt></i> , <i><tt class='parameter'>src_y </tt></i> com a largura de <i><tt class='parameter'>src_w</tt></i> e altura de <i><tt class='parameter'>src_h</tt></i> . A por&amp;ccedil;&amp;atilde;o definida ser&amp;aacute; copiada nas coordenadas x,y, <i><tt class='parameter'>dst_x</tt></i> e <i><tt class='parameter'>dst_y</tt></i> . As duas imagens ser&amp;atilde;o combinadas de acordo com <i><tt class='parameter'>pct</tt></i> o qual pode variar de 0 a 100. Quando <i><tt class='parameter'>pct</tt></i> = 0, n&amp;atilde;o haver&amp;aacute; modifica&amp;ccedil;&amp;atilde;o, quando 100 esta fun&amp;ccedil;&amp;atilde;o funciona de modo identico a <a href='http://www.php.net/manual/pt_BR/function.imagecopy.php' class='function'>imagecopy()</a> para imagens de paleta, enquanto implemente transparencia alpha para imagens true colour. </p> <blockquote><p><b class='note'>Nota</b>: Esta fun&amp;ccedil;&amp;atilde;o foi adicionada no PHP 4.0.6<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="imagecopy" value="<div id='function.imagecopy' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecopy.php'>imagecopy</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecopy</span> &amp;mdash; <span class='dc-title'>Copia parte de uma imagem</span></p> </div> <a name='function.imagecopy.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>imagecopy</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$dst_im</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$src_im</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$dst_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_y</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$src_h</tt></span> )</div> <p class='para rdfs-comment'> Copia parte de <i><tt class='parameter'>src_im</tt></i> em <i><tt class='parameter'>dst_im</tt></i> come&amp;ccedil;ando nas coordenadas x,y <i><tt class='parameter'>src_x</tt></i> , <i><tt class='parameter'>src_y </tt></i> com a largura de <i><tt class='parameter'>src_w</tt></i> e altura de <i><tt class='parameter'>src_h</tt></i> . A por&amp;ccedil;&amp;atilde;o definida ser&amp;aacute; copiada nas coordenadas x,y, <i><tt class='parameter'>dst_x</tt></i> e <i><tt class='parameter'>dst_y</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="imageconvolution" value="<div id='function.imageconvolution' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageconvolution.php'>imageconvolution</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>imageconvolution</span> &amp;mdash; <span class='dc-title'>Apply a 3x3 convolution matrix, using coefficient and offset</span></p> </div> <a name='function.imageconvolution.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>imageconvolution</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$matrix</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$div</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$offset</tt></span> )</div> <p class='para rdfs-comment'> Applies a convolution matrix on the image, using the given coefficient and offset. </p> </div> <a name='function.imageconvolution.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>matrix</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A 3x3 matrix: an array of three arrays of three floats. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>div</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The divisor of the result of the convolution, used for normalization. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>offset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Color offset. </p> </dd> </dl> <p> </p> </div> <a name='function.imageconvolution.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.imageconvolution.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Embossing the PHP.net logo</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefromgif</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'http://www.php.net/images/php.gif'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$emboss&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(array(</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'>0</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: #0000BB'>1</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</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: #0000BB'>0</span><span style='color: #007700'>,&amp;nbsp;-</span><span style='color: #0000BB'>1</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>imageconvolution</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$emboss</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'>127</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>null</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>9</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imageconvolution_emboss.png' /> </div> </div> </div><p> </p><div class='example'> <p><b>Exemplo #2 Gaussian blur</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>180</span><span style='color: #007700'>,</span><span style='color: #0000BB'>40</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Writes&amp;nbsp;the&amp;nbsp;text&amp;nbsp;and&amp;nbsp;apply&amp;nbsp;a&amp;nbsp;gaussian&amp;nbsp;blur&amp;nbsp;on&amp;nbsp;the&amp;nbsp;image<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>8</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Gaussian&amp;nbsp;Blur&amp;nbsp;Text'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00ff00</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$gaussian&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(array(</span><span style='color: #0000BB'>1.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1.0</span><span style='color: #007700'>),&amp;nbsp;array(</span><span style='color: #0000BB'>2.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>4.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2.0</span><span style='color: #007700'>),&amp;nbsp;array(</span><span style='color: #0000BB'>1.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>2.0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>1.0</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>imageconvolution</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$gaussian</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>16</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Rewrites&amp;nbsp;the&amp;nbsp;text&amp;nbsp;for&amp;nbsp;comparison<br /></span><span style='color: #0000BB'>imagestring</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>5</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>18</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'Gaussian&amp;nbsp;Blur&amp;nbsp;Text'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00ff00</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>null</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>9</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='mediaobject'> <div class='imageobject'> <img src='images/21009b70229598c6a80eef8b45bf282b-imageconvolution_gaussian.png' /> </div> </div> </div><p> </p> </div> <a name='function.imageconvolution.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 somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></p></blockquote> </div> <a name='function.imageconvolution.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.imagefilter.php' class='function' rel='rdfs-seeAlso'>imagefilter()</a> - Applies a filter to an image</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="imagecolortransparent" value="<div id='function.imagecolortransparent' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolortransparent.php'>imagecolortransparent</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolortransparent</span> &amp;mdash; <span class='dc-title'>Define uma cor como tansparente</span></p> </div> <a name='function.imagecolortransparent.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>imagecolortransparent</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> ] )</div> <p class='para rdfs-comment'> Define a cor transparente na dada <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.imagecolortransparent.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>color</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Um identificador de cor criado com <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a> </p> </dd> </dl> <p> </p> </div> <a name='function.imagecolortransparent.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> O identificador da nova (ou atual, se nenhuma for especificada) cor transparente &amp;eacute; retornado. </p> </div> <a name='function.imagecolortransparent.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: A transpar&amp;ecirc;ncia &amp;eacute; copiada apenas com <b>imagecopymerged()</b> e imagens true color, n&amp;atilde;o com <a href='http://www.php.net/manual/pt_BR/function.imagecopy.php' class='function'>imagecopy()</a> ou imagens de paleta. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: A cor transparente &amp;eacute; uma propriedade da imagem, a transparencia n&amp;atilde;o &amp;eacute; uma propriedade da cor. Uma vez que voc&amp;ecirc; definiu uma cor para ser a cor de transpar&amp;ecirc;ncia, todas as regi&amp;otilde;es da imagem que eram desenhadas com esta cor anteriormente ser&amp;atilde;o transparentes. <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="imagecolorstotal" value="<div id='function.imagecolorstotal' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorstotal.php'>imagecolorstotal</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorstotal</span> &amp;mdash; <span class='dc-title'>Retorna o n&amp;uacute;mero de cores na paleta de uma imagem</span></p> </div> <a name='function.imagecolorstotal.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>imagecolorstotal</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> )</div> <p class='para rdfs-comment'> Retorna o n&amp;uacute;mero de cores na paleta da imagem. </p> </div> <a name='function.imagecolorstotal.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> </dl> <p> </p> </div> <a name='function.imagecolorstotal.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna o n&amp;uacute;mero de cores na especificada paleta da imagem ou 0 para imagens truecolor. </p> </div> <a name='function.imagecolorstotal.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.imagecolorat.php' class='function' rel='rdfs-seeAlso'>imagecolorat()</a> - Retorna o &amp;iacute;ndice da cor de um pixel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagecolorsforindex.php' class='function' rel='rdfs-seeAlso'>imagecolorsforindex()</a> - Retorna as cores de um &amp;iacute;ndice</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imageistruecolor.php' class='function' rel='rdfs-seeAlso'>imageistruecolor()</a> - Indica quando uma imagem &amp;eacute; uma imagem truecolor</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="imagecolorsforindex" value="<div id='function.imagecolorsforindex' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorsforindex.php'>imagecolorsforindex</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorsforindex</span> &amp;mdash; <span class='dc-title'>Retorna as cores de um &amp;iacute;ndice</span></p> </div> <a name='function.imagecolorsforindex.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>imagecolorsforindex</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$index</tt></span> )</div> <p class='para rdfs-comment'> Obt&amp;eacute;m a cor de um especificado &amp;iacute;ndice. </p> </div> <a name='function.imagecolorsforindex.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.imagecolorsforindex.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um array associativo com as chaves vermelho, verde, azul e alpha que cont&amp;eacute;m os apropriados valores para o especificado &amp;iacute;ndice de cor. </p> </div> <a name='function.imagecolorsforindex.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagecolorsforindex()</b></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;abre&amp;nbsp;uma&amp;nbsp;imagem<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'nexen.png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;obt&amp;eacute;m&amp;nbsp;uma&amp;nbsp;cor<br /></span><span style='color: #0000BB'>$start_x&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>40</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$start_y&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>50</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$color_index&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorat</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$start_x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$start_y</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;torna&amp;nbsp;leg&amp;iacute;vel<br /></span><span style='color: #0000BB'>$color_tran&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorsforindex</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$color_index</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Qual&amp;nbsp;&amp;eacute;?<br /></span><span style='color: #0000BB'>print_r</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$color_tran</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 algo similar a:</p></div> <div class='example-contents screen'> <div class='cdata'><pre> Array ( [red] =&amp;gt; 226 [green] =&amp;gt; 222 [blue] =&amp;gt; 252 [alpha] =&amp;gt; 0 ) </pre></div> </div> </div><p> </p> </div> <a name='function.imagecolorsforindex.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.imagecolorat.php' class='function' rel='rdfs-seeAlso'>imagecolorat()</a> - Retorna o &amp;iacute;ndice da cor de um pixel</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagecolorexact.php' class='function' rel='rdfs-seeAlso'>imagecolorexact()</a> - Retorna o &amp;iacute;ndice da cor especificada</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="imagecolorset" value="<div id='function.imagecolorset' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorset.php'>imagecolorset</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorset</span> &amp;mdash; <span class='dc-title'>Set the color for the specified palette index</span></p> </div> <a name='function.imagecolorset.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>imagecolorset</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$index</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> )</div> <p class='para rdfs-comment'> This sets the specified index in the palette to the specified color. This is useful for creating flood-fill-like effects in palleted images without the overhead of performing the actual flood-fill. </p> </div> <a name='function.imagecolorset.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>index</tt></i> </span> </dt><dd class='listitem'> <p class='para'> An index in the palette. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>red</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Value of red component. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>green</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Value of green component. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>blue</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Value of blue component. </p> </dd> </dl> <p> </p> </div> <a name='function.imagecolorset.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.imagecolorset.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>imagecolorset()</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 /></span><span style='color: #FF8000'>//&amp;nbsp;Create&amp;nbsp;a&amp;nbsp;300x100&amp;nbsp;image<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>300</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;the&amp;nbsp;background&amp;nbsp;to&amp;nbsp;be&amp;nbsp;red<br /></span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Get&amp;nbsp;the&amp;nbsp;color&amp;nbsp;index&amp;nbsp;for&amp;nbsp;the&amp;nbsp;background<br /></span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorat</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;the&amp;nbsp;backgrund&amp;nbsp;to&amp;nbsp;be&amp;nbsp;blue<br /></span><span style='color: #0000BB'>imagecolorset</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$bg</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output&amp;nbsp;the&amp;nbsp;image&amp;nbsp;to&amp;nbsp;the&amp;nbsp;browser<br />//header('Content-type:&amp;nbsp;image/png');<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagecolorset.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.imagecolorat.php' class='function' rel='rdfs-seeAlso'>imagecolorat()</a> - Retorna o &amp;iacute;ndice da cor de um pixel</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="imagecolorresolvealpha" value="<div id='function.imagecolorresolvealpha' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorresolvealpha.php'>imagecolorresolvealpha</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorresolvealpha</span> &amp;mdash; <span class='dc-title'> Retorna o &amp;iacute;ndice da cor especificada + transpar&amp;ecirc;ncia ou a sua alternativa mais pr&amp;oacute;xima </span></p> </div> <a name='function.imagecolorresolvealpha.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>imagecolorresolvealpha</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$alpha</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; garantida para retornar um &amp;iacute;ndice de cor para a cor solicitada, ou a cor exata, ou a alternativa mais pr&amp;oacute;xima poss&amp;iacute;vel. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorclosestalpha.php' class='function'>imagecolorclosestalpha()</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="imagecolorresolve" value="<div id='function.imagecolorresolve' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorresolve.php'>imagecolorresolve</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorresolve</span> &amp;mdash; <span class='dc-title'> Retorna o &amp;iacute;ndice da cor especificada ou a alternativa mais pr&amp;oacute;xima poss&amp;iacute;vel </span></p> </div> <a name='function.imagecolorresolve.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>imagecolorresolve</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; garantida para retornar um &amp;iacute;ndice de cor para a cor solicitada, ou a cor exata, ou a alternativa mais pr&amp;oacute;xima poss&amp;iacute;vel. </p> <p class='para'> Se voc&amp;ecirc; criou a imagem a partir de um arquivo, apenas as cores usadas na imagem s&amp;atilde;o resolvidas. Cores presentes apenas na paleta n&amp;atilde;o s&amp;atilde;o resolvidas. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorclosest.php' class='function'>imagecolorclosest()</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="imagecolormatch" value="<div id='function.imagecolormatch' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolormatch.php'>imagecolormatch</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolormatch</span> &amp;mdash; <span class='dc-title'> Faz com que a vers&amp;atilde;o das cores da paleta sejam mais pr&amp;oacute;ximas da vers&amp;atilde;o truecolor </span></p> </div> <a name='function.imagecolormatch.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>imagecolormatch</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image1</tt></span> , <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image2</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> <p class='para'> <i><tt class='parameter'>image1</tt></i> deve ser Truecolor, <i><tt class='parameter'>image2</tt></i> deve ser uma paleta, e ambas <i><tt class='parameter'>image1</tt></i> e <i><tt class='parameter'>image2</tt></i> devem ter o mesmo tamanho. </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> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</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="imagecolorexactalpha" value="<div id='function.imagecolorexactalpha' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorexactalpha.php'>imagecolorexactalpha</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorexactalpha</span> &amp;mdash; <span class='dc-title'>Retorna o &amp;iacute;ndice da cor especificada + transparencia</span></p> </div> <a name='function.imagecolorexactalpha.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>imagecolorexactalpha</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$alpha</tt></span> )</div> <p class='para rdfs-comment'> Retorna o &amp;iacute;ndice da cor especificada + transparencia na paleta da imagem especificada. </p> <p class='para'> Se a cor n&amp;atilde;o existir na paleta de imagem, &amp;eacute; retornado -1. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorclosestalpha.php' class='function'>imagecolorclosestalpha()</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="imagecolorexact" value="<div id='function.imagecolorexact' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorexact.php'>imagecolorexact</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorexact</span> &amp;mdash; <span class='dc-title'>Retorna o &amp;iacute;ndice da cor especificada</span></p> </div> <a name='function.imagecolorexact.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>imagecolorexact</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> )</div> <p class='para rdfs-comment'> Retorna o &amp;iacute;ndice da cor especificada na paleta da imagem. </p> <p class='para'> Se a cor n&amp;atilde;o existir na paleta de imagem, &amp;eacute; retornado -1. </p> <p class='para'> Se voc&amp;ecirc; criou a imagem a partir de um arquivo, apenas as cores usadas na imagem s&amp;atilde;o resolvidas. Cores presentes apenas na paleta n&amp;atilde;o s&amp;atilde;o resolvidas. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorclosest.php' class='function'>imagecolorclosest()</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="imagecolordeallocate" value="<div id='function.imagecolordeallocate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolordeallocate.php'>imagecolordeallocate</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolordeallocate</span> &amp;mdash; <span class='dc-title'>Desaloca uma cor para uma imagem</span></p> </div> <a name='function.imagecolordeallocate.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>imagecolordeallocate</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> A fun&amp;ccedil;&amp;atilde;o <b>imagecolordeallocate()</b> desaloca uma cor previamente alocada com <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a> ou <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocatealpha.php' class='function'>imagecolorallocatealpha()</a>. </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 />$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagecolordeallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$white</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.imagecolorallocate.php' class='function'>imagecolorallocate()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocatealpha.php' class='function'>imagecolorallocatealpha()</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="imagecolorclosestalpha" value="<div id='function.imagecolorclosestalpha' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorclosestalpha.php'>imagecolorclosestalpha</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorclosestalpha</span> &amp;mdash; <span class='dc-title'>Retorna o &amp;iacute;ndice da cor mais pr&amp;oacute;xima da cor especificada + transparencia</span></p> </div> <a name='function.imagecolorclosestalpha.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>imagecolorclosestalpha</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$alpha</tt></span> )</div> <p class='para rdfs-comment'> Retorna o &amp;iacute;ndice da cor da paleta da imagem o qual seja mais &amp;quot;pr&amp;oacute;ximo&amp;quot; do valor <acronym title='Red-Green-Blue'>RGB</acronym> e de <i><tt class='parameter'>alpha</tt></i> level. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorexactalpha.php' class='function'>imagecolorexactalpha()</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="imagecolorclosest" value="<div id='function.imagecolorclosest' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorclosest.php'>imagecolorclosest</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorclosest</span> &amp;mdash; <span class='dc-title'>Retorna o &amp;iacute;ndice da cor mais pr&amp;oacute;xima da cor especificada</span></p> </div> <a name='function.imagecolorclosest.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>imagecolorclosest</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> )</div> <p class='para rdfs-comment'> Retorna o &amp;iacute;ndice da cor na paleta da imagem que seja mais &amp;quot;pr&amp;oacute;xima&amp;quot; do valor <acronym title='Red-Green-Blue'>RGB</acronym> especificado. </p> <p class='para'> A &amp;quot;distancia&amp;quot; entre a cor desejada e cada cor da paleta &amp;eacute; calculada como se os valores <acronym title='Red-Green-Blue'>RGB</acronym> representassem pontos em um espa&amp;ccedil;o tridimencional. </p> <p class='para'> Se voc&amp;ecirc; criou a imagem a partir de um arquivo, apenas as cores usadas na imagem s&amp;atilde;o resolvidas. Cores presentes apenas na paleta n&amp;atilde;o s&amp;atilde;o resolvidas. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorexact.php' class='function'>imagecolorexact()</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="imagecolorat" value="<div id='function.imagecolorat' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorat.php'>imagecolorat</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorat</span> &amp;mdash; <span class='dc-title'>Retorna o &amp;iacute;ndice da cor de um pixel</span></p> </div> <a name='function.imagecolorat.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>imagecolorat</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> )</div> <p class='para rdfs-comment'> Retorna o &amp;iacute;ndice da cor de um pixel no local especificado da imagem <i><tt class='parameter'>image</tt></i> . </p> <p class='para'> Se o PHP foi compilado com a biblioteca GD 2.0 ou superior e a imagem for truecolor, esta fun&amp;ccedil;&amp;atilde;o retorna o valor RGB deste pixel como um inteiro. Use bitshifting e masking para acessar os valores distintos dos componentes vermelho, verde e azul: </p> </div> <a name='function.imagecolorat.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Coordenada x do ponto </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Coordenada y do ponto </p> </dd> </dl> <p> </p> </div> <a name='function.imagecolorat.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns the index of the color. </p> </div> <a name='function.imagecolorat.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Acessando os valores RGB distintos</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'php.png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$rgb&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorat</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>15</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$r&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;(</span><span style='color: #0000BB'>$rgb&amp;nbsp;</span><span style='color: #007700'>&amp;gt;&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>16</span><span style='color: #007700'>)&amp;nbsp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$g&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;(</span><span style='color: #0000BB'>$rgb&amp;nbsp;</span><span style='color: #007700'>&amp;gt;&amp;gt;&amp;nbsp;</span><span style='color: #0000BB'>8</span><span style='color: #007700'>)&amp;nbsp;&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>0xFF</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'>$rgb&amp;nbsp;</span><span style='color: #007700'>&amp;amp;&amp;nbsp;</span><span style='color: #0000BB'>0xFF</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> int(119) int(123) int(180) </pre></div> </div> </div><p> </p> </div> <a name='function.imagecolorat.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.imagecolorset.php' class='function' rel='rdfs-seeAlso'>imagecolorset()</a> - Set the color for the specified palette index</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.imagecolorsforindex.php' class='function' rel='rdfs-seeAlso'>imagecolorsforindex()</a> - Retorna as cores de um &amp;iacute;ndice</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="imagecolorallocatealpha" value="<div id='function.imagecolorallocatealpha' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorallocatealpha.php'>imagecolorallocatealpha</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.2, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorallocatealpha</span> &amp;mdash; <span class='dc-title'>Aloca cor para uma imagem</span></p> </div> <a name='function.imagecolorallocatealpha.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>imagecolorallocatealpha</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$alpha</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecolorallocatealpha()</b> funciona identicamente a <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a> com a adi&amp;ccedil;&amp;atilde;o do par&amp;acirc;metro de transparencia <i><tt class='parameter'>alpha</tt></i> o qual deve ter um valor entre <i>0</i> e <i>127</i>. <i>0</i> indica completamente opaco enquanto <i>127</i> indica completamente transparente. </p> <p class='para'> Retorna <b><tt class='constant'>FALSE</tt></b> se falhar. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo de uso de <b>imagecolorallocatealpha()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$size&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>300</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$image</span><span style='color: #007700'>=</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$size</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$size</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;something&amp;nbsp;to&amp;nbsp;get&amp;nbsp;a&amp;nbsp;white&amp;nbsp;background&amp;nbsp;with&amp;nbsp;black&amp;nbsp;border<br /></span><span style='color: #0000BB'>$back&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$border&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$size&amp;nbsp;</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'>$size&amp;nbsp;</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'>$back</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagerectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$size&amp;nbsp;</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'>$size&amp;nbsp;</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'>$border</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$yellow_x&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$yellow_y&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>75</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$red_x&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>120</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$red_y&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>165</span><span style='color: #007700'>;&amp;nbsp;<br /></span><span style='color: #0000BB'>$blue_x&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>187</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$blue_y&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>125</span><span style='color: #007700'>;&amp;nbsp;<br /></span><span style='color: #0000BB'>$radius&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;allocate&amp;nbsp;colors&amp;nbsp;with&amp;nbsp;alpha&amp;nbsp;values<br /></span><span style='color: #0000BB'>$yellow&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocatealpha</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>75</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$red&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocatealpha</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>75</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$blue&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocatealpha</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>75</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;drawing&amp;nbsp;3&amp;nbsp;overlapped&amp;nbsp;circle<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$yellow_x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$yellow_y</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$radius</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$radius</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$yellow</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red_x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red_y</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$radius</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$radius</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$red</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #0000BB'>imagefilledellipse</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$blue_x</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$blue_y</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$radius</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$radius</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$blue</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;don't&amp;nbsp;forget&amp;nbsp;to&amp;nbsp;output&amp;nbsp;a&amp;nbsp;correct&amp;nbsp;header!<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;and&amp;nbsp;finally,&amp;nbsp;output&amp;nbsp;the&amp;nbsp;result<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</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>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocate.php' class='function'>imagecolorallocate()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecolordeallocate.php' class='function'>imagecolordeallocate()</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="imagecolorallocate" value="<div id='function.imagecolorallocate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecolorallocate.php'>imagecolorallocate</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecolorallocate</span> &amp;mdash; <span class='dc-title'>Aloca uma cor para uma imagem</span></p> </div> <a name='function.imagecolorallocate.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>imagecolorallocate</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$red</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$green</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$blue</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecolorallocate()</b> retorna um identificador de cor representando a cor composta pelos componentes <acronym title='Red-Green-Blue'>RGB</acronym>. Os argumentos <i><tt class='parameter'>image</tt></i> &amp;eacute; o retorno da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.imagecreate.php' class='function'>imagecreate()</a>. <i><tt class='parameter'>red</tt></i> , <i><tt class='parameter'>green</tt></i> and <i><tt class='parameter'>blue</tt></i> s&amp;atilde;o os valores de vermelho, azul e verde, respectivamente da cor solicitada. Estes par&amp;acirc;metros s&amp;atilde;o inteiros entre 0 e 255 ou hexadecimais entre 0x00 e 0xFF. <b>imagecolorallocate()</b> deve ser utilizada para cada cor que ser&amp;aacute; usada na imagem representada por <i><tt class='parameter'>image</tt></i> . </p> <blockquote><p><b class='note'>Nota</b>: A primeira utiliza&amp;ccedil;&amp;atilde;o da fun&amp;ccedil;&amp;atilde;o <b>imagecolorallocate()</b> prenche a cor do fundo. <br /> </p></blockquote> <p class='para'> </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 /><br /></span><span style='color: #FF8000'>//&amp;nbsp;define&amp;nbsp;o&amp;nbsp;fundo&amp;nbsp;como&amp;nbsp;vermelho<br /></span><span style='color: #0000BB'>$background&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;define&amp;nbsp;algumas&amp;nbsp;cores<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;do&amp;nbsp;jeito&amp;nbsp;hexadecimal<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0xFF</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0x00</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'> Retorna -1 se falhar. </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecolorallocatealpha.php' class='function'>imagecolorallocatealpha()</a> e <a href='http://www.php.net/manual/pt_BR/function.imagecolordeallocate.php' class='function'>imagecolordeallocate()</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="imagecharup" value="<div id='function.imagecharup' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagecharup.php'>imagecharup</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagecharup</span> &amp;mdash; <span class='dc-title'>Desenha um caractere verticalmente</span></p> </div> <a name='function.imagecharup.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>imagecharup</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$font</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$c</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagecharup()</b> desenha o caractere <i><tt class='parameter'>c</tt></i> verticalmente na imagem identificada por <i><tt class='parameter'>image</tt></i> nas coordenadas <i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> (em cima na esquerda &amp;eacute; 0, 0) com a cor <i><tt class='parameter'>color</tt></i> . Se <i><tt class='parameter'>font</tt></i> for 1, 2, 3, 4 ou 5, uam fonte interna &amp;eacute; usada. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagecharup()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'Note&amp;nbsp;that&amp;nbsp;the&amp;nbsp;first&amp;nbsp;letter&amp;nbsp;is&amp;nbsp;a&amp;nbsp;N'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;mostra&amp;nbsp;um&amp;nbsp;'Z'&amp;nbsp;preto&amp;nbsp;num&amp;nbsp;fundo&amp;nbsp;branco<br />//&amp;nbsp;na&amp;nbsp;realidade&amp;nbsp;um&amp;nbsp;'N'&amp;nbsp;de&amp;nbsp;lado<br /></span><span style='color: #0000BB'>imagecharup</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>3</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>10</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagechar.php' class='function'>imagechar()</a> e <a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function'>imageloadfont()</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="imagechar" value="<div id='function.imagechar' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagechar.php'>imagechar</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagechar</span> &amp;mdash; <span class='dc-title'>Desenha um caractere horizontalmente</span></p> </div> <a name='function.imagechar.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>imagechar</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$font</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$y</tt></span> , <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$c</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagechar()</b> desenha o primeiro caractere de <i><tt class='parameter'>c</tt></i> na imagem identificada por <i><tt class='parameter'>image</tt></i> com o canto superior esquerdo em <i><tt class='parameter'>x</tt></i> ,<i><tt class='parameter'>y</tt></i> (em cima a esquerda &amp;eacute; 0, 0) com a cor <i><tt class='parameter'>color</tt></i> . Se <i><tt class='parameter'>font</tt></i> for 1, 2, 3, 4 or 5, uma fonte interna &amp;eacute; usada (onde os n&amp;uacute;meros mais altos correspondem a fonter maiores). </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>imagechar()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'PHP'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$bg&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;mostra&amp;nbsp;um&amp;nbsp;'P'&amp;nbsp;preto&amp;nbsp;no&amp;nbsp;canto&amp;nbsp;superior&amp;nbsp;esquerdo<br /></span><span style='color: #0000BB'>imagechar</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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'>0</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'>$string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</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.imagecharup.php' class='function'>imagecharup()</a> e <a href='http://www.php.net/manual/pt_BR/function.imageloadfont.php' class='function'>imageloadfont()</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="imagearc" value="<div id='function.imagearc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagearc.php'>imagearc</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>imagearc</span> &amp;mdash; <span class='dc-title'>Desenha um elipse parcial</span></p> </div> <a name='function.imagearc.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>imagearc</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cx</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$cy</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$w</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$h</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$s</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$e</tt></span> , <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$color</tt></span> )</div> <p class='para rdfs-comment'> <b>imagearc()</b> desenha um elipse parcial centrado em <i><tt class='parameter'>cx</tt></i> , <i><tt class='parameter'>cy</tt></i> (o canto superior esquerdo &amp;eacute; 0, 0) na imagem representada por <i><tt class='parameter'>image</tt></i> . <i><tt class='parameter'>W</tt></i> e <i><tt class='parameter'>h</tt></i> representa respectivamente a largura e altura enquanto os pontos de in&amp;iacute;cio e final s&amp;atilde;o representados em graus pelos par&amp;acirc;metros <i><tt class='parameter'>s</tt></i> e <i><tt class='parameter'>e</tt></i> . 0&amp;deg; esta localizado na posi&amp;ccedil;&amp;atilde;o de tr&amp;ecirc;s horas, e o arco &amp;eacute; desenhado no sentido hor&amp;aacute;rio. </p> <div class='example'> <p><b>Exemplo #1 Desenhando um c&amp;iacute;rculo com <b>imagearc()</b></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;cria&amp;nbsp;uma&amp;nbsp;imagem&amp;nbsp;de&amp;nbsp;200&amp;nbsp;*&amp;nbsp;200<br /></span><span style='color: #0000BB'>$img&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>200</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>200</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;aloca&amp;nbsp;algumas&amp;nbsp;cores<br /></span><span style='color: #0000BB'>$white&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$black&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</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'>0</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>0</span><span style='color: #007700'>);&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #FF8000'>//&amp;nbsp;desenha&amp;nbsp;um&amp;nbsp;c&amp;iacute;rculo&amp;nbsp;preto&amp;nbsp;<br /></span><span style='color: #0000BB'>imagearc</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>150</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'>360</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$black</span><span style='color: #007700'>);&amp;nbsp;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;envia&amp;nbsp;a&amp;nbsp;imagem&amp;nbsp;para&amp;nbsp;o&amp;nbsp;browser<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;<br /></span><span style='color: #FF8000'>//&amp;nbsp;libera&amp;nbsp;a&amp;nbsp;m&amp;eacute;moria<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$img</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imageellipse.php' class='function'>imageellipse()</a>, <a href='http://www.php.net/manual/pt_BR/function.imagefilledellipse.php' class='function'>imagefilledellipse()</a>, e <a href='http://www.php.net/manual/pt_BR/function.imagefilledarc.php' class='function'>imagefilledarc()</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="imageantialias" value="<div id='function.imageantialias' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imageantialias.php'>imageantialias</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.2, PHP 5)</p><p class='refpurpose'><span class='refname'>imageantialias</span> &amp;mdash; <span class='dc-title'> Indica se as fun&amp;ccedil;&amp;otilde;es de antialias devem ser usadas ou n&amp;atilde;o </span></p> </div> <a name='function.imageantialias.unknown'></a><div class='refsect1 unknown'> <h3 class='title'>Description</h3> <div class='methodsynopsis dc-description'> <span class='type'>bool</span> <span class='methodname'><b>imageantialias</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$im</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$on</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> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'>Esta fun&amp;ccedil;&amp;atilde;o somente est&amp;aacute; dispon&amp;iacute;vel se o PHP estiver compilado com a vers&amp;atilde;o embarcada da biblioteca GD.</span></p></blockquote> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</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="imagealphablending" value="<div id='function.imagealphablending' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.imagealphablending.php'>imagealphablending</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.6, PHP 5)</p><p class='refpurpose'><span class='refname'>imagealphablending</span> &amp;mdash; <span class='dc-title'>Set the blending mode for an image</span></p> </div> <a name='function.imagealphablending.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>imagealphablending</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> , <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$blendmode</tt></span> )</div> <p class='para rdfs-comment'> <b>imagealphablending()</b> allows for two different modes of drawing on truecolor images. In blending mode, the alpha channel component of the color supplied to all drawing function, such as <a href='http://www.php.net/manual/pt_BR/function.imagesetpixel.php' class='function'>imagesetpixel()</a> determines how much of the underlying color should be allowed to shine through. As a result, gd automatically blends the existing color at that point with the drawing color, and stores the result in the image. The resulting pixel is opaque. In non-blending mode, the drawing color is copied literally with its alpha channel information, replacing the destination pixel. Blending mode is not available when drawing on palette images. </p> </div> <a name='function.imagealphablending.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>blendmode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Whether to enable the blending mode or not. Default to <b><tt class='constant'>FALSE</tt></b>. </p> </dd> </dl> <p> </p> </div> <a name='function.imagealphablending.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.imagealphablending.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 <b>imagealphablending()</b> usage example</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;Create&amp;nbsp;image<br /></span><span style='color: #0000BB'>$im&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatetruecolor</span><span style='color: #007700'>(</span><span style='color: #0000BB'>100</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>100</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Set&amp;nbsp;alphablending&amp;nbsp;to&amp;nbsp;on<br /></span><span style='color: #0000BB'>imagealphablending</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>true</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Draw&amp;nbsp;a&amp;nbsp;square<br /></span><span style='color: #0000BB'>imagefilledrectangle</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>30</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>70</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>70</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>imagecolorallocate</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>255</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'>0</span><span style='color: #007700'>));<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Output<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;image/png'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>imagepng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>imagedestroy</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$im</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> </div> <a name='function.imagealphablending.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 precisa do GD 2.0.1 ou posterior (2.0.28 ou posterior &amp;eacute; recomendado).</span></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="image2wbmp" value="<div id='function.image2wbmp' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.image2wbmp.php'>image2wbmp</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.0.5, PHP 5)</p><p class='refpurpose'><span class='refname'>image2wbmp</span> &amp;mdash; <span class='dc-title'>Envia uma imagem para o browser ou arquivo</span></p> </div> <a name='function.image2wbmp.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>image2wbmp</b></span> ( <span class='methodparam'><span class='type'>resource</span> <tt class='parameter'>$image</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$threshold</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>image2wbmp()</b> mostra ou salva uma vers&amp;atilde;o <acronym title='Wireless Bitmap'>WBMP</acronym> de uma dada <i><tt class='parameter'>image</tt></i> . </p> </div> <a name='function.image2wbmp.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'> image</tt></i> </span> </dt><dd class='listitem'> <p class='para'>An image resource, returned by one of the image creation functions, such as <a href='http://www.php.net/manual/pt_BR/function.imagecreatetruecolor.php' class='function'>imagecreatetruecolor()</a>.</p></dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>filename</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Caminho para salvar o arquivo. Se n&amp;atilde;o informado, a imagem ser&amp;aacute; mostrada diretamente. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>threshold</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p> </dd> </dl> <p> </p> </div> <a name='function.image2wbmp.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.image2wbmp.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>image2wbmp()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br /><br />$file&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'php.png'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>$image&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>imagecreatefrompng</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$file</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>image_type_to_mime_type</span><span style='color: #007700'>(</span><span style='color: #0000BB'>IMAGETYPE_WBMP</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>image2wbmp</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$image</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;output&amp;nbsp;the&amp;nbsp;stream&amp;nbsp;directly<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.image2wbmp.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Suporte a WBMP esta dispon&amp;iacute;vel somente se o PHP foi compilado com a GD-1.8 ou posterior. <br /> </p></blockquote> </div> <a name='function.image2wbmp.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.imagewbmp.php' class='function' rel='rdfs-seeAlso'>imagewbmp()</a> - Envia uma imagem para o browser ou arquivo</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="ignore_user_abort" value="<div id='function.ignore-user-abort' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.ignore-user-abort.php'>ignore_user_abort</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>ignore_user_abort</span> &amp;mdash; <span class='dc-title'>Estabelece se acontecer&amp;aacute; o encerramento do script quando o usu&amp;aacute;rio abortar a conex&amp;atilde;o</span></p> </div> <a name='function.ignore-user-abort.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>ignore_user_abort</b></span> ([ <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$setting</tt></span> ] )</div> <p class='para rdfs-comment'> Estabelece se um cliente desconectado causa abortagem da conex&amp;atilde;o. </p> </div> <a name='function.ignore-user-abort.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'>setting</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se n&amp;atilde;o &amp;eacute; definido, a fun&amp;ccedil;&amp;atilde;o ir&amp;aacute; somente retorna a configura&amp;ccedil;&amp;atilde;o atual. </p> </dd> </dl> <p> </p> </div> <a name='function.ignore-user-abort.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a configura&amp;ccedil;&amp;atilde;o anterior, como booleano. </p> </div> <a name='function.ignore-user-abort.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <p class='para'> PHP n&amp;atilde;o ir&amp;aacute; detectar que o usu&amp;aacute;rio tenha abortado a conex&amp;atilde;o at&amp;eacute; tentar enviar alguma informa&amp;ccedil;&amp;atilde;o para o cliente. Simplesmente usando um comando echo n&amp;atilde;o &amp;eacute; garantido que a informa&amp;ccedil;&amp;atilde;o seja enviada, veja <a href='http://www.php.net/manual/pt_BR/function.flush.php' class='function'>flush()</a>. </p> </div> <a name='function.ignore-user-abort.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.connection-aborted.php' class='function' rel='rdfs-seeAlso'>connection_aborted()</a> - Verifica se o cliente est&amp;aacute; desconectado</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.connection-status.php' class='function' rel='rdfs-seeAlso'>connection_status()</a> - Retorna o status da conex&amp;atilde;o</li> <li class='member'> <a href='http://www.php.net/manual/pt_BR/features.connection-handling.php' class='link'>Tratamento de conex&amp;otilde;es</a> para uma descri&amp;ccedil;&amp;atilde;o completa do tratamento de conex&amp;atilde;o no PHP. </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="idate" value="<div id='function.idate' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.idate.php'>idate</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>idate</span> &amp;mdash; <span class='dc-title'>Format a local time/date as integer</span></p> </div> <a name='function.idate.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>idate</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$format</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$timestamp</tt><span class='initializer'> = time()</span></span> ] )</div> <p class='para rdfs-comment'> Returns a number formatted according to the given format string using the given integer <i><tt class='parameter'>timestamp</tt></i> or the current local time if no timestamp is given. In other words, <i><tt class='parameter'>timestamp</tt></i> is optional and defaults to the value of <a href='http://www.php.net/manual/pt_BR/function.time.php' class='function'>time()</a>. </p> <p class='para'> Unlike the function <a href='http://www.php.net/manual/pt_BR/function.date.php' class='function'>date()</a>, <b>idate()</b> accepts just one char in the <i><tt class='parameter'>format</tt></i> parameter. </p> </div> <a name='function.idate.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'>format</tt></i> </span> </dt><dd class='listitem'> <p class='para'> </p><table class='doctable table'> <caption><b>The following characters are recognized in the <i><tt class='parameter'>format</tt></i> parameter string</b></caption> <thead valign='middle'> <tr valign='middle'> <th><i><tt class='parameter'>format</tt></i> character</th> <th>Description</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><i>B</i></td> <td align='left'>Swatch Beat/Internet Time</td> </tr> <tr valign='middle'> <td align='left'><i>d</i></td> <td align='left'>Day of the month</td> </tr> <tr valign='middle'> <td align='left'><i>h</i></td> <td align='left'>Hour (12 hour format)</td> </tr> <tr valign='middle'> <td align='left'><i>H</i></td> <td align='left'>Hour (24 hour format)</td> </tr> <tr valign='middle'> <td align='left'><i>i</i></td> <td align='left'>Minutes</td> </tr> <tr valign='middle'> <td align='left'><i>I</i> (uppercase i)</td> <td align='left'>returns <i>1</i> if DST is activated, <i>0</i> otherwise</td> </tr> <tr valign='middle'> <td align='left'><i>L</i> (uppercase l)</td> <td align='left'>returns <i>1</i> for leap year, <i>0</i> otherwise</td> </tr> <tr valign='middle'> <td align='left'><i>m</i></td> <td align='left'>Month number</td> </tr> <tr valign='middle'> <td align='left'><i>s</i></td> <td align='left'>Seconds</td> </tr> <tr valign='middle'> <td align='left'><i>t</i></td> <td align='left'>Days in current month</td> </tr> <tr valign='middle'> <td align='left'><i>U</i></td> <td align='left'>Seconds since the Unix Epoch - January 1 1970 00:00:00 UTC - this is the same as <a href='http://www.php.net/manual/pt_BR/function.time.php' class='function'>time()</a></td> </tr> <tr valign='middle'> <td align='left'><i>w</i></td> <td align='left'>Day of the week (<i>0</i> on Sunday)</td> </tr> <tr valign='middle'> <td align='left'><i>W</i></td> <td align='left'>ISO-8601 week number of year, weeks starting on Monday</td> </tr> <tr valign='middle'> <td align='left'><i>y</i></td> <td align='left'>Year (1 or 2 digits - check note below)</td> </tr> <tr valign='middle'> <td align='left'><i>Y</i></td> <td align='left'>Year (4 digits)</td> </tr> <tr valign='middle'> <td align='left'><i>z</i></td> <td align='left'>Day of the year</td> </tr> <tr valign='middle'> <td align='left'><i>Z</i></td> <td align='left'>Timezone offset in seconds</td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>timestamp</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O par&amp;acirc;metro opcional <i><tt class='parameter'>timestamp</tt></i> &amp;eacute; um <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> Unix timestamp cujo padr&amp;atilde;o &amp;eacute; a hora local se <i><tt class='parameter'>timestamp</tt></i> n&amp;atilde;o for dado. Em outras palavras, o padr&amp;atilde;o &amp;eacute; o valor de <a href='http://www.php.net/manual/pt_BR/function.time.php' class='function'>time()</a>. </p></dd> </dl> <p> </p> </div> <a name='function.idate.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns an <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a>. </p> <p class='para'> As <b>idate()</b> always returns an <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> and as they can&amp;#039;t start with a &amp;quot;0&amp;quot;, <b>idate()</b> may return fewer digits than you would expect. See the example below. </p> </div> <a name='function.idate.errors'></a><div class='refsect1 errors'> <h3 class='title'>Erros</h3> <p class='para'> Toda a chamada a uma fun&amp;ccedil;&amp;atilde;o de data/hora ir&amp;aacute; gerar um se a zona da hora n&amp;atilde;o for valida, e/ou uma mensagem <b><tt class='constant'>E_STRICT</tt></b> ou <b><tt class='constant'>E_WARNING</tt></b> se estiver usando a defini&amp;ccedil;&amp;atilde;o do sistema ou a vari&amp;aacute;vel de ambiente <var class='varname'>TZ</var>. Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.date-default-timezone-set.php' class='function'>date_default_timezone_set()</a></p> </div> <a name='function.idate.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.1.0</td><td align='left'><p class='para'> Agora emite <b><tt class='constant'>E_STRICT</tt></b> e <b><tt class='constant'>E_NOTICE</tt></b> em erros da zona de hor&amp;aacute;rio.</p></td></tr> </tbody> </table> <p> </p> </div> <a name='function.idate.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 <b>idate()</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 />$timestamp&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>strtotime</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'1st&amp;nbsp;January&amp;nbsp;2004'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//1072915200<br /><br />//&amp;nbsp;this&amp;nbsp;prints&amp;nbsp;the&amp;nbsp;year&amp;nbsp;in&amp;nbsp;a&amp;nbsp;two&amp;nbsp;digit&amp;nbsp;format<br />//&amp;nbsp;however,&amp;nbsp;as&amp;nbsp;this&amp;nbsp;would&amp;nbsp;start&amp;nbsp;with&amp;nbsp;a&amp;nbsp;'0',&amp;nbsp;it<br />//&amp;nbsp;only&amp;nbsp;prints&amp;nbsp;'4'<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>idate</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'y'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$timestamp</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.idate.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.date.php' class='function' rel='rdfs-seeAlso'>date()</a> - Formata a data e a hora local</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.time.php' class='function' rel='rdfs-seeAlso'>time()</a> - Retorna o timestamp Unix atual</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="hypot" value="<div id='function.hypot' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.hypot.php'>hypot</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.1.0, PHP 5)</p><p class='refpurpose'><span class='refname'>hypot</span> &amp;mdash; <span class='dc-title'> Calcula o tamanho da hipotenusa de um &amp;acirc;ngulo reto do tri&amp;acirc;ngulo Retorna a raiz quadrada de (num1*num1 + num2*num2) </span></p> </div> <a name='function.hypot.description'></a><div class='refsect1 description'> <h3 class='title'>Descri&amp;ccedil;&amp;atilde;o</h3> <div class='methodsynopsis dc-description'> <span class='type'>float</span> <span class='methodname'><b>hypot</b></span> ( <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$x</tt></span> , <span class='methodparam'><span class='type'>float</span> <tt class='parameter'>$y</tt></span> )</div> <p class='para rdfs-comment'> <b>hypot()</b> retorna o tamanho da hipotenusa de um &amp;acirc;ngulo reto do tri&amp;acirc;ngulo com lado de tamanho <i><tt class='parameter'>x</tt></i> e <i><tt class='parameter'>y</tt></i> , ou a dist&amp;acirc;ncia do ponto (<i><tt class='parameter'>x</tt></i> , <i><tt class='parameter'>y</tt></i> ) de uma origem. O equivalente a <i>sqrt(x*x + y*y)</i>. </p> </div> <a name='function.hypot.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'>x</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Tamanho do primeiro lado </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>y</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Tamanho do segundo lado </p> </dd> </dl> <p> </p> </div> <a name='function.hypot.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Tamanho calculado da hipotenusa </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="http_build_query" value="<div id='function.http-build-query' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.http-build-query.php'>http_build_query</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>http_build_query</span> &amp;mdash; <span class='dc-title'>Gera a string de consulta (query) em formato URL</span></p> </div> <a name='function.http-build-query.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>http_build_query</b></span> ( <span class='methodparam'><span class='type'>array</span> <tt class='parameter'>$formdata</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$numeric_prefix</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$arg_separator</tt></span> ]] )</div> <p class='para rdfs-comment'> Gera a string de consulta (query) em formato URL a partir de um array associativo (ou indexado). </p> </div> <a name='function.http-build-query.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'>formdata</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Pode ser uma array ou objeto contendo propriedades. </p> <p class='para'> O array form pode ser uma estrutura simples, unidimensional, ou um array de arrays (que, por sua vez, pode contar outros array). </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>numeric_prefix</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Se &amp;iacute;ndices num&amp;eacute;ricos s&amp;atilde;o usados no array base e esse par&amp;acirc;metro for fornecido, o n&amp;uacute;mero &amp;iacute;ndice dos elementos ser&amp;aacute; prefixado com seu valor, apenas no array base. </p> <p class='para'> Isso &amp;eacute; feito para permitir nomes de vari&amp;aacute;veis aceit&amp;aacute;veis quando os dados forem decodificados pelo PHP ou por outra aplica&amp;ccedil;&amp;atilde;o CGI posteriormente. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>arg_separator</tt></i> </span> </dt><dd class='listitem'> <p class='para'> <a href='http://www.php.net/manual/pt_BR/ini.core.php#ini.arg-separator.output' class='link'>arg_separator.output</a> &amp;eacute; usado para separar argumentos, a n&amp;atilde;o que esse par&amp;acirc;metro seja especificado. Nesse caso, o valor passado &amp;eacute; usado como separador. </p> </dd> </dl> <p> </p> </div> <a name='function.http-build-query.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna um string no formato de uma URL. </p> </div> <a name='function.http-build-query.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.1.2</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>arg_separator</tt></i> foi adicionao. </td> </tr> <tr valign='middle'> <td align='left'>5.1.3</td> <td align='left'> colchetes s&amp;atilde;o escapados, ou seja, recebem um caracter de controle. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.http-build-query.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <div class='example'> <p><b>Exemplo #1 Exemplo de uso de <b>http_build_query()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'foo'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'bar'</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'>'baz'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'boom'</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'>'cow'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'milk'</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'>'php'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'hypertext&amp;nbsp;processor'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>http_build_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;foo=bar&amp;amp;baz=boom&amp;amp;cow=milk&amp;amp;php=hypertext+processor<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>http_build_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>''</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'&amp;amp;amp;'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;foo=bar&amp;amp;amp;baz=boom&amp;amp;amp;cow=milk&amp;amp;amp;php=hypertext+processor<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> <div class='example'> <p><b>Exemplo #2 <b>http_build_query()</b> com elementos indexados numericamente.</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'foo'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'bar'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'baz'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'boom'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'cow'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;&amp;nbsp;</span><span style='color: #DD0000'>'milk'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'php'&amp;nbsp;</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'hypertext&amp;nbsp;processor'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>http_build_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'\n'</span><span style='color: #007700'>;<br />echo&amp;nbsp;</span><span style='color: #0000BB'>http_build_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'myvar_'</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> 0=foo&amp;amp;1=bar&amp;amp;2=baz&amp;amp;3=boom&amp;amp;cow=milk&amp;amp;php=hypertext+processor myvar_0=foo&amp;amp;myvar_1=bar&amp;amp;myvar_2=baz&amp;amp;myvar_3=boom&amp;amp;cow=milk&amp;amp;php=hypertext+processor </pre></div> </div> </div> <div class='example'> <p><b>Exemplo #3 <b>http_build_query()</b> com arrays complexos</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;array(</span><span style='color: #DD0000'>'user'</span><span style='color: #007700'>=&amp;gt;array(</span><span style='color: #DD0000'>'name'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'Bob&amp;nbsp;Smith'</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'age'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>47</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'sex'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'M'</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'dob'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'5/12/1956'</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'>'pastimes'</span><span style='color: #007700'>=&amp;gt;array(</span><span style='color: #DD0000'>'golf'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'opera'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'poker'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'rap'</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'>'children'</span><span style='color: #007700'>=&amp;gt;array(</span><span style='color: #DD0000'>'bobby'</span><span style='color: #007700'>=&amp;gt;array(</span><span style='color: #DD0000'>'age'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>12</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;&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'>'sex'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'M'</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;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #DD0000'>'sally'</span><span style='color: #007700'>=&amp;gt;array(</span><span style='color: #DD0000'>'age'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #0000BB'>8</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;&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'>'sex'</span><span style='color: #007700'>=&amp;gt;</span><span style='color: #DD0000'>'F'</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'>'CEO'</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>http_build_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'flags_'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> isso resultar&amp;aacute; : (quebra de linhas para legibilidade) </p></div> <div class='example-contents screen'> <div class='cdata'><pre> user%5Bname%5D=Bob+Smith&amp;amp;user%5Bage%5D=47&amp;amp;user%5Bsex%5D=M&amp;amp; user%5Bdob%5D=5%2F12%2F1956&amp;amp;pastimes%5B0%5D=golf&amp;amp;pastimes%5B1%5D=opera&amp;amp; pastimes%5B2%5D=poker&amp;amp;pastimes%5B3%5D=rap&amp;amp;children%5Bbobby%5D%5Bage%5D=12&amp;amp; children%5Bbobby%5D%5Bsex%5D=M&amp;amp;children%5Bsally%5D%5Bage%5D=8&amp;amp; children%5Bsally%5D%5Bsex%5D=F&amp;amp;flags_0=CEO </pre></div> </div> <div class='example-contents para'><p> </p><blockquote><p><b class='note'>Nota</b>: Apenas o elemento indexado numericamente no array base &amp;quot;CEO&amp;quot; recebeu um prefixo. Os outros &amp;iacute;ndices num&amp;eacute;ricos, encontrados abaixo de &amp;quot;pastimes&amp;quot;, n&amp;atilde;o requerem uma string de prefixo para serem nomes de vari&amp;aacute;veis aceit&amp;aacute;veis. <br /> </p></blockquote><p> </p></div> </div> <div class='example'> <p><b>Exemplo #4 Usando <b>http_build_query()</b> com um objeto</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: #007700'>class&amp;nbsp;</span><span style='color: #0000BB'>myClass&amp;nbsp;</span><span style='color: #007700'>{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;var&amp;nbsp;</span><span style='color: #0000BB'>$foo</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;var&amp;nbsp;</span><span style='color: #0000BB'>$baz</span><span style='color: #007700'>;<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;function&amp;nbsp;</span><span style='color: #0000BB'>myClass</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'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>foo&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'bar'</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'>$this</span><span style='color: #007700'>-&amp;gt;</span><span style='color: #0000BB'>baz&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'boom'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;}<br />}<br /><br /></span><span style='color: #0000BB'>$data&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;new&amp;nbsp;</span><span style='color: #0000BB'>myClass</span><span style='color: #007700'>();<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>http_build_query</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$data</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;foo=bar&amp;amp;baz=boom<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div> </div> <a name='function.http-build-query.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.parse-str.php' class='function' rel='rdfs-seeAlso'>parse_str()</a> - Converte a string em vari&amp;aacute;veis</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.parse-url.php' class='function' rel='rdfs-seeAlso'>parse_url()</a> - Interpreta uma URL e retorna os seus componentes</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.urlencode.php' class='function' rel='rdfs-seeAlso'>urlencode()</a> - Codifica uma URL</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.array-walk.php' class='function' rel='rdfs-seeAlso'>array_walk()</a> - Aplica uma determinada func&amp;atilde;o em cada elemento de 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="html_entity_decode" value="<div id='function.html-entity-decode' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.html-entity-decode.php'>html_entity_decode</a></h1> <p class='verinfo'>(PHP 4 &amp;gt;= 4.3.0, PHP 5)</p><p class='refpurpose'><span class='refname'>html_entity_decode</span> &amp;mdash; <span class='dc-title'>Converte todas as entidades HTML para os seus caracteres</span></p> </div> <a name='function.html-entity-decode.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>html_entity_decode</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$quote_style</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>html_entity_decode()</b> &amp;eacute; o oposto da fun&amp;ccedil;&amp;atilde;o <a href='http://www.php.net/manual/pt_BR/function.htmlentities.php' class='function'>htmlentities()</a> no que converte todas as entidades HTML para os seus caracteres de <i><tt class='parameter'>string</tt></i> . </p> </div> <a name='function.html-entity-decode.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string de entrada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>quote_style</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O segundo par&amp;acirc;metro, que &amp;eacute; opcional, <i><tt class='parameter'>quote_style</tt></i> permite voc&amp;ecirc; definir o que ser&amp;aacute; feito com &amp;#039;apostrofos&amp;#039; e &amp;quot;aspas&amp;quot;. Ele recebe uma constante entre tr&amp;ecirc;s, sendo o padr&amp;atilde;o <b><tt class='constant'>ENT_COMPAT</tt></b>: </p><table class='doctable table'> <caption><b>Constantes dispon&amp;iacute;veis para <i><tt class='parameter'>quote_style</tt></i> </b></caption> <thead valign='middle'> <tr valign='middle'> <th>Nome da Constante</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_COMPAT</tt></b></td> <td align='left'>Ir&amp;aacute; converter aspas e deixar os apostrofos.</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_QUOTES</tt></b></td> <td align='left'>Ir&amp;aacute; converter ambos.</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_NOQUOTES</tt></b></td> <td align='left'>Ir&amp;aacute; deixar ambos sem converter.</td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>charset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O conjunto de caracteres ISO-8859-1 &amp;eacute; usado como padr&amp;atilde;o para o terceiro par&amp;acirc;metro, que &amp;eacute; opcional, <i><tt class='parameter'>charset</tt></i> . Este define o conjunto de caracteres usado na convers&amp;atilde;o. </p> <p class='para'> Os seguintes conjuntos de caracteres s&amp;atilde;o suportados no PHP 4.3.0 e posterior. </p><table class='doctable table'> <caption><b>Conjuntos de caracteres suportados</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Conjunto de caracteres</th> <th>Apelidos</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>ISO-8859-1</td> <td align='left'>ISO8859-1</td> <td align='left'> Western European, Latin-1 </td> </tr> <tr valign='middle'> <td align='left'>ISO-8859-15</td> <td align='left'>ISO8859-15</td> <td align='left'> Western European, Latin-9. Adiciona o s&amp;iacute;mbolo do Euro, letras Francesas e Filandesas faltando no Latin-1(ISO-8859-1). </td> </tr> <tr valign='middle'> <td align='left'>UTF-8</td> <td class='empty'>&amp;nbsp;</td> <td align='left'> C&amp;oacute;digo de multi-byte 8-bit Unicode compat&amp;iacute;vel com ASCII. </td> </tr> <tr valign='middle'> <td align='left'>cp866</td> <td align='left'>ibm866, 866</td> <td align='left'> Conjunto de caracteres do DOS espec&amp;iacute;fico para o Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>cp1251</td> <td align='left'>Windows-1251, win-1251, 1251</td> <td align='left'> Conjunto de caracteres do Windows espec&amp;iacute;fico para o Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>cp1252</td> <td align='left'>Windows-1252, 1252</td> <td align='left'> Conjunto de caracteres do Windows espec&amp;iacute;fico para a Europa Ocidental. </td> </tr> <tr valign='middle'> <td align='left'>KOI8-R</td> <td align='left'>koi8-ru, koi8r</td> <td align='left'> Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>BIG5</td> <td align='left'>950</td> <td align='left'> Chin&amp;ecirc;s Tradicional, usado principalmente em Taiwan. </td> </tr> <tr valign='middle'> <td align='left'>GB2312</td> <td align='left'>936</td> <td align='left'> Chins Simplificado, conjunto de caracteres padr&amp;atilde;o nacional. </td> </tr> <tr valign='middle'> <td align='left'>BIG5-HKSCS</td> <td class='empty'>&amp;nbsp;</td> <td align='left'> Big5 com exten&amp;ccedil;&amp;otilde;es de Hong Kong, Chin&amp;ecirc;s Tradicional. </td> </tr> <tr valign='middle'> <td align='left'>Shift_JIS</td> <td align='left'>SJIS, 932</td> <td align='left'> Japon&amp;ecirc;s </td> </tr> <tr valign='middle'> <td align='left'>EUC-JP</td> <td align='left'>EUCJP</td> <td align='left'> Japon&amp;ecirc;s </td> </tr> </tbody> </table> <p> </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> Qualquer outro conjunto de caracteres n&amp;atilde;o &amp;eacute; reconhecido e ser&amp;aacute; usado o ISO-8859-1. </span> </p></blockquote><p> </p> </dd> </dl> <p> </p> </div> <a name='function.html-entity-decode.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a string decodificada. </p> </div> <a name='function.html-entity-decode.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.0.0</td> <td align='left'> Suporte para conjunto de caracteres multi-byte foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.html-entity-decode.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Decodificando entidades HTML</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$orig&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'I'll&amp;nbsp;\'walk\'&amp;nbsp;the&amp;nbsp;&amp;lt;b&amp;gt;dog&amp;lt;/b&amp;gt;&amp;nbsp;now'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #0000BB'>$a&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>htmlentities</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$orig</span><span style='color: #007700'>);<br /><br /></span><span style='color: #0000BB'>$b&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>html_entity_decode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;I'll&amp;nbsp;&amp;amp;quot;walk&amp;amp;quot;&amp;nbsp;the&amp;nbsp;&amp;amp;lt;b&amp;amp;gt;dog&amp;amp;lt;/b&amp;amp;gt;&amp;nbsp;now<br /><br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>$b</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;I'll&amp;nbsp;'walk'&amp;nbsp;the&amp;nbsp;&amp;lt;b&amp;gt;dog&amp;lt;/b&amp;gt;&amp;nbsp;now<br /><br /><br />//&amp;nbsp;For&amp;nbsp;users&amp;nbsp;prior&amp;nbsp;to&amp;nbsp;PHP&amp;nbsp;4.3.0&amp;nbsp;you&amp;nbsp;may&amp;nbsp;do&amp;nbsp;this:<br /></span><span style='color: #007700'>function&amp;nbsp;</span><span style='color: #0000BB'>unhtmlentities</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$string</span><span style='color: #007700'>)&amp;nbsp;<br />{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;replace&amp;nbsp;numeric&amp;nbsp;entities<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>preg_replace</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'~&amp;amp;#x([0-9a-f]+);~ei'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'chr(hexdec('\\1'))'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$string</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$string&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>preg_replace</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'~&amp;amp;#([0-9]+);~e'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'chr('\\1')'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$string</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;replace&amp;nbsp;literal&amp;nbsp;entities<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$trans_tbl&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>get_html_translation_table</span><span style='color: #007700'>(</span><span style='color: #0000BB'>HTML_ENTITIES</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>$trans_tbl&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>array_flip</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$trans_tbl</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;return&amp;nbsp;</span><span style='color: #0000BB'>strtr</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$string</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$trans_tbl</span><span style='color: #007700'>);<br />}<br /><br /></span><span style='color: #0000BB'>$c&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>unhtmlentities</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$a</span><span style='color: #007700'>);<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>$c</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;I'll&amp;nbsp;'walk'&amp;nbsp;the&amp;nbsp;&amp;lt;b&amp;gt;dog&amp;lt;/b&amp;gt;&amp;nbsp;now<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.html-entity-decode.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: Voc&amp;ecirc; deve imaginar porque trim(html_entity_decode(&amp;#039;&amp;amp;nbsp;&amp;#039;)); n&amp;atilde;o reduz a string para uma string vazia, isto &amp;eacute; porque a entidade &amp;#039;&amp;amp;nbsp;&amp;#039; n&amp;atilde;o &amp;eacute; o c&amp;oacute;digo ASCII 32 (o qual &amp;eacute; retirado por <a href='http://www.php.net/manual/pt_BR/function.trim.php' class='function'>trim()</a>) mas o caracter ASCII 160 (0xa0) no conjunto de caracteres padr&amp;atilde;o. <br /> </p></blockquote> </div> <a name='function.html-entity-decode.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.htmlentities.php' class='function' rel='rdfs-seeAlso'>htmlentities()</a> - Converte todos os caracteres aplic&amp;aacute;veis em entidades html.</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.htmlspecialchars.php' class='function' rel='rdfs-seeAlso'>htmlspecialchars()</a> - Converte caracteres especiais para a realidade HTML</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.get-html-translation-table.php' class='function' rel='rdfs-seeAlso'>get_html_translation_table()</a> - Retorna a tabela de tradu&amp;ccedil;&amp;atilde;o usada por htmlspecialchars e htmlentities</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.urldecode.php' class='function' rel='rdfs-seeAlso'>urldecode()</a> - Decodifica uma URL codificada</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="htmlspecialchars_decode" value="<div id='function.htmlspecialchars-decode' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.htmlspecialchars-decode.php'>htmlspecialchars_decode</a></h1> <p class='verinfo'>(PHP 5 &amp;gt;= 5.1.0)</p><p class='refpurpose'><span class='refname'>htmlspecialchars_decode</span> &amp;mdash; <span class='dc-title'> Converte especiais entidades HTML para caracteres </span></p> </div> <a name='function.htmlspecialchars-decode.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>htmlspecialchars_decode</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$quote_style</tt></span> ] )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; o oposto da <a href='http://www.php.net/manual/pt_BR/function.htmlspecialchars.php' class='function'>htmlspecialchars()</a>. Ela converte especiais entidades HTML para caracteres. </p> <p class='para'> As entidades convertidas s&amp;atilde;o: <i>&amp;amp;amp;</i>, <i>&amp;amp;quot;</i> (quando ENT_NOQUOTES n&amp;atilde;o &amp;eacute; usado), <i>&amp;amp;#039;</i> (quando ENT_QUOTES &amp;eacute; usado), <i>&amp;amp;lt;</i> e <i>&amp;amp;gt;</i>. </p> </div> <a name='function.htmlspecialchars-decode.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string para decodificar </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>quote_style</tt></i> </span> </dt><dd class='listitem'> <p class='para'> O tipo de aspa. Uma das seguintes constantes: </p><table class='doctable table'> <caption><b>Constantes do quote_style</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Nome da constante</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_COMPAT</tt></b></td> <td align='left'>Converter&amp;aacute; aspas dupla e deixar&amp;aacute; aspas simples (default)</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_QUOTES</tt></b></td> <td align='left'>Converter&amp;aacute; ambas as aspas</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_NOQUOTES</tt></b></td> <td align='left'>Deixar&amp;aacute; ambas as aspas</td> </tr> </tbody> </table> <p> </p> </dd> </dl> <p> </p> </div> <a name='function.htmlspecialchars-decode.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a string decodificada. </p> </div> <a name='function.htmlspecialchars-decode.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Um exemplo da <b>htmlspecialchars_decode()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;p&amp;gt;this&amp;nbsp;-&amp;amp;gt;&amp;nbsp;&amp;amp;quot;&amp;lt;/p&amp;gt;'</span><span style='color: #007700'>;<br /><br />echo&amp;nbsp;</span><span style='color: #0000BB'>htmlspecialchars_decode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;note&amp;nbsp;that&amp;nbsp;here&amp;nbsp;the&amp;nbsp;quotes&amp;nbsp;aren't&amp;nbsp;converted<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>htmlspecialchars_decode</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>ENT_NOQUOTES</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> &amp;lt;p&amp;gt;this -&amp;gt; &amp;quot;&amp;lt;/p&amp;gt; &amp;lt;p&amp;gt;this -&amp;gt; &amp;amp;quot;&amp;lt;/p&amp;gt; </pre></div> </div> </div><p> </p> </div> <a name='function.htmlspecialchars-decode.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.htmlspecialchars.php' class='function' rel='rdfs-seeAlso'>htmlspecialchars()</a> - Converte caracteres especiais para a realidade HTML</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.html-entity-decode.php' class='function' rel='rdfs-seeAlso'>html_entity_decode()</a> - Converte todas as entidades HTML para os seus caracteres</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.get-html-translation-table.php' class='function' rel='rdfs-seeAlso'>get_html_translation_table()</a> - Retorna a tabela de tradu&amp;ccedil;&amp;atilde;o usada por htmlspecialchars e htmlentities</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="htmlspecialchars" value="<div id='function.htmlspecialchars' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.htmlspecialchars.php'>htmlspecialchars</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>htmlspecialchars</span> &amp;mdash; <span class='dc-title'> Converte caracteres especiais para a realidade HTML </span></p> </div> <a name='function.htmlspecialchars.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>htmlspecialchars</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$quote_style</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> ]] )</div> <p class='para rdfs-comment'> Certos caracteres tem significado especial em HTML, e seriam representados pela realidade HTML se eles est&amp;atilde;o preservanado seus significados. Esta fun&amp;ccedil;&amp;atilde;o retorna uma string com algumas destas convers&amp;otilde;es feitas; As transforma&amp;ccedil;&amp;otilde;es feitas s&amp;atilde;o aquelas mais &amp;uacute;teis para programa&amp;ccedil;&amp;atilde;o web. Se voc&amp;ecirc; precisa que sejam transformados todos os caracteres da realidade HTML, use <a href='http://www.php.net/manual/pt_BR/function.htmlentities.php' class='function'>htmlentities()</a> no lugar dela. </p> <p class='simpara'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; &amp;uacute;til na preven&amp;ccedil;&amp;atilde;o de textos fornecidos pelo usu&amp;aacute;rio contendo marca&amp;ccedil;&amp;atilde;o HTML, tal como um quadro de mensgens ou guest book. O segundo argumento opcional, <i><tt class='parameter'>quote_style</tt></i> , conta &amp;agrave; fun&amp;ccedil;&amp;atilde;o o que fazer com os caracteres aspas simples e dupla. O modo padr&amp;atilde;o, <b><tt class='constant'>ENT_COMPAT</tt></b>, &amp;eacute; o modo mais compat&amp;iacute;vel com a atualidade, apenas transforma a aspas-dupla e deixa a aspas-simples como est&amp;aacute;. Se <b><tt class='constant'>ENT_QUOTES</tt></b> est&amp;aacute; definida, ambas transformadas e se <b><tt class='constant'>ENT_NOQUOTES</tt></b> est&amp;aacute; definida nenhuma das duas s&amp;atilde;o modificadas. </p> <p class='para'> As tradu&amp;ccedil;&amp;otilde;es executadas s&amp;atilde;o: </p><ul class='itemizedlist'> <li class='listitem'> <span class='simpara'> &amp;#039;&amp;amp;&amp;#039; (ampersand) torna-se &amp;#039;&amp;amp;amp;&amp;#039; </span> </li> <li class='listitem'> <span class='simpara'> &amp;#039;&amp;quot;&amp;#039; (aspas dupla) torna-se &amp;#039;&amp;amp;quot;&amp;#039; quando <b><tt class='constant'>ENT_NOQUOTES</tt></b> n&amp;atilde;o est&amp;aacute; definida. </span> </li> <li class='listitem'> <span class='simpara'> &amp;#039;&amp;#039;&amp;#039; (aspas simples) torna-se &amp;#039;&amp;amp;#039;&amp;#039; apenas quando <b><tt class='constant'>ENT_QUOTES</tt></b> est&amp;aacute; definida. </span> </li> <li class='listitem'> <span class='simpara'> &amp;#039;&amp;lt;&amp;#039; (menor que) torna-se &amp;#039;&amp;amp;lt;&amp;#039; </span> </li> <li class='listitem'> <span class='simpara'> &amp;#039;&amp;gt;&amp;#039; (maior que) torna-se &amp;#039;&amp;amp;gt;&amp;#039; </span> </li> </ul><p> </p><div class='example'> <p><b>Exemplo #1 <b>htmlspecialchars()</b> exemplo</b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$new&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>htmlspecialchars</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'&amp;lt;a&amp;nbsp;href='http://www.php.net/manual/pt_BR/test'&amp;gt;Test&amp;lt;/a&amp;gt;'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>ENT_QUOTES</span><span style='color: #007700'>);<br />echo&amp;nbsp;</span><span style='color: #0000BB'>$new</span><span style='color: #007700'>;&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;&amp;amp;lt;a&amp;nbsp;href=&amp;amp;#039;test&amp;amp;#039;&amp;amp;gt;Test&amp;amp;lt;/a&amp;amp;gt;&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> <p class='para'> Note que esta fun&amp;ccedil;&amp;atilde;o n&amp;atilde;o converte nada al&amp;eacute;m do que foi listado acima. Para completa realidade de convers&amp;otilde;es, veja <a href='http://www.php.net/manual/pt_BR/function.htmlentities.php' class='function'>htmlentities()</a>. Suporte para o segundo argumento opcional foi adicionado no PHP 3.0.17 e PHP 4.0.3. </p> <p class='para'> O terceiro argumento define o conjunto de caracteres usados na convers&amp;atilde;o. O conjunto de caracteres padr&amp;atilde;o &amp;eacute; ISO-8859-1. Suporte para o terceiro argumento foi adicionado no PHP 4.1.0. </p> <p class='para'> Os seguintes conjuntos de caracteres s&amp;atilde;o suportados no PHP 4.3.0 e posterior. </p><table class='doctable table'> <caption><b>Conjuntos de caracteres suportados</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Conjunto de caracteres</th> <th>Apelidos</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>ISO-8859-1</td> <td align='left'>ISO8859-1</td> <td align='left'> Western European, Latin-1 </td> </tr> <tr valign='middle'> <td align='left'>ISO-8859-15</td> <td align='left'>ISO8859-15</td> <td align='left'> Western European, Latin-9. Adiciona o s&amp;iacute;mbolo do Euro, letras Francesas e Filandesas faltando no Latin-1(ISO-8859-1). </td> </tr> <tr valign='middle'> <td align='left'>UTF-8</td> <td class='empty'>&amp;nbsp;</td> <td align='left'> C&amp;oacute;digo de multi-byte 8-bit Unicode compat&amp;iacute;vel com ASCII. </td> </tr> <tr valign='middle'> <td align='left'>cp866</td> <td align='left'>ibm866, 866</td> <td align='left'> Conjunto de caracteres do DOS espec&amp;iacute;fico para o Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>cp1251</td> <td align='left'>Windows-1251, win-1251, 1251</td> <td align='left'> Conjunto de caracteres do Windows espec&amp;iacute;fico para o Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>cp1252</td> <td align='left'>Windows-1252, 1252</td> <td align='left'> Conjunto de caracteres do Windows espec&amp;iacute;fico para a Europa Ocidental. </td> </tr> <tr valign='middle'> <td align='left'>KOI8-R</td> <td align='left'>koi8-ru, koi8r</td> <td align='left'> Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>BIG5</td> <td align='left'>950</td> <td align='left'> Chin&amp;ecirc;s Tradicional, usado principalmente em Taiwan. </td> </tr> <tr valign='middle'> <td align='left'>GB2312</td> <td align='left'>936</td> <td align='left'> Chins Simplificado, conjunto de caracteres padr&amp;atilde;o nacional. </td> </tr> <tr valign='middle'> <td align='left'>BIG5-HKSCS</td> <td class='empty'>&amp;nbsp;</td> <td align='left'> Big5 com exten&amp;ccedil;&amp;otilde;es de Hong Kong, Chin&amp;ecirc;s Tradicional. </td> </tr> <tr valign='middle'> <td align='left'>Shift_JIS</td> <td align='left'>SJIS, 932</td> <td align='left'> Japon&amp;ecirc;s </td> </tr> <tr valign='middle'> <td align='left'>EUC-JP</td> <td align='left'>EUCJP</td> <td align='left'> Japon&amp;ecirc;s </td> </tr> </tbody> </table> <p> </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> Qualquer outro conjunto de caracteres n&amp;atilde;o &amp;eacute; reconhecido e ser&amp;aacute; usado o ISO-8859-1. </span> </p></blockquote><p> </p> <p class='para'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.get-html-translation-table.php' class='function'>get_html_translation_table()</a>, <a href='http://www.php.net/manual/pt_BR/function.htmlentities.php' class='function'>htmlentities()</a>, <a href='http://www.php.net/manual/pt_BR/function.strip-tags.php' class='function'>strip_tags()</a> e <a href='http://www.php.net/manual/pt_BR/function.nl2br.php' class='function'>nl2br()</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="htmlentities" value="<div id='function.htmlentities' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.htmlentities.php'>htmlentities</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>htmlentities</span> &amp;mdash; <span class='dc-title'>Converte todos os caracteres aplic&amp;aacute;veis em entidades html.</span></p> </div> <a name='function.htmlentities.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>htmlentities</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$quote_style</tt></span> [, <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$charset</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$double_encode</tt></span> ]]] )</div> <p class='para rdfs-comment'> Esta fun&amp;ccedil;&amp;atilde;o &amp;eacute; id&amp;ecirc;ntica a <a href='http://www.php.net/manual/pt_BR/function.htmlspecialchars.php' class='function'>htmlspecialchars()</a> em toda forma, exceto que com <b>htmlentities()</b>, todos caracteres que tem entidade HTML equivalente s&amp;atilde;o convertidos para estas entidades. </p> <p class='para'> Se voc&amp;ecirc; est&amp;aacute; querendo decodificar (o inverso), voc&amp;ecirc; pode usar <a href='http://www.php.net/manual/pt_BR/function.html-entity-decode.php' class='function'>html_entity_decode()</a>. </p> </div> <a name='function.htmlentities.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string de entrada. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>quote_style</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Como <a href='http://www.php.net/manual/pt_BR/function.htmlspecialchars.php' class='function'>htmlspecialchars()</a>, o segundo par&amp;acirc;metro opcional <i><tt class='parameter'>quote_style</tt></i> voc&amp;ecirc; define o que ir&amp;aacute; ser feito com aspas &amp;#039;simples&amp;#039; e &amp;quot;duplas&amp;quot;. Use uma das tr&amp;ecirc;s constantes com o padr&amp;atilde;o sendo <b><tt class='constant'>ENT_COMPAT</tt></b>: </p><table class='doctable table'> <caption><b>Constantes <i><tt class='parameter'>quote_style</tt></i> dispon&amp;iacute;veis</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Nome da constante</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_COMPAT</tt></b></td> <td align='left'>Ir&amp;aacute; converter aspas duplas e deixar somente aspas simples.</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_QUOTES</tt></b></td> <td align='left'>Ir&amp;aacute; converter ambas as aspas.</td> </tr> <tr valign='middle'> <td align='left'><b><tt class='constant'>ENT_NOQUOTES</tt></b></td> <td align='left'>Ir&amp;aacute; deixar ambas as aspas n&amp;atilde;o convertidas.</td> </tr> </tbody> </table> <p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>charset</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Como <a href='http://www.php.net/manual/pt_BR/function.htmlspecialchars.php' class='function'>htmlspecialchars()</a>, o terceiro par&amp;acirc;metro opcional <i><tt class='parameter'>charset</tt></i> que define o conjunto de caracteres usado na convers&amp;atilde;o. Atualmente, o conjunto de caracteres ISO-8859-1 &amp;eacute; usado com o padr&amp;atilde;o. </p> <p class='para'> Os seguintes conjuntos de caracteres s&amp;atilde;o suportados no PHP 4.3.0 e posterior. </p><table class='doctable table'> <caption><b>Conjuntos de caracteres suportados</b></caption> <thead valign='middle'> <tr valign='middle'> <th>Conjunto de caracteres</th> <th>Apelidos</th> <th>Descri&amp;ccedil;&amp;atilde;o</th> </tr> </thead> <tbody valign='middle' class='tbody'> <tr valign='middle'> <td align='left'>ISO-8859-1</td> <td align='left'>ISO8859-1</td> <td align='left'> Western European, Latin-1 </td> </tr> <tr valign='middle'> <td align='left'>ISO-8859-15</td> <td align='left'>ISO8859-15</td> <td align='left'> Western European, Latin-9. Adiciona o s&amp;iacute;mbolo do Euro, letras Francesas e Filandesas faltando no Latin-1(ISO-8859-1). </td> </tr> <tr valign='middle'> <td align='left'>UTF-8</td> <td class='empty'>&amp;nbsp;</td> <td align='left'> C&amp;oacute;digo de multi-byte 8-bit Unicode compat&amp;iacute;vel com ASCII. </td> </tr> <tr valign='middle'> <td align='left'>cp866</td> <td align='left'>ibm866, 866</td> <td align='left'> Conjunto de caracteres do DOS espec&amp;iacute;fico para o Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>cp1251</td> <td align='left'>Windows-1251, win-1251, 1251</td> <td align='left'> Conjunto de caracteres do Windows espec&amp;iacute;fico para o Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>cp1252</td> <td align='left'>Windows-1252, 1252</td> <td align='left'> Conjunto de caracteres do Windows espec&amp;iacute;fico para a Europa Ocidental. </td> </tr> <tr valign='middle'> <td align='left'>KOI8-R</td> <td align='left'>koi8-ru, koi8r</td> <td align='left'> Russo. Este conjunto de caracteres &amp;eacute; suportado no 4.3.2. </td> </tr> <tr valign='middle'> <td align='left'>BIG5</td> <td align='left'>950</td> <td align='left'> Chin&amp;ecirc;s Tradicional, usado principalmente em Taiwan. </td> </tr> <tr valign='middle'> <td align='left'>GB2312</td> <td align='left'>936</td> <td align='left'> Chins Simplificado, conjunto de caracteres padr&amp;atilde;o nacional. </td> </tr> <tr valign='middle'> <td align='left'>BIG5-HKSCS</td> <td class='empty'>&amp;nbsp;</td> <td align='left'> Big5 com exten&amp;ccedil;&amp;otilde;es de Hong Kong, Chin&amp;ecirc;s Tradicional. </td> </tr> <tr valign='middle'> <td align='left'>Shift_JIS</td> <td align='left'>SJIS, 932</td> <td align='left'> Japon&amp;ecirc;s </td> </tr> <tr valign='middle'> <td align='left'>EUC-JP</td> <td align='left'>EUCJP</td> <td align='left'> Japon&amp;ecirc;s </td> </tr> </tbody> </table> <p> </p><blockquote><p><b class='note'>Nota</b>: <span class='simpara'> Qualquer outro conjunto de caracteres n&amp;atilde;o &amp;eacute; reconhecido e ser&amp;aacute; usado o ISO-8859-1. </span> </p></blockquote><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>double_encode</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Quando <i><tt class='parameter'>double_encode</tt></i> esta&amp;#039;off, o PHP n&amp;atilde;o ir&amp;aacute; codificar entidades HTML existentes. O padr&amp;atilde;o &amp;eacute; converter qualquer coisa. </p> </dd> </dl> <p> </p> </div> <a name='function.htmlentities.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a string codificada. </p> </div> <a name='function.htmlentities.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.3</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>double_encode</tt></i> foi adicionado. </td> </tr> <tr valign='middle'> <td align='left'>4.1.0</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>charset</tt></i> foi adicionado. </td> </tr> <tr valign='middle'> <td align='left'>4.0.3</td> <td align='left'> O par&amp;acirc;metro <i><tt class='parameter'>quote_style</tt></i> foi adicionado. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.htmlentities.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo da <b>htmlentities()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />$str&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'A&amp;nbsp;'quote'&amp;nbsp;is&amp;nbsp;&amp;lt;b&amp;gt;bold&amp;lt;/b&amp;gt;'</span><span style='color: #007700'>;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Outputs:&amp;nbsp;A&amp;nbsp;'quote'&amp;nbsp;is&amp;nbsp;&amp;amp;lt;b&amp;amp;gt;bold&amp;amp;lt;/b&amp;amp;gt;<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>htmlentities</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;Outputs:&amp;nbsp;A&amp;nbsp;&amp;amp;#039;quote&amp;amp;#039;&amp;nbsp;is&amp;nbsp;&amp;amp;lt;b&amp;amp;gt;bold&amp;amp;lt;/b&amp;amp;gt;<br /></span><span style='color: #007700'>echo&amp;nbsp;</span><span style='color: #0000BB'>htmlentities</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$str</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>ENT_QUOTES</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.htmlentities.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.html-entity-decode.php' class='function' rel='rdfs-seeAlso'>html_entity_decode()</a> - Converte todas as entidades HTML para os seus caracteres</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.get-html-translation-table.php' class='function' rel='rdfs-seeAlso'>get_html_translation_table()</a> - Retorna a tabela de tradu&amp;ccedil;&amp;atilde;o usada por htmlspecialchars e htmlentities</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.htmlspecialchars.php' class='function' rel='rdfs-seeAlso'>htmlspecialchars()</a> - Converte caracteres especiais para a realidade HTML</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.nl2br.php' class='function' rel='rdfs-seeAlso'>nl2br()</a> - Insere quebras de linha HTML antes de todas newlines em uma string</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.urlencode.php' class='function' rel='rdfs-seeAlso'>urlencode()</a> - Codifica uma URL</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="highlight_string" value="<div id='function.highlight-string' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.highlight-string.php'>highlight_string</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>highlight_string</span> &amp;mdash; <span class='dc-title'>Destaque da sintaxe de uma string</span></p> </div> <a name='function.highlight-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'><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>highlight_string</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$str</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$return</tt></span> ] )</div> <p class='simpara'> A fun&amp;ccedil;&amp;atilde;o <b>highlight_string()</b> mostra o destaque da sintaxe para o par&amp;acirc;metro <i><tt class='parameter'>str</tt></i> usando as cores definidas para o destacador de sintaxe do PHP. </p> <p class='simpara'> Se o segundo par&amp;acirc;metro <i><tt class='parameter'>return</tt></i> for <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o a fun&amp;ccedil;&amp;atilde;o <b>highlight_string()</b> ir&amp;aacute; retornar o c&amp;oacute;digo com a sintaxe destacada ao inv&amp;eacute;s de mostr&amp;aacute;-lo. Se o segundo par&amp;acirc;metro n&amp;atilde;o for <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o <b>highlight_string()</b> ir&amp;aacute; retornar <b><tt class='constant'>TRUE</tt></b> se funcionar, <b><tt class='constant'>FALSE</tt></b> se ocorrer falha. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Exemplo <b>highlight_string()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />highlight_string</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'&amp;lt;?php&amp;nbsp;phpinfo();&amp;nbsp;?&amp;gt;'</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; mostrar (no PHP 4): </p></div> <div class='example-contents screen'> <div class='cdata'><pre> &amp;lt;code&amp;gt;&amp;lt;font color=&amp;quot;#000000&amp;quot;&amp;gt; &amp;lt;font color=&amp;quot;#0000BB&amp;quot;&amp;gt;&amp;amp;lt;?php phpinfo&amp;lt;/font&amp;gt;&amp;lt;font color=&amp;quot;#007700&amp;quot;&amp;gt;(); &amp;lt;/font&amp;gt;&amp;lt;font color=&amp;quot;#0000BB&amp;quot;&amp;gt;?&amp;amp;gt;&amp;lt;/font&amp;gt; &amp;lt;/font&amp;gt; &amp;lt;/code&amp;gt; </pre></div> </div> <div class='example-contents para'><p> O exemplo acima ir&amp;aacute; mostrar (no PHP 5): </p></div> <div class='example-contents screen'> <div class='cdata'><pre> &amp;lt;code&amp;gt;&amp;lt;span style=&amp;quot;color: #000000&amp;quot;&amp;gt; &amp;lt;span style=&amp;quot;color: #0000BB&amp;quot;&amp;gt;&amp;amp;lt;?php phpinfo&amp;lt;/span&amp;gt;&amp;lt;span style=&amp;quot;color: #007700&amp;quot;&amp;gt;(); &amp;lt;/span&amp;gt;&amp;lt;span style=&amp;quot;color: #0000BB&amp;quot;&amp;gt;?&amp;amp;gt;&amp;lt;/span&amp;gt; &amp;lt;/span&amp;gt; &amp;lt;/code&amp;gt; </pre></div> </div> </div><p> </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'> O par&amp;acirc;metro <i><tt class='parameter'>return</tt></i> tornou-se dispon&amp;iacute;vel no PHP 4.2.0. Antes disso &amp;eacute; usado como o padr&amp;atilde;o, que &amp;eacute; <b><tt class='constant'>FALSE</tt></b> </span> </p></blockquote> <p class='simpara'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.highlight-file.php' class='function'>highlight_file()</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="highlight_file" value="<div id='function.highlight-file' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.highlight-file.php'>highlight_file</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>highlight_file</span> &amp;mdash; <span class='dc-title'>Destaca a sintaxe de um arquivo</span></p> </div> <a name='function.highlight-file.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>highlight_file</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$filename</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$return</tt></span> ] )</div> <p class='simpara'> A fun&amp;ccedil;&amp;atilde;o <b>highlight_file()</b> mostra uma vers&amp;atilde;o do c&amp;oacute;digo contido em <i><tt class='parameter'>filename</tt></i> com a sintaxe destacada usando as cores definidas pelo destacador de sintaxe do PHP. </p> <p class='simpara'> Se o segundo par&amp;acirc;metro <i><tt class='parameter'>return</tt></i> for <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o <b>highlight_file()</b> ir&amp;aacute; retornar o c&amp;oacute;digo como uma string ao inv&amp;eacute;s de mostr&amp;aacute;-lo. Se o segundo par&amp;acirc;metro n&amp;atilde;o for <b><tt class='constant'>TRUE</tt></b> ent&amp;atilde;o <b>highlight_file()</b> ir&amp;aacute; retornar <b><tt class='constant'>TRUE</tt></b> se funcionar, <b><tt class='constant'>FALSE</tt></b> em caso de falha. </p> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'> O par&amp;acirc;metro <i><tt class='parameter'>return</tt></i> tornou-se dispon&amp;iacute;vel no PHP 4.2.0. Antes disso &amp;eacute; usado como o padr&amp;atilde;o, que &amp;eacute; <b><tt class='constant'>FALSE</tt></b>. </span> </p></blockquote> <div class='caution'><b class='caution'>Cuidado</b> <p class='simpara'> Deve se tomar cuidado quando usar as fun&amp;ccedil;&amp;otilde;es <a href='http://www.php.net/manual/pt_BR/function.show-source.php' class='function'>show_source()</a> e <b>highlight_file()</b> para ter certeza que voc&amp;ecirc; n&amp;atilde;o ir&amp;aacute; inadvertidamente revelar informa&amp;ccedil;&amp;otilde;es sens&amp;iacute;veis como senhas ou outros tipos de informa&amp;ccedil;&amp;atilde;o que possam criar um risco de seguran&amp;ccedil;a em potencial. </p> </div> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'> Desde o PHP 4.2.1 esta fun&amp;ccedil;&amp;atilde;o tamb&amp;eacute;m &amp;eacute; afetada por <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.safe-mode' class='link'>safe_mode</a> e <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.open-basedir' class='link'>open_basedir</a>. </span> </p></blockquote> <p class='simpara'> Para configurar uma url que possa fazer o destaque da sintaxe de qualquer script que voc&amp;ecirc; passar para ela, n&amp;oacute;s iremos fazer uso da diretiva &amp;quot;ForceType&amp;quot; no Apache para gerar um bom modelo de URL, e usar a fun&amp;ccedil;&amp;atilde;o <b>highlight_file()</b> para mostrar o c&amp;oacute;digo com uma boa apar&amp;ecirc;ncia. </p> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Criando uma URL para destaque da sintaxe</b></p> <div class='example-contents simpara'><p> No seu <var class='filename'>httpd.conf</var> voc&amp;ecirc; pode adicionar o seguinte: </p></div> <div class='example-contents programlisting'> <div class='apache-confcode'><pre class='apache-confcode'>&amp;lt;Location /source&amp;gt; ForceType application/x-httpd-php &amp;lt;/Location&amp;gt;</pre> </div> </div> <div class='example-contents simpara'><p> E ent&amp;atilde;o fa&amp;ccedil;a um arquivo chamado <var class='filename'>source</var> e coloque-o no seu diret&amp;oacute;rio raiz do servidor web. </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> &amp;lt;html&amp;gt;<br />&amp;lt;head&amp;gt;<br />&amp;lt;title&amp;gt;Mostrar&amp;nbsp;Fonte&amp;lt;/title&amp;gt;<br />&amp;lt;/head&amp;gt;<br />&amp;lt;body&amp;nbsp;bgcolor='white'&amp;gt;<br /><span style='color: #0000BB'>&amp;lt;?php<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;$script&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>getenv&amp;nbsp;</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'PATH_TRANSLATED'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;if(!</span><span style='color: #0000BB'>$script</span><span style='color: #007700'>)&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;br&amp;gt;&amp;lt;b&amp;gt;ERRO:&amp;nbsp;Necess&amp;aacute;rio&amp;nbsp;o&amp;nbsp;nome&amp;nbsp;do&amp;nbsp;script&amp;lt;/b&amp;gt;&amp;lt;br&amp;gt;'</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;if&amp;nbsp;(</span><span style='color: #0000BB'>ereg</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'(\\.php|\\.inc)$'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$script</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'>'&amp;lt;h1&amp;gt;Source&amp;nbsp;of:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>getenv</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'PATH_INFO'</span><span style='color: #007700'>)&amp;nbsp;.&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;/h1&amp;gt;\n&amp;lt;hr&amp;nbsp;/&amp;gt;\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>highlight_file</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$script</span><span style='color: #007700'>);<br />&amp;nbsp;&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;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;h1&amp;gt;ERRO:&amp;nbsp;Somente&amp;nbsp;PHP&amp;nbsp;ou&amp;nbsp;script&amp;nbsp;de&amp;nbsp;inclus&amp;atilde;o(.inc)&amp;nbsp;s&amp;atilde;o&amp;nbsp;permitidos&amp;lt;/h1&amp;gt;'</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;}<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'&amp;lt;hr&amp;nbsp;/&amp;gt;Processed:&amp;nbsp;'&amp;nbsp;</span><span style='color: #007700'>.&amp;nbsp;</span><span style='color: #0000BB'>date</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Y/M/d&amp;nbsp;H:i:s'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>time</span><span style='color: #007700'>());<br /></span><span style='color: #0000BB'>?&amp;gt;<br /></span>&amp;lt;/body&amp;gt;<br />&amp;lt;/html&amp;gt;</span> </code></div> </div> <div class='example-contents simpara'><p> Ent&amp;atilde;o voc&amp;ecirc; pode usar uma URL como a abaixo para mostrar uma vers&amp;atilde;o colorida do script localizado em &amp;quot;/caminho/para/script.php&amp;quot; no seu site web. </p></div> <div class='example-contents screen'> <div class='cdata'><pre> http://www.example.com/source/caminho/para/script.php </pre></div> </div> </div><p> </p> <p class='simpara'> Veja tamb&amp;eacute;m <a href='http://www.php.net/manual/pt_BR/function.highlight-string.php' class='function'>highlight_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="hexdec" value="<div id='function.hexdec' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.hexdec.php'>hexdec</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>hexdec</span> &amp;mdash; <span class='dc-title'>Hexadecimal para decimal</span></p> </div> <a name='function.hexdec.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.number' class='type number'>number</a></span> <span class='methodname'><b>hexdec</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$hex_string</tt></span> )</div> <p class='para rdfs-comment'> Retorna o decimal equivalente do n&amp;uacute;mero hexadecimal representado pelo argumento <i><tt class='parameter'>hex_string</tt></i> . <b>hexdec()</b> converte uma string hexadecimal para um n&amp;uacute;mero decimal. </p> <p class='para'> <b>hexdec()</b> ir&amp;aacute; ignorar qualquer caracter n&amp;atilde;o hexadecimal que encontrar. </p> </div> <a name='function.hexdec.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'>hex_string</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The hexadecimal string to convert </p> </dd> </dl> <p> </p> </div> <a name='function.hexdec.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> The decimal representation of <i><tt class='parameter'>hex_string</tt></i> </p> </div> <a name='function.hexdec.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'>Since 4.1.0</td> <td align='left'> A fun&amp;ccedil;&amp;atilde;o pode agora converter valores que s&amp;atilde;o maior que o tipo <a href='http://www.php.net/manual/pt_BR/language.types.integer.php' class='type integer'>integer</a> da plataforma, retornar&amp;aacute; o valor como <a href='http://www.php.net/manual/pt_BR/language.types.float.php' class='type float'>float</a> neste caso. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.hexdec.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 exemplos <b>hexdec()</b></b></p> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>hexdec</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'See'</span><span style='color: #007700'>));<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>hexdec</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'ee'</span><span style='color: #007700'>));<br /></span><span style='color: #FF8000'>//&amp;nbsp;ambos&amp;nbsp;exibem&amp;nbsp;'int(238)'<br /><br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>hexdec</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'that'</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;print&amp;nbsp;'int(10)'<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>hexdec</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'a0'</span><span style='color: #007700'>));&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;print&amp;nbsp;'int(160)'<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.hexdec.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.dechex.php' class='function' rel='rdfs-seeAlso'>dechex()</a> - Decimal para hexadecimal</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.bindec.php' class='function' rel='rdfs-seeAlso'>bindec()</a> - Bin&amp;aacute;rio para decimal</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.octdec.php' class='function' rel='rdfs-seeAlso'>octdec()</a> - Octal para decimal</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.base-convert.php' class='function' rel='rdfs-seeAlso'>base_convert()</a> - Converte um n&amp;uacute;mero entre bases arbitr&amp;aacute;rias</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="hebrevc" value="<div id='function.hebrevc' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.hebrevc.php'>hebrevc</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>hebrevc</span> &amp;mdash; <span class='dc-title'>Converte um texto l&amp;oacute;gico Hebr&amp;aacute;ico para um texto visual com convers&amp;atilde;o newline</span></p> </div> <a name='function.hebrevc.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>hebrevc</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$hebrew_text</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$max_chars_per_line</tt></span> ] )</div> <p class='para rdfs-comment'> &amp;Eacute; similar a <a href='http://www.php.net/manual/pt_BR/function.hebrev.php' class='function'>hebrev()</a> com a diferen&amp;ccedil;a de que ela converte newlines (\n) para &amp;quot;&amp;lt;br&amp;gt;\n&amp;quot;. </p> <p class='para'> A fun&amp;ccedil;&amp;atilde;o tenta evitar quebra de palavras. </p> </div> <a name='function.hebrevc.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'>hebrew_text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Uma string de entrada em Hebraico. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>max_chars_per_line</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Este par&amp;acirc;metro opcional indica o n&amp;uacute;mero m&amp;aacute;ximo de caracteres por linha que ser&amp;aacute; retornada. </p> </dd> </dl> <p> </p> </div> <a name='function.hebrevc.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna a string visual. </p> </div> <a name='function.hebrevc.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.hebrev.php' class='function' rel='rdfs-seeAlso'>hebrev()</a> - Converte texto l&amp;oacute;gico Hebraico para texto visual</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="hebrev" value="<div id='function.hebrev' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.hebrev.php'>hebrev</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>hebrev</span> &amp;mdash; <span class='dc-title'>Converte texto l&amp;oacute;gico Hebraico para texto visual</span></p> </div> <a name='function.hebrev.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>hebrev</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$hebrew_text</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$max_chars_per_line</tt></span> ] )</div> <p class='para rdfs-comment'> Converte texto l&amp;oacute;gico Hebraico para texto visual. </p> <p class='para'> A fun&amp;ccedil;&amp;atilde;o tenta evitar quebra de palavras. </p> </div> <a name='function.hebrev.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'>hebrew_text</tt></i> </span> </dt><dd class='listitem'> <p class='para'> A string de entrada em Hebraico. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>max_chars_per_line</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Este par&amp;acirc;metro opcional indica o n&amp;uacute;mero m&amp;aacute;ximo de caracteres por linha que ser&amp;aacute; retornado. </p> </dd> </dl> <p> </p> </div> <a name='function.hebrev.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Retorna uma string visual. </p> </div> <a name='function.hebrev.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.hebrevc.php' class='function' rel='rdfs-seeAlso'>hebrevc()</a> - Converte um texto l&amp;oacute;gico Hebr&amp;aacute;ico para um texto visual com convers&amp;atilde;o newline</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="headers_sent" value="<div id='function.headers-sent' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.headers-sent.php'>headers_sent</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>headers_sent</span> &amp;mdash; <span class='dc-title'>Checks if or where headers have been sent</span></p> </div> <a name='function.headers-sent.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>headers_sent</b></span> ([ <span class='methodparam'><span class='type'>string</span> <tt class='parameter reference'>&amp;amp;$file</tt></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter reference'>&amp;amp;$line</tt></span> ]] )</div> <p class='para rdfs-comment'> Checks if or where headers have been sent. </p> <p class='para'> You can&amp;#039;t add any more header lines using the <a href='http://www.php.net/manual/pt_BR/function.header.php' class='function'>header()</a> function once the header block has already been sent. Using this function you can at least prevent getting HTTP header related error messages. Another option is to use <a href='http://www.php.net/manual/pt_BR/ref.outcontrol.php' class='link'>Output Buffering</a>. </p> </div> <a name='function.headers-sent.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'>file</tt></i> </span> </dt><dd class='listitem'> <p class='para'> If the optional <i><tt class='parameter'>file</tt></i> and <i><tt class='parameter'>line</tt></i> parameters are set, <b>headers_sent()</b> will put the PHP source file name and line number where output started in the <i><tt class='parameter'>file</tt></i> and <i><tt class='parameter'>line</tt></i> variables. </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>line</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The line number where the output started. </p> </dd> </dl> <p> </p> </div> <a name='function.headers-sent.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> <b>headers_sent()</b> will return <b><tt class='constant'>FALSE</tt></b> if no HTTP headers have already been sent or <b><tt class='constant'>TRUE</tt></b> otherwise. </p> </div> <a name='function.headers-sent.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.0</td> <td align='left'> The optional <i><tt class='parameter'>file</tt></i> and <i><tt class='parameter'>line</tt></i> parameters were added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.headers-sent.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Examples using <b>headers_sent()</b></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;If&amp;nbsp;no&amp;nbsp;headers&amp;nbsp;are&amp;nbsp;sent,&amp;nbsp;send&amp;nbsp;one<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>headers_sent</span><span style='color: #007700'>())&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Location:&amp;nbsp;http://www.example.com/'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;An&amp;nbsp;example&amp;nbsp;using&amp;nbsp;the&amp;nbsp;optional&amp;nbsp;file&amp;nbsp;and&amp;nbsp;line&amp;nbsp;parameters,&amp;nbsp;as&amp;nbsp;of&amp;nbsp;PHP&amp;nbsp;4.3.0<br />//&amp;nbsp;Note&amp;nbsp;that&amp;nbsp;$filename&amp;nbsp;and&amp;nbsp;$linenum&amp;nbsp;are&amp;nbsp;passed&amp;nbsp;in&amp;nbsp;for&amp;nbsp;later&amp;nbsp;use.<br />//&amp;nbsp;Do&amp;nbsp;not&amp;nbsp;assign&amp;nbsp;them&amp;nbsp;values&amp;nbsp;beforehand.<br /></span><span style='color: #007700'>if&amp;nbsp;(!</span><span style='color: #0000BB'>headers_sent</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$filename</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>$linenum</span><span style='color: #007700'>))&amp;nbsp;{<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Location:&amp;nbsp;http://www.example.com/'</span><span style='color: #007700'>);<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;You&amp;nbsp;would&amp;nbsp;most&amp;nbsp;likely&amp;nbsp;trigger&amp;nbsp;an&amp;nbsp;error&amp;nbsp;here.<br /></span><span style='color: #007700'>}&amp;nbsp;else&amp;nbsp;{<br /><br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;echo&amp;nbsp;</span><span style='color: #DD0000'>'Headers&amp;nbsp;already&amp;nbsp;sent&amp;nbsp;in&amp;nbsp;</span><span style='color: #0000BB'>$filename</span><span style='color: #DD0000'>&amp;nbsp;on&amp;nbsp;line&amp;nbsp;</span><span style='color: #0000BB'>$linenum</span><span style='color: #DD0000'>\n'&amp;nbsp;</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;</span><span style='color: #DD0000'>'Cannot&amp;nbsp;redirect,&amp;nbsp;for&amp;nbsp;now&amp;nbsp;please&amp;nbsp;click&amp;nbsp;this&amp;nbsp;&amp;lt;a&amp;nbsp;'&amp;nbsp;</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;</span><span style='color: #DD0000'>'href=\'http://www.example.com\'&amp;gt;link&amp;lt;/a&amp;gt;&amp;nbsp;instead\n'</span><span style='color: #007700'>;<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;exit;<br />}<br /><br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </div> <a name='function.headers-sent.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.ob-start.php' class='function' rel='rdfs-seeAlso'>ob_start()</a> - Ativa o buffer de sa&amp;iacute;da</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.trigger-error.php' class='function' rel='rdfs-seeAlso'>trigger_error()</a> - Gera uma mensagem a n&amp;iacute;vel de usu&amp;aacute;rio de erro/aviso/not&amp;iacute;cia</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.headers-list.php' class='function' rel='rdfs-seeAlso'>headers_list()</a> - Returns a list of response headers sent (or ready to send)</li> <li class='member'> <a href='http://www.php.net/manual/pt_BR/function.header.php' class='function' rel='rdfs-seeAlso'>header()</a> - Send a raw HTTP header for a more detailed discussion of the matters involved. </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="headers_list" value="<div id='function.headers-list' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.headers-list.php'>headers_list</a></h1> <p class='verinfo'>(PHP 5)</p><p class='refpurpose'><span class='refname'>headers_list</span> &amp;mdash; <span class='dc-title'>Returns a list of response headers sent (or ready to send)</span></p> </div> <a name='function.headers-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'>array</span> <span class='methodname'><b>headers_list</b></span> ( <span class='methodparam'>void</span> )</div> <p class='para rdfs-comment'> <b>headers_list()</b> will return a list of headers to be sent to the browser / client. To determine whether or not these headers have been sent yet, use <a href='http://www.php.net/manual/pt_BR/function.headers-sent.php' class='function'>headers_sent()</a>. </p> </div> <a name='function.headers-list.returnvalues'></a><div class='refsect1 returnvalues'> <h3 class='title'>Valor Retornado</h3> <p class='para'> Returns a numerically indexed array of headers. </p> </div> <a name='function.headers-list.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Examples using <b>headers_list()</b></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;setcookie()&amp;nbsp;will&amp;nbsp;add&amp;nbsp;a&amp;nbsp;response&amp;nbsp;header&amp;nbsp;on&amp;nbsp;its&amp;nbsp;own&amp;nbsp;*/<br /></span><span style='color: #0000BB'>setcookie</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'foo'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #DD0000'>'bar'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Define&amp;nbsp;a&amp;nbsp;custom&amp;nbsp;response&amp;nbsp;header<br />&amp;nbsp;&amp;nbsp;&amp;nbsp;This&amp;nbsp;will&amp;nbsp;be&amp;nbsp;ignored&amp;nbsp;by&amp;nbsp;most&amp;nbsp;clients&amp;nbsp;*/<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'X-Sample-Test:&amp;nbsp;foo'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;Specify&amp;nbsp;plain&amp;nbsp;text&amp;nbsp;content&amp;nbsp;in&amp;nbsp;our&amp;nbsp;response&amp;nbsp;*/<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;text/plain'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>/*&amp;nbsp;What&amp;nbsp;headers&amp;nbsp;are&amp;nbsp;going&amp;nbsp;to&amp;nbsp;be&amp;nbsp;sent?&amp;nbsp;*/<br /></span><span style='color: #0000BB'>var_dump</span><span style='color: #007700'>(</span><span style='color: #0000BB'>headers_list</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(4) { [0]=&amp;gt; string(23) &amp;quot;X-Powered-By: PHP/5.1.3&amp;quot; [1]=&amp;gt; string(19) &amp;quot;Set-Cookie: foo=bar&amp;quot; [2]=&amp;gt; string(18) &amp;quot;X-Sample-Test: foo&amp;quot; [3]=&amp;gt; string(24) &amp;quot;Content-type: text/plain&amp;quot; } </pre></div> </div> </div><p> </p> </div> <a name='function.headers-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.headers-sent.php' class='function' rel='rdfs-seeAlso'>headers_sent()</a> - Checks if or where headers have been sent</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.header.php' class='function' rel='rdfs-seeAlso'>header()</a> - Send a raw HTTP header</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.setcookie.php' class='function' rel='rdfs-seeAlso'>setcookie()</a> - Envia um cookie</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.apache-response-headers.php' class='function' rel='rdfs-seeAlso'>apache_response_headers()</a> - Obt&amp;ecirc;m todos os cabe&amp;ccedil;alhos da resposta HTTP</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="header" value="<div id='function.header' class='refentry'> <div class='refnamediv'> <h1 class='refname'><a class='info-url' href='http://www.php.net/manual/pt_br/function.header.php'>header</a></h1> <p class='verinfo'>(PHP 4, PHP 5)</p><p class='refpurpose'><span class='refname'>header</span> &amp;mdash; <span class='dc-title'>Send a raw HTTP header</span></p> </div> <a name='function.header.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>header</b></span> ( <span class='methodparam'><span class='type'>string</span> <tt class='parameter'>$string</tt></span> [, <span class='methodparam'><span class='type'>bool</span> <tt class='parameter'>$replace</tt><span class='initializer'> = true</span></span> [, <span class='methodparam'><span class='type'>int</span> <tt class='parameter'>$http_response_code</tt></span> ]] )</div> <p class='para rdfs-comment'> <b>header()</b> is used to send a raw <acronym title='Hypertext Transfer Protocol'>HTTP</acronym> header. See the <a href='http://www.faqs.org/rfcs/rfc2616' class='link external'>&amp;raquo; HTTP/1.1 specification</a> for more information on <acronym title='Hypertext Transfer Protocol'>HTTP</acronym> headers. </p> <p class='para'> Remember that <b>header()</b> must be called before any actual output is sent, either by normal HTML tags, blank lines in a file, or from PHP. It is a very common error to read code with <a href='http://www.php.net/manual/pt_BR/function.include.php' class='function'>include()</a>, or <a href='http://www.php.net/manual/pt_BR/function.require.php' class='function'>require()</a>, functions, or another file access function, and have spaces or empty lines that are output before <b>header()</b> is called. The same problem exists when using a single PHP/HTML file. </p><div class='informalexample'> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> &amp;lt;html&amp;gt;<br /><span style='color: #0000BB'>&amp;lt;?php<br /></span><span style='color: #FF8000'>/*&amp;nbsp;This&amp;nbsp;will&amp;nbsp;give&amp;nbsp;an&amp;nbsp;error.&amp;nbsp;Note&amp;nbsp;the&amp;nbsp;output<br />&amp;nbsp;*&amp;nbsp;above,&amp;nbsp;which&amp;nbsp;is&amp;nbsp;before&amp;nbsp;the&amp;nbsp;header()&amp;nbsp;call&amp;nbsp;*/<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Location:&amp;nbsp;http://www.example.com/'</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.header.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</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The header string. </p> <p class='para'> There are two special-case header calls. The first is a header that starts with the string &amp;quot;<i>HTTP/</i>&amp;quot; (case is not significant), which will be used to figure out the HTTP status code to send. For example, if you have configured Apache to use a PHP script to handle requests for missing files (using the <i>ErrorDocument</i> directive), you may want to make sure that your script generates the proper status code. </p> <p class='para'> </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 />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'HTTP/1.0&amp;nbsp;404&amp;nbsp;Not&amp;nbsp;Found'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> <p class='para'> The second special case is the &amp;quot;Location:&amp;quot; header. Not only does it send this header back to the browser, but it also returns a <i>REDIRECT</i> (302) status code to the browser unless the <i>201</i> or a <i>3xx</i> status code has already been set. </p> <p class='para'> </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 />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Location:&amp;nbsp;http://www.example.com/'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>/*&amp;nbsp;Redirect&amp;nbsp;browser&amp;nbsp;*/<br /><br />/*&amp;nbsp;Make&amp;nbsp;sure&amp;nbsp;that&amp;nbsp;code&amp;nbsp;below&amp;nbsp;does&amp;nbsp;not&amp;nbsp;get&amp;nbsp;executed&amp;nbsp;when&amp;nbsp;we&amp;nbsp;redirect.&amp;nbsp;*/<br /></span><span style='color: #007700'>exit;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>replace</tt></i> </span> </dt><dd class='listitem'> <p class='para'> The optional <i><tt class='parameter'>replace</tt></i> parameter indicates whether the header should replace a previous similar header, or add a second header of the same type. By default it will replace, but if you pass in <b><tt class='constant'>FALSE</tt></b> as the second argument you can force multiple headers of the same type. For example: </p> <p class='para'> </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 />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'WWW-Authenticate:&amp;nbsp;Negotiate'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'WWW-Authenticate:&amp;nbsp;NTLM'</span><span style='color: #007700'>,&amp;nbsp;</span><span style='color: #0000BB'>false</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> </p> </dd> <dt class='varlistentry'> <span class='term'><i><tt class='parameter'>http_response_code</tt></i> </span> </dt><dd class='listitem'> <p class='para'> Forces the HTTP response code to the specified value. </p> </dd> </dl> <p> </p> </div> <a name='function.header.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.header.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.4.2 and 5.1.2</td> <td align='left'> This function now prevents more than one header to be sent at once as a protection against header injection attacks. </td> </tr> <tr valign='middle'> <td align='left'>4.3.0</td> <td align='left'> The <i><tt class='parameter'>http_response_code</tt></i> parameter was added. </td> </tr> <tr valign='middle'> <td align='left'>4.0.4</td> <td align='left'> The <i><tt class='parameter'>replace</tt></i> parameter was added. </td> </tr> </tbody> </table> <p> </p> </div> <a name='function.header.examples'></a><div class='refsect1 examples'> <h3 class='title'>Exemplos</h3> <p class='para'> </p><div class='example'> <p><b>Exemplo #1 Download dialog</b></p> <div class='example-contents para'><p> If you want the user to be prompted to save the data you are sending, such as a generated PDF file, you can use the <a href='http://www.faqs.org/rfcs/rfc2183' class='link external'>&amp;raquo; Content-Disposition</a> header to supply a recommended filename and force the browser to display the save dialog. </p></div> <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;We'll&amp;nbsp;be&amp;nbsp;outputting&amp;nbsp;a&amp;nbsp;PDF<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-type:&amp;nbsp;application/pdf'</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;It&amp;nbsp;will&amp;nbsp;be&amp;nbsp;called&amp;nbsp;downloaded.pdf<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Content-Disposition:&amp;nbsp;attachment;&amp;nbsp;filename='downloaded.pdf''</span><span style='color: #007700'>);<br /><br /></span><span style='color: #FF8000'>//&amp;nbsp;The&amp;nbsp;PDF&amp;nbsp;source&amp;nbsp;is&amp;nbsp;in&amp;nbsp;original.pdf<br /></span><span style='color: #0000BB'>readfile</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'original.pdf'</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 Caching directives</b></p> <div class='example-contents para'><p> PHP scripts often generate dynamic content that must not be cached by the client browser or any proxy caches between the server and the client browser. Many proxies and clients can be forced to disable caching with: </p></div> <div class='example-contents programlisting'> <div class='phpcode'><code><span style='color: #000000'> <span style='color: #0000BB'>&amp;lt;?php<br />header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Cache-Control:&amp;nbsp;no-cache,&amp;nbsp;must-revalidate'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;HTTP/1.1<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Expires:&amp;nbsp;Sat,&amp;nbsp;26&amp;nbsp;Jul&amp;nbsp;1997&amp;nbsp;05:00:00&amp;nbsp;GMT'</span><span style='color: #007700'>);&amp;nbsp;</span><span style='color: #FF8000'>//&amp;nbsp;Date&amp;nbsp;in&amp;nbsp;the&amp;nbsp;past<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> <div class='example-contents para'><p> </p><blockquote><p><b class='note'>Nota</b>: You may find that your pages aren&amp;#039;t cached even if you don&amp;#039;t output all of the headers above. There are a number of options that users may be able to set for their browser that change its default caching behavior. By sending the headers above, you should override any settings that may otherwise cause the output of your script to be cached. <br /> Additionally, <a href='http://www.php.net/manual/pt_BR/function.session-cache-limiter.php' class='function'>session_cache_limiter()</a> and the <i>session.cache_limiter</i> configuration setting can be used to automatically generate the correct caching-related headers when sessions are being used. <br /> </p></blockquote><p> </p></div> </div><p> </p> </div> <a name='function.header.notes'></a><div class='refsect1 notes'> <h3 class='title'>Notas</h3> <blockquote><p><b class='note'>Nota</b>: You can use output buffering to get around this problem, with the overhead of all of your output to the browser being buffered in the server until you send it. You can do this by calling <a href='http://www.php.net/manual/pt_BR/function.ob-start.php' class='function'>ob_start()</a> and <a href='http://www.php.net/manual/pt_BR/function.ob-end-flush.php' class='function'>ob_end_flush()</a> in your script, or setting the <i>output_buffering</i> configuration directive on in your <var class='filename'>php.ini</var> or server configuration files. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: The HTTP status header line will always be the first sent to the client, regardless of the actual <b>header()</b> call being the first or not. The status may be overridden by calling <b>header()</b> with a new status line at any time unless the HTTP headers have already been sent. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: There is a bug in Microsoft Internet Explorer 4.01 that prevents this from working. There is no workaround. There is also a bug in Microsoft Internet Explorer 5.5 that interferes with this, which can be resolved by upgrading to Service Pack 2 or later. <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: <span class='simpara'> If <a href='http://www.php.net/manual/pt_BR/ini.sect.safe-mode.php#ini.safe-mode' class='link'>safe mode</a> is enabled the uid of the script is added to the <i>realm</i> part of the <i>WWW-Authenticate</i> header if you set this header (used for HTTP Authentication). </span> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: HTTP/1.1 requires an absolute <acronym title='Uniform Resource Identifier'>URI</acronym> as argument to <a href='http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.30' class='link external'>&amp;raquo; Location:</a> including the scheme, hostname and absolute path, but some clients accept relative URIs. You can usually use <var class='varname'><a href='http://www.php.net/manual/pt_BR/reserved.variables.server.php' class='classname'>$_SERVER['HTTP_HOST']</a></var>, <var class='varname'><a href='http://www.php.net/manual/pt_BR/reserved.variables.server.php' class='classname'>$_SERVER['PHP_SELF']</a></var> and <a href='http://www.php.net/manual/pt_BR/function.dirname.php' class='function'>dirname()</a> to make an absolute URI from a relative one yourself: </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 /></span><span style='color: #FF8000'>/*&amp;nbsp;Redirect&amp;nbsp;to&amp;nbsp;a&amp;nbsp;different&amp;nbsp;page&amp;nbsp;in&amp;nbsp;the&amp;nbsp;current&amp;nbsp;directory&amp;nbsp;that&amp;nbsp;was&amp;nbsp;requested&amp;nbsp;*/<br /></span><span style='color: #0000BB'>$host&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>$_SERVER</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'HTTP_HOST'</span><span style='color: #007700'>];<br /></span><span style='color: #0000BB'>$uri&amp;nbsp;&amp;nbsp;&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #0000BB'>rtrim</span><span style='color: #007700'>(</span><span style='color: #0000BB'>dirname</span><span style='color: #007700'>(</span><span style='color: #0000BB'>$_SERVER</span><span style='color: #007700'>[</span><span style='color: #DD0000'>'PHP_SELF'</span><span style='color: #007700'>]),&amp;nbsp;</span><span style='color: #DD0000'>'/\\'</span><span style='color: #007700'>);<br /></span><span style='color: #0000BB'>$extra&amp;nbsp;</span><span style='color: #007700'>=&amp;nbsp;</span><span style='color: #DD0000'>'mypage.php'</span><span style='color: #007700'>;<br /></span><span style='color: #0000BB'>header</span><span style='color: #007700'>(</span><span style='color: #DD0000'>'Location:&amp;nbsp;http://</span><span style='color: #0000BB'>$host$uri</span><span style='color: #DD0000'>/</span><span style='color: #0000BB'>$extra</span><span style='color: #DD0000'>'</span><span style='color: #007700'>);<br />exit;<br /></span><span style='color: #0000BB'>?&amp;gt;</span> </span> </code></div> </div> </div><p> <br /> </p></blockquote> <blockquote><p><b class='note'>Nota</b>: Session ID is not passed with Location header even if <a href='http://www.php.net/manual/pt_BR/session.configuration.php#ini.session.use-trans-sid' class='link'>session.use_trans_sid</a> is enabled. It must by passed manually using <b><tt class='constant'>SID</tt></b> constant. <br /> </p></blockquote> </div> <a name='function.header.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.headers-sent.php' class='function' rel='rdfs-seeAlso'>headers_sent()</a> - Checks if or where headers have been sent</li> <li class='member'><a href='http://www.php.net/manual/pt_BR/function.setcookie.php' class='function' rel='rdfs-seeAlso'>setcookie()</a> - Envia um cookie</li> <li class='member'> The section on <a href='http://www.php.net/manual/pt_BR/features.http-auth.php' class='link'>HTTP authentication</a> </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>

