<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.random-engine-mt19937.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'random-engine-mt19937.construct.php',
    1 => 'Random\\Engine\\Mt19937::__construct',
    2 => 'Constructs a new Mt19937 engine',
  ),
  'up' => 
  array (
    0 => 'class.random-engine-mt19937.php',
    1 => 'Random\\Engine\\Mt19937',
  ),
  'prev' => 
  array (
    0 => 'class.random-engine-mt19937.php',
    1 => 'Random\\Engine\\Mt19937',
  ),
  'next' => 
  array (
    0 => 'random-engine-mt19937.debuginfo.php',
    1 => 'Random\\Engine\\Mt19937::__debugInfo',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/random/random/engine/mt19937/construct.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="random-engine-mt19937.construct" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Random\Engine\Mt19937::__construct</h1>
  <p class="verinfo">(PHP 8 &gt;= 8.2.0)</p><p class="refpurpose"><span class="refname">Random\Engine\Mt19937::__construct</span> &mdash; <span class="dc-title">Constructs a new Mt19937 engine</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-random-engine-mt19937.construct-description">
  <h3 class="title">说明</h3>
  <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><strong>Random\Engine\Mt19937::__construct</strong></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.integer.php" class="type int">int</a></span></span> <code class="parameter">$seed</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$mode</code><span class="initializer"> = <strong><code><a href="random.constants.php#constant.mt-rand-mt19937">MT_RAND_MT19937</a></code></strong></span></span>)</div>

  <p class="para rdfs-comment">

  </p>

  <div class="caution"><strong class="caution">警告</strong>
 <p class="para">
  由于 Mt19937（“梅森旋转算法”）引擎仅接受 32 位整数作为种子，因此尽管 Mt19937 的范围为
  2<sup class="superscript">19937</sup>-1，但可能的随机序列数量仅限于 2<sup class="superscript">32</sup>（即 4,294,967,296）。
 </p>
 <p class="para">
  当依赖隐式或显式随机播种时，重复会出现得更早。根据生日问题，在少于 80,000 个随机生成的种子后，预计重复种子的概率为
  50%。在随机生成大约 30,000 个种子后，重复种子的概率为 10%。
 </p>
 <p class="para">
  This makes Mt19937 unsuitable for applications where duplicated sequences must not happen with
  more than a negligible probability.
  如果需要可重复的种子，<span class="classname"><a href="class.random-engine-xoshiro256starstar.php" class="classname">Random\Engine\Xoshiro256StarStar</a></span> 和
  <span class="classname"><a href="class.random-engine-pcgoneseq128xslrr64.php" class="classname">Random\Engine\PcgOneseq128XslRr64</a></span> 引擎都支持更大的种子，它们不太可能随机碰撞。如果不需要再现性，<span class="classname"><a href="class.random-engine-secure.php" class="classname">Random\Engine\Secure</a></span>
  引擎提供加密安全随机性。
 </p>
</div>
 </div>


 <div class="refsect1 parameters" id="refsect1-random-engine-mt19937.construct-parameters">
  <h3 class="title">参数</h3>
  <dl>
   
    <dt><code class="parameter">seed</code></dt>
    <dd>
     <p class="para">
      Fills the state with values generated with a linear congruential generator
      that was seeded with <code class="parameter">seed</code> interpreted as an unsigned
      32 bit integer.
     </p>

     <p class="para">
      If <code class="parameter">seed</code> is omitted or <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, a random unsigned
      32 bit integer will be used.
     </p>
    </dd>
   
   
    <dt><code class="parameter">mode</code></dt>
    <dd>
     <p class="para">
      Use one of the following constants to specify the implementation of the algorithm to use.
      <ul class="simplelist">
       <li>
        <strong><code><a href="random.constants.php#constant.mt-rand-mt19937">MT_RAND_MT19937</a></code></strong>:
        The correct Mt19937 implementation.
       </li>
       <li>
        <strong><code><a href="random.constants.php#constant.mt-rand-php">MT_RAND_PHP</a></code></strong>:
        An incorrect implementation for backwards compatibility with <span class="function"><a href="function.mt-srand.php" class="function">mt_srand()</a></span> prior to
        PHP 7.1.0.
       </li>
      </ul>
     </p>
     <div class="warning"><strong class="warning">警告</strong><p class="simpara">本特性已自 PHP 8.3.0
起<em>废弃</em>。强烈建议不要使用本特性。</p></div>
    </dd>
   
  </dl>
 </div>


 


 <div class="refsect1 examples" id="refsect1-random-engine-mt19937.construct-examples">
  <h3 class="title">示例</h3>
  <div class="example" id="example-1">
   <p><strong>示例 #1 <span class="function"><strong>Random\Engine\Mt19937::__construct()</strong></span> example</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">// Uses a random 32 Bit seed.<br /></span><span style="color: #0000BB">$e </span><span style="color: #007700">= new </span><span style="color: #0000BB">\Random\Engine\Mt19937</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">$r </span><span style="color: #007700">= new </span><span style="color: #0000BB">\Random\Randomizer</span><span style="color: #007700">(</span><span style="color: #0000BB">$e</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>



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