Random\Randomizer::shuffleArray

    (PHP 8 >= 8.2.0)

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

    Beschreibung

    publicRandom\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

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