Obtém uma permutação de um array

# Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — Obtém uma permutação de um array

### Descrição

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

Retorna uma permutação selecionada uniformemente do `array` de entrada.

Cada permutação possível do `array` de entrada tem a mesma probabilidade de ser retornada.

### Parâmetros

`array`

  O array cujos valores são embaralhados.

  O array de entrada não será modificado.

### Valor Retornado

Uma permutação dos valores de `array`.

As chaves do `array` de entrada não serão preservadas; o array retornado será uma lista (array_is_list()).

### Erros/Exceções

- Qualquer erro ou exceção Throwable lançados pelo método Random\Engine::generate() do mecanismo `Random\Randomizer::$engine` subjacente.

### Exemplos

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

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

    $frutas = [ 'vermelho' => '🍎', 'verde' => '🥝', 'amarelo' => '🍌', 'rosa' => '🍑', 'roxo' => '🍇' ];

    // Embaralha o array:
    echo "Salada: ", implode(', ', $r->shuffleArray($frutas)), "\n";

    // Embaralha novamente:
    echo "Outra salada: ", implode(', ', $r->shuffleArray($frutas)), "\n";
    ?>

O exemplo acima produzirá algo semelhante a:

    Salada: 🍎, 🥝, 🍇, 🍌, 🍑
    Outra salada: 🍑, 🍇, 🥝, 🍎, 🍌

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