array_rand Выбирает один или несколько случайных ключей из массива &reftitle.description; intstringarrayarray_rand arrayarray intnum1 Функция выбирает один или несколько случайных элементов из массива и возвращает ключ, или ключи, случайных элементов. &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; Пример использования функции <function>array_rand</function> ]]> &reftitle.seealso; Random\Randomizer::pickArrayKeys Random\Randomizer::shuffleArray