Random\Randomizer
PHP マニュアル

Random\Randomizer::nextInt

正の整数を取得する

説明

public int Random\Randomizer::nextInt()

警告

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

パラメータ

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

戻り値

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