array_randВыбирает один или несколько случайных ключей из массива
&reftitle.description;
intstringarrayarray_randarrayarrayintnum1
Функция выбирает один или несколько случайных элементов из массива и возвращает
ключ, или ключи, случайных элементов.
&caution.cryptographically-insecure;
&reftitle.parameters;
array
Непустой входной массив.
num
Определяет сколько элементов выберет функция. Количество
элементов должно быть больше нуля и меньше или равно количеству
элементов массива array.
&reftitle.returnvalues;
Функция array_rand возвращает ключ случайного элемента,
когда выбирает только один элемент. В остальных случаях функция возвращает
массив ключей случайных элементов. Это сделано так, чтобы
функция могла выбрать из массива как случайные ключи, так и случайные значения.
Функция, когда возвращает массив ключей, вернёт ключи в порядке, в котором
их объявили в исходном массиве.
&reftitle.errors;
Функция выбросит исключение ValueError,
если массив array пуст
или значение параметра num выходит за пределы диапазона.
&reftitle.changelog;
&Version;&Description;8.0.0
Теперь функция array_rand выбрасывает
исключение ValueError,
если значение параметра num выходит
за пределы диапазона; раньше функция выдавала ошибку уровня
E_WARNING и возвращала значение &null;.
8.0.0
Теперь функция array_rand выбрасывает
исключение ValueError,
если массив array пуст; раньше
функция выдавала ошибку уровня E_WARNING
и возвращала значение &null;.
7.1.0
Внутренний алгоритм получения случайных чисел
изменён
с функции rand библиотеки libc на генератор
на базе Вихря Мерсенна.
&reftitle.examples;
Пример использования функции array_rand
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeysRandom\Randomizer::shuffleArray