shuffle

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

shuffleMezcla un array

Descripción

shuffle(array &$array): bool

Esta función mezcla un array (crea un orden aleatorio de sus elementos). Utiliza un generador de números seudoaleatorios que no es apto para fines criptográficos.

Nota:

Si dos miembros se comparan como iguales, ellos mantendrán su orden original. Antes de PHP 8.0.0, su orden relativo en un array ordenado era indefinido.

Parámetros

array

El array.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de shuffle()

<?php
$números
= range(1, 20);
shuffle($números);
foreach (
$números as $número) {
echo
"$número ";
}
?>

Notas

Nota: Esta función asigna nuevas clave a los elementos del array. Eliminará cualquier clave existente que haya sido asignada, en lugar de reordenar las claves.

Ver también