array_randPrend une ou plusieurs clés, au hasard dans un tableau
&reftitle.description;
intstringarrayarray_randarrayarrayintnum1
Sélectionne une ou plusieurs valeurs au hasard dans un tableau
et retourne la ou les clés de ces valeurs.
&caution.cryptographically-insecure;
&caution.mt19937-global-state;
&reftitle.parameters;
array
Le tableau d'entrée.
Ne peut pas être vide.
num
Spécifie le nombre d'entrées que l'on veut récupérer.
Doit être supérieur à zéro et inférieur ou égal à la longueur de array.
&reftitle.returnvalues;
Lorsque l'on ne récupère qu'une seule entrée, la fonction
array_rand retourne la clé d'une entrée choisie
aléatoirement. Sinon, un tableau de clés d'entrées aléatoires sera
retourné. Cela permet de faire une sélection au hasard de clés,
ou bien de valeurs. Si plusieurs clés sont retournées, alors elles le
seront dans l'ordre qu'elles étaient dans le tableau d'origine.
&reftitle.errors;
Lance une ValueError si array est vide,
ou si num est hors de portée.
&reftitle.changelog;
&Version;&Description;8.0.0array_rand lance désormais une ValueError
si num est hors de portée ; précédemment, un
E_WARNING était généré et la fonction renvoyait &null;.
8.0.0array_rand lance désormais une ValueError
si array est vide ; précédemment, un
E_WARNING était généré et la fonction renvoyait &null;.
7.1.0
L'algorithme
interne de génération aléatoire a été modifié pour utiliser le
générateur aléatoire de nombre
Mersenne Twister au lieu de la fonction aléatoire libc
&reftitle.examples;
Exemple avec array_rand
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeysRandom\Randomizer::shuffleArray