array_rand
(PHP 4, PHP 5)
array_rand — 配列から一つ以上の要素をランダムに取得する
説明
array_rand() は、 配列から一つ以上のランダムなエントリを取得しようとする場合に有用です。
パラメータ
- input
-
入力の配列。
- num_req
-
取得するエントリの数を指定します。 指定されない場合は、デフォルトの 1 になります。
返り値
エントリを一つだけ取得する場合、 array_rand() はランダムなエントリのキーを返します。 その他の場合は、ランダムなエントリのキーの配列を返します。 これにより、ランダムなキーを取得し、 配列から値を取得することが可能になります。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.2.10 | 結果の配列のキーがシャッフルされなくなりました。 |
| 4.2.0 | 乱数生成器が自動的にシードを生成するようになりました。 |
例
例1 array_rand() の例
<?php
srand((float) microtime() * 10000000);
$input = array("ネオ", "モーフィアス", "トリニティ", "サイファー", "タンク");
$rand_keys = array_rand($input, 2);
echo $input[$rand_keys[0]] . "\n";
echo $input[$rand_keys[1]] . "\n";
?>
注意
注意: PHP 4.2.0 以降、 srand() または mt_srand() によりランダム数生成器にシードを与える必要はありません。 これは、この処理が自動的に行われるためです。
