PHPマニュアル/PEARマニュアル | ユーザフォーラムで議論/質問 | マニュアル検索 | ハイライト | ハイライトオフ | ポータル | php spot

array_rand - 配列から一つ以上の要素をランダムに取得する | JavaScript入門&応用&リファレンスなら「JavaScriptist」

  

array_rand

(PHP 4, PHP 5, PHP 7)

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

説明

mixed array_rand ( array $array [, int $num = 1 ] )

一つ以上のランダムなエントリを配列から取り出し、 取り出したエントリのキーを返します。 この関数が使う疑似乱数生成器は、暗号学的な使い方には適していません。

パラメータ

array

入力の配列。

num

取得するエントリの数を指定します。

返り値

エントリを一つだけ取得する場合、 array_rand() はランダムなエントリのキーを返します。 その他の場合は、ランダムなエントリのキーの配列を返します。 これにより、ランダムな値だけではなくランダムなキーも配列から取得できるようになります。 配列の中にある要素数より多くの要素を取り出そうとすると E_WARNING レベルのエラーが発生し、NULL を返します。

変更履歴

バージョン 説明
7.1.0 The internal randomization algorithm has been changed to use the » Mersenne Twister Random Number Generator instead of the libc rand function.
5.2.10 結果の配列のキーがシャッフルされなくなりました。

例1 array_rand() の例

<?php
srand
((float) microtime() * 10000000);
$input = array("ネオ""モーフィアス""トリニティ""サイファー""タンク");
$rand_keys array_rand($input2);
echo 
$input[$rand_keys[0]] . "\n";
echo 
$input[$rand_keys[1]] . "\n";
?>

注意

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

参考


忘却曲線を使ってこの関数を確実に記憶に残す

フォーラムで「array_rand - 配列から一つ以上の要素をランダムに取得する」について話す
各種マニュアル: PHPマニュアル | PEARマニュアル | Smarty(英語)マニュアル | PHP-GTKマニュアル | array_rand - 配列から一つ以上の要素をランダムに取得する」をGoogle検索
copyright © 1997-2024 PHP ドキュメント作成グループ(ライセンス). provided by php spot. マニュアル: