# Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

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

### Description

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

Renvoie une permutation uniformément sélectionnée 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 "Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
// Mélanger à nouveau:
echo "Another Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>`

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

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