Get a permutation of an array

# Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — Get a permutation of an array

### Beschreibung

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

Returns a uniformly selected permutation of the input `array`.

Each possible permutation of the input `array` is equally likely to be returned.

### Parameter-Liste

`array`

  The Array whose values are shuffled.

  The input Array will not be modified.

### Rückgabewerte

A permutation of the values of `array`.

Array keys of the input `array` will not be preserved; the returned Array will be a list (array_is_list()).

### Fehler/Exceptions

- Alle Throwables, die von der Methode Random\Engine::generate() der zugrundeliegenden `Random\Randomizer::$engine` ausgelöst werden.

### Beispiele

Beispiel #1 Random\Randomizer::shuffleArray() example

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

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

    // Shuffle array:
    echo "Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";

    // Shuffle again:
    echo "Another Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
    ?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Salad: 🍎, 🥝, 🍇, 🍌, 🍑
    Another Salad: 🍑, 🍇, 🥝, 🍎, 🍌

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