array_rand ( array [, int])

解説

配列から一つ以上の要素をランダムに取得できます。オプションとして指定できる引数は取得するエントリの数を指定します。指定されない場合はデフォルトの1になります。要素を一つだけ取得する場合にはランダムなエントリのキーを返しますが、その他の場合はランダムなエントリのキーの配列を返します。

要件

これらの関数は、標準モジュールの一部として利用可能であり、常に使用できます。

インストールの手順

これらの関数はPHPコアに含まれるため、使用する際にインストールは不要です。

実行用の設定

この拡張モジュールは設定ディレクティブを全く定義しません。

リソース型

この拡張モジュールはリソース型を全く定義しません。

記述例

<?php
$input = array ("a", "b", "c", "d", "e", "f", "g");
$rand_keys = array_rand ($input, 3);
print $input[$rand_keys[0]]."<br>\n";
print $input[$rand_keys[1]]."<br>\n";
print $input[$rand_keys[2]]."<br>\n";
?>

[ランダムに３個の値が表示されます。]