Random\Engine\Mt19937::__construct

(PHP 8 >= 8.2.0)

Random\Engine\Mt19937::__construct — 新しい Mt19937 エンジンを作成する

説明

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

警告

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

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

このため、無視できる確率以上に重複したシーケンスが発生してはいけないアプリケーションでは、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);
?>