array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.shuffle.php', 1 => 'shuffle', 2 => 'Mezcla los elementos de un array', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funciones de Arrays', ), 'prev' => array ( 0 => 'function.rsort.php', 1 => 'rsort', ), 'next' => array ( 0 => 'function.sizeof.php', 1 => 'sizeof', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/array/functions/shuffle.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

shuffle

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

shuffle — Mezcla 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 con fines criptográficos, o con fines que requieran que los valores devueltos sean indescifrables.

Si se requiere aleatoriedad criptográficamente segura, el Random\Randomizer puede ser utilizado con el motor Random\Engine\Secure. Para casos de uso simples, las funciones random_int() y random_bytes() proporcionan una API práctica y segura que es soportada por el CSPRNG del sistema operativo.

Precaución

Esta función utiliza la instancia global Mt19937 ("Mersenne Twister") como fuente de aleatoriedad y por lo tanto comparte su estado con todas las demás funciones que usan el Mt19937 global. El uso de cualquiera de estas funciones avanza la secuencia para todas las demás funciones, independientemente del ámbito.

Generar secuencias repetibles sembrando mt_srand() o srand() con un valor conocido también producirá una salida repetible de esta función.

Preferir el uso de los métodos de Random\Randomizer en todo código nuevo.

Parámetros

array

El array.

Valores devueltos

Retorna siempre 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 claves a los elementos en array. Eliminará todas las claves existentes que hayan podido ser asignadas, en lugar de reordenar las claves.

Nota:

Reinicia el puntero interno del array al primer elemento.

Ver también