array_rand

(PHP 4, PHP 5, PHP 7, PHP 8)

array_randSeleccionar una o más claves aleatorias de un array

Descripción

array_rand(array $array, int $num = 1): mixed

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.

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
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.

Ejemplos

Ejemplo #1 Ejemplo de array_rand()

<?php
$entrada 
= array("Neo""Morpheus""Trinity""Cypher""Tank");
$claves_aleatorias array_rand($entrada2);
echo 
$entrada[$claves_aleatorias[0]] . "\n";
echo 
$entrada[$claves_aleatorias[1]] . "\n";
?>

Ver también