PHP マニュアル: 等確率に選ばれた整数を取得する

説明

GMP gmp_random_range(GMPintstring $min, GMPintstring $max)

乱数を生成します。乱数の範囲は 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