Files
archived-doc-pt-br/appendices/comparisons.xml
2025-10-06 16:46:57 -03:00

649 lines
18 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 88890f831cb49dc2b2be942039b1938217b1cc54 Maintainer: ae Status: ready --><!-- CREDITS: narigone,nawarian,rogeriopradoj,fibbarth,ae -->
<appendix xml:id="types.comparisons" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Tabela de comparações de tipos do PHP</title>
<para>
As seguintes tabelas demonstram o comportamento dos
<link linkend="language.types">tipos</link> e
<link linkend="language.operators.comparison">operadores
de comparação</link> no PHP, tanto para comparações aproximadas ou exatas. Este
complemento é também relacionado com a seção do manual sobre
<link linkend="language.types.type-juggling">type juggling</link>.
A inspiração vem dos comentários de vários usuários e do trabalho feito pela
<link xlink:href="&url.blueshoes.comparisons;">BlueShoes</link>.
</para>
<para>
Antes de utilizar essas tabelas, é importante entender os tipos e seus
significados. Por exemplo, <literal>"42"</literal> é uma <type>string</type>
enquanto <literal>42</literal> é um <type>int</type>. &false; é um
<type>bool</type> enquanto <literal>"false"</literal> é uma
<type>string</type>.
</para>
<note>
<para>
Formulários HTML não passam inteiros, floats ou booleanos; eles passam strings.
Para saber se uma string é do tipo númerico, você pode usar a função
<function>is_numeric</function>.
</para>
</note>
<note>
<para>
Usar apenas <literal>if ($x)</literal> quando <varname>$x</varname> estiver
indefinido irá gerar um erro do nível <constant>E_NOTICE</constant>.
Em vez disso, considere usar <function>empty</function> ou
<function>isset</function> ou ainda inicialize suas variáveis.
</para>
</note>
<note>
<para>
Algumas operações numéricas podem resultar em um valor representado pela constante
<constant>NAN</constant>. Quaisquer comparações exatas ou aproximadas deste valor
contra qualquer outro valor, incluindo ele mesmo, com exceção de &true;, terão como resultado &false;.
(por exemplo <literal>NAN != NAN</literal> e <literal>NAN !== NAN</literal>)
Exemplos de operações que geram <constant>NAN</constant> são
<literal>sqrt(-1)</literal>, <literal>asin(2)</literal>, e
<literal>acosh(0)</literal>.
</para>
</note>
<para>
<table>
<title>Comparações de <varname>$x</varname> com funções PHP</title>
<tgroup cols="6">
<thead>
<row>
<entry>Expressão</entry>
<entry><function>gettype</function></entry>
<entry><function>empty</function></entry>
<entry><function>is_null</function></entry>
<entry><function>isset</function></entry>
<entry><type>bool</type> : <literal>if($x)</literal></entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>$x = "";</literal></entry>
<entry><type>string</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = null;</literal></entry>
<entry><type>NULL</type></entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>var $x;</literal></entry>
<entry><type>NULL</type></entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><varname>$x</varname> está indefinido</entry>
<entry><type>NULL</type></entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = [];</literal></entry>
<entry><type>array</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = ['a', 'b'];</literal></entry>
<entry><type>array</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = false;</literal></entry>
<entry><type>bool</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = true;</literal></entry>
<entry><type>bool</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = 1;</literal></entry>
<entry><type>int</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = 42;</literal></entry>
<entry><type>int</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = 0;</literal></entry>
<entry><type>int</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = -1;</literal></entry>
<entry><type>int</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "1";</literal></entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "0";</literal></entry>
<entry><type>string</type></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>$x = "-1";</literal></entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "php";</literal></entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "true";</literal></entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>$x = "false";</literal></entry>
<entry><type>string</type></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
<table xml:id="types.comparisions-loose">
<title>Comparações aproximadas com <literal>==</literal></title>
<tgroup cols="12">
<thead>
<row>
<entry> </entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry><literal>1</literal></entry>
<entry><literal>0</literal></entry>
<entry><literal>-1</literal></entry>
<entry><literal>"1"</literal></entry>
<entry><literal>"0"</literal></entry>
<entry><literal>"-1"</literal></entry>
<entry>&null;</entry>
<entry><literal>[]</literal></entry>
<entry><literal>"php"</literal></entry>
<entry><literal>""</literal></entry>
</row>
</thead>
<tbody>
<row>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>1</literal></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>0</literal></entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;*</entry>
<entry>&false;*</entry>
</row>
<row>
<entry><literal>-1</literal></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"1"</literal></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"0"</literal></entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"-1"</literal></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry>&null;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
</row>
<row>
<entry><literal>[]</literal></entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"php"</literal></entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;*</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>""</literal></entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;*</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
</row>
</tbody>
</tgroup>
</table>
* &true; anteriormente ao PHP 8.0.0.
</para>
<para>
<table xml:id="type.comparisons-strict">
<title>Comparações exatas com <literal>===</literal></title>
<tgroup cols="12">
<thead>
<row>
<entry> </entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry><literal>1</literal></entry>
<entry><literal>0</literal></entry>
<entry><literal>-1</literal></entry>
<entry><literal>"1"</literal></entry>
<entry><literal>"0"</literal></entry>
<entry><literal>"-1"</literal></entry>
<entry>&null;</entry>
<entry><literal>[]</literal></entry>
<entry><literal>"php"</literal></entry>
<entry><literal>""</literal></entry>
</row>
</thead>
<tbody>
<row>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>1</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>0</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>-1</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"1"</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"0"</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"-1"</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry>&null;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>[]</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>"php"</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
<entry>&false;</entry>
</row>
<row>
<entry><literal>""</literal></entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&false;</entry>
<entry>&true;</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->