array_rand

(PHP 4, PHP 5)

array_rand -- 配列から一つ以上の要素をランダムに取得する

引数

mixed array_rand ( array input [, int num_req] )

array_rand() は、 配列から一つ以上のランダムなエントリを取得しようとする場合に有用です。 この関数は、配列 input およびオプションとして num_req を引数とします。 この引数は、取得するエントリの数を指定します。 指定されない場合は、デフォルトの 1 になります。

エントリを一つだけ取得する場合、 array_rand() はランダムなエントリのキーを返します。 その他の場合は、ランダムなエントリのキーの配列を返します。 これにより、ランダムなキーを取得し、 配列から値を取得することが可能になります。

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

例 1. array_rand() の例

<?php
srand
((float) microtime() * 10000000);
$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($input, 2);
echo
$input[$rand_keys[0]] . "\n";
echo
$input[$rand_keys[1]] . "\n";
?>

shuffle() も参照してください。