rand

(PHP 3, PHP 4, PHP 5)

rand -- 乱数を生成する

説明

int rand ( [int min, int max] )

オプションの引数 min,max を省略してコールした場合、rand() は 0 と RAND_MAX の間の擬似乱数(整数)を返します。 例えば、5 から 15 まで(両端を含む)の乱数を得たい場合、 rand(5,15) とします。

注意: (Windows のような)いくつかのプラットフォームでは、RAND_MAX は 32768 と小さな値となっています。 32768 より広い範囲にしたい場合、 min および max を指定することで、 RAND_MAX より大きな範囲の乱数を生成することができます。 もしくは、 mt_rand() をかわりに使用してみてください。

注意: PHP 4.2.0 以降、 srand() または mt_srand() によりランダム数生成器にシードを与える必要はありません。 これは、この処理が自動的に行われるためです。

パラメータ

min

返す値の最小値 (デフォルトは 0)。

max

返す値の最大値 (デフォルトは RAND_MAX)。

返り値

min (あるいは 0) から max (あるいは RAND_MAX、それぞれ端点を含む) までの間の疑似乱数値を返します。

変更履歴

バージョン説明
3.0.7 以降 3.0.7 より前のバージョンでは、max の意味は range でした。これらのバージョンにおいて 同じ結果を得るために簡単な例を示すと、 5 から 15 までの乱数を得たい場合には rand (5, 11) とする必要があります。

例 1. rand() の例

<?php
echo rand() . "\n";
echo
rand() . "\n";

echo
rand(5, 15);
?>

上の例の出力は、たとえば 以下のようになります。

7771
22264
11

参考

srand()
getrandmax()
mt_rand()