array_rand
(PHP 4, PHP 5, PHP 7)
array_rand — Liefert einen oder mehrere zufällige Schlüssel eines Arrays
Beschreibung
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. Es wird ein Pseudozufallszahlengenerator verwendet der nicht für kryptographische Zwecke geeignet ist.
Parameter-Liste
-
array -
Das Eingabe-Array.
-
num -
Gibt an, wie viele Einträge ausgewählt werden sollen.
Rückgabewerte
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.
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. |
| 5.2.10 | Das Ergebnisarray wird nicht mehr gemischt. |
Beispiele
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";
?>
add a note
