array_rand
(PHP 4, PHP 5)
array_rand — Seleccionar una o más entradas aleatorias de un array
Descripción
Selecciona uno o más valores aleatorios de un array y devuelve la clave (o claves) de dichos valores aleatorios.
Parámetros
-
array -
El array de entrada.
-
num -
Especifica cuántas entradas deberían seleccionarse.
Valores devueltos
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 .
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.2.10 | El array de claves resultante ya no se mezcla. |
| 4.2.0 | El generador de números aleatorio es sembrado automáticamente. |
Ejemplos
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";
?>