array_randLiefert einen oder mehrere zufällige Schlüssel eines Arrays
&reftitle.description;
intstringarrayarray_randarrayarrayintnum1
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.
&caution.cryptographically-insecure;
&reftitle.parameters;
array
Das Eingabe-Array; darf nicht leer sein
num
Gibt an, wie viele Einträge ausgewählt werden sollen; muss größer als
Null und kleiner oder gleich der Länge von array
sein
&reftitle.returnvalues;
Wenn nur ein Eintrag ausgewählt wird, gibt array_rand
den Schlüssel eines zufälligen Eintrages zurück. 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. Wenn mehrere Schlüssel zurückgegeben werden, werden sie in
der Reihenfolge zurückgegeben, in der sie im ursprünglichen Array
vorliegen.
&reftitle.errors;
Wenn array leer ist oder num
außerhalb des zulässigen Bereichs liegt, wird ein
ValueError geworfen.
&reftitle.changelog;
&Version;&Description;8.0.0
Wenn num außerhalb des zulässigen Bereichs
liegt, wirft array_rand nun einen
ValueError; zuvor wurde ein
E_WARNING ausgegeben, und die Funktion gab &null;
zurück.
8.0.0
Wenn array leer ist, wirft
array_rand nun einen
ValueError; zuvor wurde ein
E_WARNING ausgegeben, und die Funktion gab &null;
zurück.
7.1.0
Zur Erzeugung der Zufallszahlen
kommt intern nun
der
Mersenne-Primzahlen-Zufallsgenerator
statt der vorherigen libc-rand-Funktion zum Einsatz.
&reftitle.examples;
array_rand-Beispiel
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeysRandom\Randomizer::shuffleArray