Выбирает одно или несколько случайных значений из массива


(PHP 4, PHP 5)

array_randВыбирает одно или несколько случайных значений из массива

Описание

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

Выбирает одно или несколько случайных значений из массива. Возвращает ключ (или ключи) данных случайных элементов.

Список параметров

array

Входной массив.

num

Определяет количество выбираемых элементов.

Возвращаемые значения

При выборе только одного элемента, array_rand() возвращает ключ для случайного элемента. В других случаях, возвращается массив ключей случайных элементов. Так сделано, чтобы можно было получить из массива как случайные ключи, так и случайные значения по ним. При попытке получить больше элементов, чем было в массиве приведет к ошибке уровня E_WARNING, и будет вовзращен NULL.

Список изменений

Версия Описание
5.2.10 Возвращаемый массив ключей больше не возвращается в случайном порядке.

Примеры

Пример #1 Пример использования array_rand()

<?php
$input 
= array("Neo""Morpheus""Trinity""Cypher""Tank");
$rand_keys array_rand($input2);
echo 
$input[$rand_keys[0]] . "\n";
echo 
$input[$rand_keys[1]] . "\n";
?>

Смотрите также

  • shuffle() - Перемешивает массив