Функция array-rand - Выбирает один или несколько случайных ключей из массива

array_rand

Поддерживаемые версии PHP: (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 Внутренний алгоритм получения случайных чисел изменен с функции rand библиотеки libc на генератор на базе » Вихря Мерсена.
5.2.10 Возвращаемый массив ключей больше не возвращается в случайном порядке.
4.2Генератор случайных чисел инициализируется автоматически.

Примеры работы

Пример #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";
?>


Возврат к списку