shuffle

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

shuffleMezcla los elementos de un array

Descripción

shuffle(array &$array): true

Mezcla los elementos del array array.

Precaución

Esta función no genera valores criptográficamente seguros y no debe ser utilizada para fines criptográficos o fines que requieran que los valores devueltos sean impredecibles.

Si se requiere aleatoriedad criptográficamente segura, se puede utilizar el Random\Randomizer con el motor Random\Engine\Secure. Para casos de uso simples, las funciones random_int() y random_bytes() proporcionan una API conveniente y segura respaldada por el CSPRNG del sistema operativo.

Parámetros

array

El array.

Valores devueltos

Siempre devuelve true.

Historial de cambios

Versión Descripción
7.1.0 El algoritmo interno de generación aleatoria ha sido modificado para utilizar el generador de números aleatorios »  Mersenne Twister en lugar de la función libc rand.

Ejemplos

Ejemplo #1 Ejemplo con shuffle()

<?php
$numbers
= range(1, 20);
shuffle($numbers);
foreach (
$numbers as $number) {
echo
"$number ";
}
?>

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.

Nota:

Reinicia el puntero interno del array al primer elemento.

Ver también