array_randToma una o varias claves, al azar en un array
&reftitle.description;
intstringarrayarray_randarrayarrayintnum1
Selecciona uno o varios valores al azar en un array
y devuelve la o las claves de estos valores.
&caution.cryptographically-insecure;
&reftitle.parameters;
array
El array de entrada.
No puede estar vacío.
num
Especifica el número de entradas que se desean recuperar.
Debe ser mayor a cero e inferior o igual a la longitud de array.
&reftitle.returnvalues;
Cuando se recupera una sola entrada, la función
array_rand devuelve la clave de una entrada elegida
al azar. De lo contrario, se devolverá un array de claves de entradas aleatorias. Esto permite hacer una selección al azar de claves,
o bien de valores. Si se devuelven varias claves, entonces lo serán en el orden en que estaban en el array original.
&reftitle.errors;
Lanza una ValueError si array está vacío,
o si num está fuera de rango.
&reftitle.changelog;
&Version;&Description;8.0.0array_rand ahora lanza una ValueError
si num está fuera de rango; anteriormente, se generaba un
E_WARNING y la función devolvía &null;.
8.0.0array_rand ahora lanza una ValueError
si array está vacío; anteriormente, se generaba un
E_WARNING y la función devolvía &null;.
7.1.0
El algoritmo
interno de generación aleatoria ha sido modificado para usar el
generador de números aleatorios
Mersenne Twister en lugar de la función aleatoria libc
&reftitle.examples;
Ejemplo con array_rand
]]>
&reftitle.seealso;
Random\Randomizer::pickArrayKeysRandom\Randomizer::shuffleArray