Renvoie une permutation d'un tableau

# Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — Renvoie une permutation d'un tableau

### Description

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

Renvoie une permutation uniformément sélectionnée de l'`array` d'entrée.

Chaque permutation possible de l'`array` d'entrée est également probable d'être retournée.

### Liste de paramètres

`array`

  Le tableau dont les valeurs sont mélangées.

  Le tableau d'entrée ne sera pas modifié.

### Valeurs de retour

Une permutation des valeurs de `array`.

Les clés de l'`array` d'entrée ne seront pas préservées; le tableau retourné sera une liste (array_is_list()).

### Erreurs / Exceptions

- Tout Throwables lancé par la méthode Random\Engine::generate() du `Random\Randomizer::$engine` sous-jacent.

### Exemples

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

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

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

    // Mélanger le tableau :
    echo "Salade : ", implode(', ', $r->shuffleArray($fruits)), "\n";

    // Mélanger à nouveau:
    echo "Autre salade : ", implode(', ', $r->shuffleArray($fruits)), "\n";
    ?>

Résultat de l'exemple ci-dessus est similaire à :

    Salade : 🍎, 🥝, 🍇, 🍌, 🍑
    Autre salade : 🍑, 🍇, 🥝, 🍎, 🍌

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