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()

<?php
$numbers
= range(1, 20);
shuffle($numbers);
foreach (
$numbers as $number) {
echo
"$number ";
}
?>

Примітки

Зауваження: Ця функція призначає нові ключі для елементів в масиві array. Вона видаляє будь-які наявні ключі, а не просто перевпорядковує їх.

Зауваження:

Скидає внутрішній вказівник масиву на перший елемент.

Прогляньте також