array_rand
(PHP 4, PHP 5, PHP 7)
array_rand — Выбирает один или несколько случайных ключей из массива
Описание
$array
, int $num = 1
) : int|string|arrayВыбирает одно или несколько случайных значений из массива. Возвращает ключ (или ключи) данных случайных элементов. Данная функция использует псевдослучайный генератор и не предназначена для использования в криптографических целях.
Список параметров
-
array -
Входной массив.
-
num -
Определяет количество выбираемых элементов.
Возвращаемые значения
Если вы выбираете только одно значение, функция array_rand()
возвращает ключ, соответствующий этому значению. В обратном случае, она возвращает
массив ключей, соответствующих случайным значениям. Это сделано для того, чтобы дать
возможность выбрать из массива как случайные значения, так и случайные ключи. Если возвращается несколько ключей,
они будут возвращены в том порядке, в котором они присутствовали в исходном массиве.
Попытка выбрать больше элементов, чем есть в массиве, сгенерирует ошибку
уровня E_WARNING и вернет NULL.
Список изменений
| Версия | Описание |
|---|---|
| 7.1.0 | Внутренний алгоритм получения случайных чисел изменен с функции rand библиотеки libc на генератор на базе » Вихря Мерсена. |
Примеры
Пример #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";
?>