Devuelve una permutación de un array

# Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

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

### Descripción

public function 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

- Cualquier Throwable lanzado por el método Random\Engine::generate() del `Random\Randomizer::$engine` subyacente.

### 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: 🍑, 🍇, 🥝, 🍎, 🍌

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open