Random\Randomizer::shuffleArray

    (PHP 8 >= 8.2.0)

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

    Descrição

    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.

    Parâmetros

    array

    The array whose values are shuffled.

    The input array will not be modified.

    Valor Retornado

    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()).

    Erros/Exceções

    Exemplos

    Exemplo #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";
    ?>

    O exemplo acima produzirá algo semelhante a:

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