array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'random-randomizer.shufflearray.php', 1 => 'Random\\Randomizer::shuffleArray', 2 => 'Devuelve una permutación de un array', ), 'up' => array ( 0 => 'class.random-randomizer.php', 1 => 'Random\\Randomizer', ), 'prev' => array ( 0 => 'random-randomizer.serialize.php', 1 => 'Random\\Randomizer::__serialize', ), 'next' => array ( 0 => 'random-randomizer.shufflebytes.php', 1 => 'Random\\Randomizer::shuffleBytes', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/random/random/randomizer/shufflearray.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — Devuelve una permutación de un array

Descripción

public Random\Randomizer::shuffleArray(array $array): array

Devuelve una permutación seleccionada uniformemente del array de entrada.

Cada permutación posible del array de entrada tiene la misma probabilidad de ser devuelta.

Parámetros

array

El array cuyos valores se mezclan.

El array de entrada no será modificado.

Valores devueltos

Una permutación de los valores de array.

Las claves del array de entrada no serán preservadas; el array devuelto será una lista (array_is_list()).

Errores/Excepciones

Ejemplos

Ejemplo #1 Ejemplo de Random\Randomizer::shuffleArray()

<?php
$r = new \Random\Randomizer();

$fruits = [ 'red' => '🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ];

// Mezclar el array:
echo "Ensalada: ", implode(', ', $r->shuffleArray($fruits)), "\n";

// Mezclar nuevamente:
echo "Otra Ensalada: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>

Resultado del ejemplo anterior es similar a:

Ensalada: 🍎, 🥝, 🍇, 🍌, 🍑
Otra Ensalada: 🍑, 🍇, 🥝, 🍎, 🍌