shuffle

(PHP 4, PHP 5, PHP 7)

shuffleMischt die Elemente eines Arrays

Beschreibung

shuffle ( array &$array ) : bool

Diese Funktion mischt die Reihenfolge der 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. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version Beschreibung
7.1.0 Zur Erzeugung der Zufallszahlen kommt intern nun der » Mersenne-Primzahlen-Zufallsgenerator statt der vorherigen libc-rand-Funktion zum Einsatz.

Beispiele

Beispiel #1 shuffle()-Beispiel

<?php
$numbers 
range(120);
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 Sie eventuell zugewiesen haben, werden entfernt statt einfach nur die Schlüssel neu anzuordnen

Siehe auch