<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/refs.math.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'book.bc.php',
    1 => 'BC Math',
    2 => 'Fun&ccedil;&otilde;es matem&aacute;ticas de precis&atilde;o arbitr&aacute;ria',
  ),
  'up' => 
  array (
    0 => 'refs.math.php',
    1 => 'Extens&otilde;es Matem&aacute;ticas',
  ),
  'prev' => 
  array (
    0 => 'refs.math.php',
    1 => 'Extens&otilde;es Matem&aacute;ticas',
  ),
  'next' => 
  array (
    0 => 'bc.setup.php',
    1 => 'Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/bc/book.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/book.bc.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="book.bc" class="book">
 
 <h1 class="title">Funções matemáticas de precisão arbitrária</h1>
 

 
 <div id="intro.bc" class="preface">
  <h1 class="title">Introdução</h1>
  <p class="para">
   Para matemática de precisão arbitrária, o PHP oferece BCMath, que
   suporta números de qualquer tamanho e com precisão de até <code class="literal">2147483647</code> (ou <code class="literal">0x7FFFFFFF</code>) dígitos decimais,
   até a memória disponível, representadas como strings.
  </p>
  <p class="para">
   Numéros válido (ou bem formados) são strings que concordam com a expressão regular
   <code class="literal">/^[+-]?[0-9]*(\.[0-9]*)?$/</code>.
  </p>
  <div class="caution"><strong class="caution">Cuidado</strong>
   <p class="para">
    Passar valores de tipo <span class="type"><a href="language.types.float.php" class="type float">float</a></span> para uma função BCMatch, que espera
    um operando <span class="type"><a href="language.types.string.php" class="type string">string</a></span> pode não funcionar como esperado dado que
    o PHP converte valores <span class="type"><a href="language.types.float.php" class="type float">float</a></span> para <span class="type"><a href="language.types.string.php" class="type string">string</a></span>, especificamente
    que a <span class="type"><a href="language.types.string.php" class="type string">string</a></span> convertida pode estar numa notação exponencial (que não é
    suportado no BCMath), e dado que, anteriormente ao PHP 8.0.0, o separador decimal depende da locale configurada
    (enquanto BCMath sempre trabalho com ponto).
   </p>
   <div class="informalexample">
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$num1 </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">; </span><span style="color: #FF8000">// (string) 0 =&gt; '0'<br /></span><span style="color: #0000BB">$num2 </span><span style="color: #007700">= -</span><span style="color: #0000BB">0.000005</span><span style="color: #007700">; </span><span style="color: #FF8000">// (string) -0.000005 =&gt; '-5.05E-6'<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">bcadd</span><span style="color: #007700">(</span><span style="color: #0000BB">$num1</span><span style="color: #007700">, </span><span style="color: #0000BB">$num2</span><span style="color: #007700">, </span><span style="color: #0000BB">6</span><span style="color: #007700">); </span><span style="color: #FF8000">// =&gt; '0.000000'<br /><br /></span><span style="color: #0000BB">setlocale</span><span style="color: #007700">(</span><span style="color: #0000BB">LC_NUMERIC</span><span style="color: #007700">, </span><span style="color: #DD0000">'de_DE'</span><span style="color: #007700">); </span><span style="color: #FF8000">// usa uma vírgula como separador de decimais<br /></span><span style="color: #0000BB">$num2 </span><span style="color: #007700">= </span><span style="color: #0000BB">1.2</span><span style="color: #007700">; </span><span style="color: #FF8000">// (string) 1.2 =&gt; '1,2'<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">bcsub</span><span style="color: #007700">(</span><span style="color: #0000BB">$num1</span><span style="color: #007700">, </span><span style="color: #0000BB">$num2</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">); </span><span style="color: #FF8000">// =&gt; '0.0'<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </div>
 </div>
 

 







 







 





<ul class="chunklist chunklist_book"><li><a href="bc.setup.php">Instala&ccedil;&atilde;o/Configura&ccedil;&atilde;o</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="bc.installation.php">Instala&ccedil;&atilde;o</a></li><li><a href="bc.configuration.php">Configura&ccedil;&otilde;es em Execu&ccedil;&atilde;o</a></li></ul></li><li><a href="ref.bc.php">BC Math Fun&ccedil;&otilde;es</a><ul class="chunklist chunklist_book chunklist_children"><li><a href="function.bcadd.php">bcadd</a> — Adiciona dois n&uacute;meros de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcceil.php">bcceil</a> — Arredonda para cima n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bccomp.php">bccomp</a> — Compara dois n&uacute;meros de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcdiv.php">bcdiv</a> — Divide dois n&uacute;meros de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcdivmod.php">bcdivmod</a> — Obt&eacute;m o quociente e o m&oacute;dulo de um n&uacute;mero de precis&atilde;o arbitr&aacute;rio</li><li><a href="function.bcfloor.php">bcfloor</a> — Arredonda para baixo um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcmod.php">bcmod</a> — Obt&eacute;m o resto de uma divis&atilde;o com precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcmul.php">bcmul</a> — Multiplica dois n&uacute;meros de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcpow.php">bcpow</a> — Eleva um n&uacute;mero de precis&atilde;o arbitr&aacute;ria a outro</li><li><a href="function.bcpowmod.php">bcpowmod</a> — Eleva um n&uacute;mero de precis&atilde;o arbitr&aacute;ria para outro, reduzido por um m&oacute;dulo especificado</li><li><a href="function.bcround.php">bcround</a> — Arredonda n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcscale.php">bcscale</a> — Configura ou obt&ecirc;m o par&acirc;metro escala para todas as fun&ccedil;&otilde;es bc</li><li><a href="function.bcsqrt.php">bcsqrt</a> — Obt&eacute;m a raiz quadrada de um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="function.bcsub.php">bcsub</a> — Subtrai um n&uacute;mero de precis&atilde;o arbitr&aacute;ria de outro</li></ul></li><li><a href="class.bcmath-number.php">BcMath\Number</a> — A classe BcMath\Number<ul class="chunklist chunklist_book chunklist_children"><li><a href="bcmath-number.add.php">BcMath\Number::add</a> — Adiciona um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.ceil.php">BcMath\Number::ceil</a> — Arredonda para cima um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.compare.php">BcMath\Number::compare</a> — Compara dois n&uacute;meros de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.construct.php">BcMath\Number::__construct</a> — Cria um objeto BcMath\Number</li><li><a href="bcmath-number.div.php">BcMath\Number::div</a> — Divide por um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.divmod.php">BcMath\Number::divmod</a> — Obt&eacute;m quociente e resto de um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.floor.php">BcMath\Number::floor</a> — Arredonda para baixo um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.mod.php">BcMath\Number::mod</a> — Obt&eacute;m o resto de um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.mul.php">BcMath\Number::mul</a> — Multiplica um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.pow.php">BcMath\Number::pow</a> — Eleva um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.powmod.php">BcMath\Number::powmod</a> — Eleva um n&uacute;mero de precis&atilde;o arbitr&aacute;ria, reduzido por um m&oacute;dulo especificado</li><li><a href="bcmath-number.round.php">BcMath\Number::round</a> — Arredonda um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.serialize.php">BcMath\Number::__serialize</a> — Serializa um objeto BcMath\Number</li><li><a href="bcmath-number.sqrt.php">BcMath\Number::sqrt</a> — Obt&eacute;m a raiz quadrada de um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.sub.php">BcMath\Number::sub</a> — Subtrai um n&uacute;mero de precis&atilde;o arbitr&aacute;ria</li><li><a href="bcmath-number.tostring.php">BcMath\Number::__toString</a> — Converte BcMath\Number em uma string</li><li><a href="bcmath-number.unserialize.php">BcMath\Number::__unserialize</a> — Desserializa um par&acirc;metro de dados em um objeto BcMath\Number</li></ul></li></ul></div><?php manual_footer($setup); ?>