(PHP 4, PHP 5, PHP 7, PHP 8)
array_rand — Seleccionar una o más claves aleatorias de un array
Selecciona uno o más valores aleatorios de un array y devuelve la clave (o claves) de dichos valores aleatorios. Utiliza un generador de números seudoaleatorios que no es apto para fines criptográficos.
array
El array de entrada.
num
Especifica cuántas entradas deberían seleccionarse.
Al seleccionar solamente una entrada, array_rand() devolverá la clave para una entrada aleatoria. De lo contrario, devolverá un array con las claves de las entradas aleatorias. Esto se realiza de tal manera que se pueden seleccionar del array tanto claves como valores aleatorios. Intentar seleccionar más elementos de los que hay en el array resultará en un error de nivel E_WARNING
, devolviendo NULL .
Versión | Descripción |
---|---|
7.1.0 | El algoritmo de aleatorización interno se ha cambiado para usar el generador de números aleatorios » Mersenne Twister en lugar de la función libc rand. |
5.2.10 | El array de claves resultante ya no se mezcla. |
Ejemplo #1 Ejemplo de array_rand()
<?php
$entrada = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$claves_aleatorias = array_rand($entrada, 2);
echo $entrada[$claves_aleatorias[0]] . "\n";
echo $entrada[$claves_aleatorias[1]] . "\n";
?>