Random\Randomizer::shuffleArray()

Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — Få en permutation av en array

Beskrivning

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

Returnerar en likformigt vald permutation av inmatningsarrayen.

Varje möjlig permutation av inmatningsarrayen är lika sannolik att bli returnerad.

Parametrar

array

Arrayen vars värden blandas.

Inmatningsarrayen kommer inte att modifieras.

Returvärden

En permutation av värdena i arrayen.

Arraynycklarna från inmatningsarrayen kommer inte att bevaras; den returnerade arrayen kommer att vara en lista (array_is_list()).

Fel/Undantag

Alla Throwables som kastas av Random\Engine::generate()-metoden för det underliggande Random\Randomizer::$engine.

Exempel

Exempel #1 Exempel på Random\Randomizer::shuffleArray()

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

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

// Blanda arrayen:
echo "Sallad: ", implode(', ', $r->shuffleArray($fruits)), "\n";

// Blanda igen:
echo "En annan sallad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>

Exemplet ovan kommer att visa något liknande:

Sallad: 🍎, 🥝, 🍇, 🍌, 🍑 En annan sallad: 🍑, 🍇, 🥝, 🍎, 🍌