等確率に選ばれた整数を取得する

# gmp_random_range

(PHP 5 >= 5.6.3, PHP 7, PHP 8)

gmp_random_range — 等確率に選ばれた整数を取得する

### 説明

function gmp_random_range(GMP|int|string `$min`, GMP|int|string `$max`): GMP

乱数を生成します。 乱数の範囲は `min` と `max` の間です。

`min` と `max` は両方負の値を指定できますが、 `min` は `max` よりも常に小さくなければいけません。

警告

この関数が生成する値は、暗号学的にセキュアではありません。そのため、これを暗号や、戻り値を推測できないことが必須の値として使っては いけません。

暗号学的にセキュアな乱数が必要な場合は、Random\Randomizer を Random\Engine\Secure と一緒に使いましょう。簡単なユースケースの場合、random_int() と random_bytes() 関数が、オペレーティングシステムの CSPRNG を使った、 便利で安全な API を提供します。

### パラメータ

`min`

  乱数の最小値を示すGMP数

`max`

  乱数の最大値を示すGMP数

### 戻り値

閉区間 [`min`, `max`] から等確率に選ばれた整数を含む GMP オブジェクトを返します。 `min` と `max` も両方、 返される値に含まれる可能性があります。

### エラー / 例外

`max` が `min` より小さい場合、 ValueError がスローされます。

### 例

例1 gmp_random_range() の例

    <?php
    $rand1 = gmp_random_range(0, 100);    // random number between 0 and 100
    $rand2 = gmp_random_range(-100, -10); // random number between -100 and -10

    echo gmp_strval($rand1) . "\n";
    echo gmp_strval($rand2) . "\n";
    ?>

上の例の出力は以下となります。

    42
    -67

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