array_rand
(PHP 4, PHP 5, PHP 7, PHP 8)
array_rand - Вибирає один або кілька випадкових ключів з масиву
Опис
array_rand(array $array, int $num = 1): int|string|array
Вибирає одне чи кілька випадкових значень із масиву. Повертає ключ (або ключі) даних випадкових елементів.
Застереження
Функція не створює криптографічно захищені значення та не повинна використовуватися для криптографічних цілей або цілей, що вимагають, щоб значення, що повертаються, були недоступні для розгадування.
Якщо потрібна криптографічно безпечна випадкова послідовність, можна використати клас Random\Randomizer з двигуном Random\Engine\Secure. Для простих сценаріїв є функції random_int() і random_bytes() із зручним API криптографічно безпечного генератора псевдовипадкових чисел (CSPRNG), що підтримується операційною системою.
Список параметрів
array
Вхідний масив
num
Визначає кількість елементів, що вибираються.
Значення, що повертаються
Якщо ви вибираєте лише одне значення, функція array_rand() повертає ключ, який відповідає цьому значенню. У протилежному випадку вона повертає масив ключів, що відповідають випадковим значенням. Це зроблено для того, щоб дати можливість вибрати з масиву випадкові значення, так і випадкові ключі. Якщо повертається кілька ключів, вони будуть повернуті в порядку, в якому вони були присутні у вихідному масиві. Спроба вибрати більше елементів, ніж у масиві, згенерує помилку рівня E_WARNING та поверне NULL.
список змін
| Версия | Опис |
|---|---|
| 7.1.0 | Внутрішній алгоритм отримання випадкових чисел змінено з функції rand бібліотеки libc на генератор на базі » Вихор Мерсенна |
Приклади
Приклад #1 Приклад використання array_rand()****
Дивіться також
- Random\Randomizer::pickArrayKeys() - Вибирає випадкові ключі масиву
- Random\Randomizer::shuffleArray() - Отримує перестановку масиву