Random\Randomizer::nextInt

(PHP 8 >= 8.2.0)

Random\Randomizer::nextInt — 正の整数を取得する

public function Random\Randomizer::nextInt(): int

この関数にはパラメータはありません。

Random\Engine::generate() が返したバイト数に応じて、 0 から最大値までの正の整数を返します。正確な最大値は、2^{$engine_bytes * 8 - 1} - 1 で計算できます。

不整合を避けるため、32ビットの PHP は Random\Engine::generate() の出力サイズが 32ビットを超えた場合、 Random\RandomException をスローします。なぜなら、選択した整数値を欠けることなく返せないからです。この振る舞いは、64ビットネイティブのエンジン Random\Engine\PcgOneseq128XslRr64 と Random\Engine\Xoshiro256StarStar に影響します。 4バイト以上のランダムな値を返す、ユーザーが使えるあらゆるエンジンにも影響します。
Random\Randomizer::$engine に存在する Random\Engine::generate() メソッドがスローした、あらゆる Throwable がスローされます。

例1 Random\Randomizer::nextInt() の例

<?php
$r = new \Random\Randomizer();

// "次の" 整数をランダムに出力します
echo $r->nextInt(), "\n";
?>

上の例の出力は、たとえば以下のようになります。

8041689838856078718

There are no user contributed notes for this page.