shuffle
(PHP 4, PHP 5, PHP 7, PHP 8)
shuffle — Mischt die Elemente eines Arrays
Beschreibung
&$array
): boolDiese Funktion mischt die Elemente eines Arrays zufällig (shuffle). Der verwendete Pseudo-Zufallszahlengenerator ist nicht für kryptografische Zwecke geeignet.
Parameter-Liste
-
array
-
Das zu modifizierende Array.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Changelog
Version | Beschreibung |
---|---|
7.1.0 | Der interne Algorithmus zur Erzeugung von Zufallszahlen wurde geändert, sodass statt der libc-rand-Funktion nun der » Mersenne-Twister-Zufallszahlengenerator zum Einsatz kommt. |
Beispiele
Beispiel #1 shuffle()-Beispiel
<?php
$numbers = range(1, 20);
shuffle($numbers);
foreach ($numbers as $number) {
echo "$number ";
}
?>
Anmerkungen
Hinweis: Diese Funktion weist den Elementen des Arrays
array
neue Schlüssel zu. Bestehende Schlüssel, die bereits zugewiesen wurden, werden entfernt statt einfach nur die Schlüssel neu anzuordnen
Siehe auch
- array_rand() - Liefert einen oder mehrere zufällige Schlüssel eines Arrays
- Den Vergleich von Arraysortierungsfunktionen