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);
print
$input[$rand_keys[0]]."\n";
print
$input[$rand_keys[1]]."\n";
?>