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