正の整数を取得する

# 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open