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

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