PHP 8.3.4 Released!

gmp_random_range

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

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

説明

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

乱数を生成します。 乱数の範囲は minmax の間です。

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

警告

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

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

パラメータ

min

乱数の最小値を示すGMP数

max

乱数の最大値を示すGMP数

戻り値

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

エラー / 例外

maxmin より小さい場合、 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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top