(PHP 4, PHP 5, PHP 7)
array_rand — Liefert einen oder mehrere zufällige Einträge eines Arrays
Wählt einen oder mehrere Einträge aus einem Array aus und gibt den Schlüssel des zufälligen Eintrags bzw. die Schlüssel der zufälligen Einträge zurück.
array
Das Eingabe-Array.
num
Gibt an, wie viele Einträge ausgewählt werden sollen. Falls mehr
Einträge als im Array existieren angegeben werden, wird ein
Fehler der Stufe E_WARNING
erzeugt.
Wenn nur ein Eintrag ausgewählt wird, liefert
array_rand() den Schlüssel eines zufälligen
Eintrages. Andernfalls wird ein Array mit den Schlüsseln der
zufälligen Einträge zurückgegeben. Dies hat den Zweck, dass
zufällige Schlüssel und auch Werte aus dem Array ausgewählt
werden können. Der Versuch mehr Elemente auszuwählen als im Array vorhanden sind,
ergibt einen Fehler der Stufe E_WARNING
,
und NULL wird zurückgegeben.
Version | Beschreibung |
---|---|
5.2.10 | Das Ergebnisarray wird nicht mehr gemischt. |
Beispiel #1 array_rand()-Beispiel
<?php
$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($input, 2);
echo $input[$rand_keys[0]] . "\n";
echo $input[$rand_keys[1]] . "\n";
?>