Random\Engine\Mt19937::__construct

新しい Mt19937 エンジンを作成する

説明

public Random\Engine\Mt19937::__construct(intnull $seed = null, int $mode = MT_RAND_MT19937)

警告

Mt19937 (メルセンヌ・ツイスター) エンジンは、シードとして32ビットの整数だけを受け入れます。よって、2¹⁹⁹³⁷-1 もの周期を持つにも関わらず、あり得るランダムなシーケンスの数はたかだか 2³² (つまり 4,294,967,296) しかありません。

暗黙、または明示的にランダムなシードに依存する場合、重複がそれ(4,294,967,296 個)よりも早く発生します。誕生日のパラドックスによると、80,000 個以下のランダムな値を生成した場合でも、シードの重複が 50% の確率で発生します。重複したシードの 10% が、ざっと 30,000 個のランダムな値を生成したあとに発生します。

このため、無視できる確率以上に重複したシーケンスが発生してはいけないアプリケーションでは、Mt19937 は適していません。再現可能なシードが必須の場合、 Random\Engine\Xoshiro256StarStar と Random\Engine\PcgOneseq128XslRr64 が、ランダムな値が衝突しにくく、より大きなシードをサポートしています。再現可能なシードが必須でない場合、 Random\Engine\Secure が、暗号学的にセキュアなランダム性を提供します。

警告

この関数は、現在のところ詳細な情報はありません。引数のリストのみが記述されています。

パラメータ

seed

符号なし32ビットの整数として解釈される seed をシードとし、線形合同法(LCG) を使って生成された値でステートを埋めます。

seed が省略されるか、null の場合は、ランダムな符号なし32ビットの整数を使います。

mode

使用するアルゴリズムの実装を指定するために、以下の定数のうちの一つを指定します:

MT_RAND_MT19937: 正しいメルセンヌ・ツイスターの実装です。
MT_RAND_PHP: 正しくないメルセンヌ・ツイスターの実装です。 PHP 7.1.0 より前のバージョンの mt_srand と互換性を保つために残されています。

警告

この機能は PHP 8.3.0 で 非推奨になります。この機能に頼らないことを強く推奨します。

例

例1 Random\Engine\Mt19937::__construct の例

<?php
// ランダムな32ビットのシードを使います
$e = new \Random\Engine\Mt19937();

$r = new \Random\Randomizer($e);
?>