<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.random.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'function.lcg-value.php',
    1 => 'lcg_value',
    2 => 'Gerador congruente linear combinado',
  ),
  'up' => 
  array (
    0 => 'ref.random.php',
    1 => 'Fun&ccedil;&otilde;es Random',
  ),
  'prev' => 
  array (
    0 => 'function.getrandmax.php',
    1 => 'getrandmax',
  ),
  'next' => 
  array (
    0 => 'function.mt-getrandmax.php',
    1 => 'mt_getrandmax',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/random/functions/lcg-value.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.lcg-value" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">lcg_value</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">lcg_value</span> &mdash; <span class="dc-title">Gerador congruente linear combinado</span></p>

 </div>

 <div id="function.lcg-value-refsynopsisdiv">
  <div class="warning"><strong class="warning">Aviso</strong><p class="simpara">Esta função foi
<em>DESCONTINUADA</em> a partir do PHP 8.4.0. O uso desta função
é fortemente desencorajado.</p></div>
 </div>

 <div class="refsect1 description" id="refsect1-function.lcg-value-description">
  <h3 class="title">Descrição</h3>
  <div class="methodsynopsis dc-description">
   <span class="attribute"><a href="class.deprecated.php">#[\Deprecated]</a> </span><br>
   <span class="methodname"><strong>lcg_value</strong></span>(): <span class="type"><a href="language.types.float.php" class="type float">float</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>lcg_value()</strong></span> retorna um número pseudoaleatório no
   intervalo de (0, 1). A função combina dois CGs com períodos
   de 2^31 - 85 e 2^31 - 249. O período desta função é igual
   ao produto de ambos os primos.
  </p>
  <div class="caution"><strong class="caution">Cuidado</strong>
 <p class="para">
  Esta função não gera valores criptograficamente seguros e <em>não deve</em>
  ser usada para propósitos criptográficos ou fins que exijam que os valores retornados sejam impossíveis de adivinhar.
 </p>
 <p class="para">
  Se aleatoriedade criptograficamente segura for necessária, a classe <span class="classname"><a href="class.random-randomizer.php" class="classname">Random\Randomizer</a></span> pode ser
  usada com o mecanismo <span class="classname"><a href="class.random-engine-secure.php" class="classname">Random\Engine\Secure</a></span>. Para casos de uso simples, as funções <span class="function"><a href="function.random-int.php" class="function">random_int()</a></span>
  e <span class="function"><a href="function.random-bytes.php" class="function">random_bytes()</a></span> fornecem uma <abbr title="Application Programming Interface">API</abbr> conveniente e segura que é garantida pelo
  <abbr title="Cryptographically Secure PseudoRandom Number Generator">CSPRNG</abbr> do sistema operacional.
 </p>
</div>
  <div class="caution"><strong class="caution">Cuidado</strong>
   <p class="para">
    Escalar o valor de retorno para um intervalo diferente usando multiplicação
    ou adição (também chamado de transformação afim) pode resultar em uma tendência
    no valor resultante, pois os pontos flutuantes não são igualmente densos ao longo da reta
    numérica. Como nem todos os valores podem ser representados exatamente por um ponto flutuante, o
    resultado da transformação afim também pode resultar em valores fora
    do intervalo solicitado.
   </p>
   <p class="para">
    Use <span class="methodname"><a href="random-randomizer.getfloat.php" class="methodname">Random\Randomizer::getFloat()</a></span> para gerar um
    float aleatório dentro de um intervalo arbitrário. Use <span class="methodname"><a href="random-randomizer.getint.php" class="methodname">Random\Randomizer::getInt()</a></span>
    para gerar um número inteiro aleatório dentro de um intervalo arbitrário.
   </p>
  </div>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.lcg-value-parameters">
  <h3 class="title">Parâmetros</h3>
  <p class="para">Esta função não possui parâmetros.</p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.lcg-value-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="para">
   Um valor flutuante pseudoaleatório entre 0,0 e 1,0, inclusive.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.lcg-value-changelog">
  <h3 class="title">Registro de Alterações</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versão</th>
      <th>Descrição</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.4.0</td>
      <td>
       Esta função foi descontinuada.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-function.lcg-value-seealso">
  <h3 class="title">Veja Também</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="methodname"><a href="random-randomizer.getfloat.php" class="methodname" rel="rdfs-seeAlso">Random\Randomizer::getFloat()</a> - Obt&eacute;m um float selecionado uniformemente</span></li>
    <li><span class="methodname"><a href="random-randomizer.getint.php" class="methodname" rel="rdfs-seeAlso">Random\Randomizer::getInt()</a> - Obt&eacute;m um inteiro selecionado uniformemente</span></li>
    <li><span class="function"><a href="function.random-int.php" class="function" rel="rdfs-seeAlso">random_int()</a> - Obt&eacute;m um n&uacute;mero inteiro selecionado uniformemente e criptograficamente seguro</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>