<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.types.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'language.types.float.php',
    1 => 'N&uacute;meros de ponto flutuante',
    2 => 'N&uacute;meros de ponto flutuante',
  ),
  'up' => 
  array (
    0 => 'language.types.php',
    1 => 'Tipos',
  ),
  'prev' => 
  array (
    0 => 'language.types.integer.php',
    1 => 'Inteiros',
  ),
  'next' => 
  array (
    0 => 'language.types.string.php',
    1 => 'Strings',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'language/types/float.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.types.float" class="sect1">
 <h2 class="title">Números de ponto flutuante</h2>

 <p class="para">
  Números de ponto flutuante (também conhecidos como &quot;floats&quot;, &quot;doubles&quot; ou &quot;números reais&quot;), podem ser
  especificados utilizando qualquer uma das seguintes sintaxes:
 </p>

 <div class="informalexample">
  <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1.234</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">1.2e3</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= </span><span style="color: #0000BB">7E-10</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$d </span><span style="color: #007700">= </span><span style="color: #0000BB">1_234.567</span><span style="color: #007700">; </span><span style="color: #FF8000">// a partir do PHP 7.4.0<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
  </div>

 </div>

 <p class="para">
  Formalmente a partir do PHP 7.4.0 (anteriormente, sublinhados não eram permitidos):
 </p>

 <div class="informalexample">
  <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
LNUM          [0-9]+(_[0-9]+)*
DNUM          ({LNUM}?&quot;.&quot;{LNUM}) | ({LNUM}&quot;.&quot;{LNUM}?)
EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
</pre></div>
  </div>

 </div>

 <p class="para">
  O tamanho de um número de ponto flutuante depende da plataforma, sendo o máximo de ~1.8e308 com
  precisão de 14 dígitos decimais um valor comum (número de 64 bits no formato
  IEEE).
 </p>

 <div class="warning"><strong class="warning">Aviso</strong>
  <h1 class="title">Precisão de números de ponto flutuante</h1>

  <p class="para">
   Números de ponto flutuante tem precisão limitada. Embora dependa do sistema,
   o PHP geralmente utiliza o formato de precisão dupla do IEEE 754, que
   trará uma precisão máxima devida a arredondamentos da ordem de 1.11e-16.
   Operações matemáticas incomuns poderão ocasionar erros maiores, e, claro,
   a propagação de erros deve ser considerada quando várias operações
   forem realizadas.
  </p>

  <p class="para">
   Além disso, números racionais que têm representação exata em números
   em base 10, como <code class="literal">0.1</code> ou
   <code class="literal">0.7</code>, não possuem representação exata em ponto flutuante
   na base 2, o formato utilizado internamente, não importando o tamanho
   da mantissa. Portanto, não existe conversão para o formato interno sem
   uma pequena perda de precisão. Isso pode ocasionar resultados
   confusos: por exemplo, <code class="literal">floor((0.1+0.7)*10)</code> normalmente
   retornará <code class="literal">7</code>, em vez do resultado esperado <code class="literal">8</code>,
   porque a representação interna final será algo como
   <code class="literal">7.9999999999999991118...</code>.
  </p>

  <p class="para">
   Então, nunca confie em resultados com números de ponto flutuante até a última casa, e
   nunca compare números de ponto flutuante em igualdades. Se você realmente
   precisar de alta precisão, você pode utilizar as <a href="ref.bc.php" class="link">funções matemáticas de precisão arbitrária</a>
   e as funções <a href="ref.gmp.php" class="link">gmp</a> estão disponíveis.
  </p>

  <p class="para">
   Para uma explicação &quot;simples&quot; dessa questão, veja o <a href="http://floating-point-gui.de/" class="link external">&raquo;&nbsp;guia sobre ponto flutuante</a>,
   que também tem o título alternativo de &quot;Porque meus números não somam direito?&quot;.
  </p>
 </div>

 <div class="sect2" id="language.types.float.casting">
  <h3 class="title">Convertendo para float</h3>

  <div class="sect3" id="language.types.float.casting.from-string">
   <h4 class="title">A partir de strings</h4>

   <p class="simpara">
    Se a string é
    <a href="language.types.numeric-strings.php" class="link">numérica</a>
    ou começa numérica então ela irá resolver para o
    valor float correspondente, do contrário ela é convertida em zero
    (<code class="literal">0</code>).
   </p>
  </div>

  <div class="sect3" id="language.types.float.casting.from-other">
   <h4 class="title">A partir de outros tipos</h4>

   <p class="para">
    Para valores de outros tipos, a conversão é realizada convertendo o
    valor para <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> primeiro e em seguida para <span class="type"><a href="language.types.float.php" class="type float">float</a></span>. Veja
    <a href="language.types.integer.php#language.types.integer.casting" class="link">Convertendo para inteiro</a>
    para mais informações.
   </p>

   <blockquote class="note"><p><strong class="note">Nota</strong>: 
    <p class="para">
     Como certos tipos têm comportamento indefinido ao converter para
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>, este também é o caso ao converter para
     <span class="type"><a href="language.types.float.php" class="type float">float</a></span>.
    </p>
   </p></blockquote>
  </div>
 </div>

 <div class="sect2" id="language.types.float.comparison">
  <h3 class="title">Comparando floats</h3>

  <p class="para">
   Como notado acima, testar números de ponto flutuante com igualdade é
   problemático, por causa da maneira como são representados internamente. Entretanto
   existem maneiras de fazer comparações com números de ponto flutuante que
   contornam essas limitações.
  </p>

  <p class="para">
   Para testar números de ponto flutuante, utilize um &quot;valor de erro máximo&quot;
   na comparação utilizada. Esse valor é também chamado de epsilon,
   ou unidade de erro, e deve ser a diferença mínima aceitável no resultado dos cálculos.
  </p>

  <p class="para">
   <var class="varname">$a</var> e <var class="varname">$b</var> serão consideradas iguais
   até o 5º dígito de precisão.
  </p>

  <div class="example" id="example-1">
   <p><strong>Exemplo #1 Comparando números de ponto flutuante</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1.23456789</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">1.23456780</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$epsilon </span><span style="color: #007700">= </span><span style="color: #0000BB">0.00001</span><span style="color: #007700">;<br /><br />if (</span><span style="color: #0000BB">abs</span><span style="color: #007700">(</span><span style="color: #0000BB">$a </span><span style="color: #007700">- </span><span style="color: #0000BB">$b</span><span style="color: #007700">) &lt; </span><span style="color: #0000BB">$epsilon</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"iguais"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>

 <div class="sect2" id="language.types.float.nan">
  <h3 class="title">NaN</h3>
  <p class="para">
   Algumas operações numéricas podem resultar em valores representados pela constante
   <strong><code><a href="math.constants.php#constant.nan">NAN</a></code></strong>. Esse resultado representa um valor desconhecido
   ou não representável nos cálculos de ponto flutuante. Qualquer comparação frouxa
   ou restrita deste valor com qualquer outro, inclusive ele mesmo, com exceção de <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, terá
   como resultado <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
  </p>
  <p class="para">
   Como o <strong><code><a href="math.constants.php#constant.nan">NAN</a></code></strong> representa um resultado irrepresentável,
   <strong><code><a href="math.constants.php#constant.nan">NAN</a></code></strong> não deve ser comparado com outros valores, incluindo
   ele mesmo, em vez disso, deve-se checá-lo utilizando a função <span class="function"><a href="function.is-nan.php" class="function">is_nan()</a></span>.
  </p>
 </div>
</div><?php manual_footer($setup); ?>