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

Описание

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

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

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

input: Входной массив.
num_req: Определяет количество выбираемых элементов. Попытка выбрать больше элементов, чем есть в массиве, сгенерирует ошибку уровня E_WARNING.

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

Если вы выбираете только одно значение, функция array_rand() возвращает ключ, соответствующий этому значению. В обратном случае, она возвращает массив ключей, соответствующих случайным значениям. Это сделано так образом, чтобы дать возможность выбрать из массива как случайные значения, так и случайные ключи.

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

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

Примеры

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


<?php
$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() - Перемешивает массив