shuffle

    (PHP 4, PHP 5, PHP 7, PHP 8)

    shuffle — Embaralha um array

    Descrição

    shuffle(array&$array): true

    Essa função embaralha (mistura de forma aleatória os elementos de) um array.

    Cuidado

    Esta função não gera valores criptograficamente seguros e não deve ser usada para propósitos criptográficos ou fins que exijam que os valores retornados sejam impossíveis de adivinhar.

    Se aleatoriedade criptograficamente segura for necessária, a classe Random\Randomizer pode ser usada com o mecanismo Random\Engine\Secure. Para casos de uso simples, as funções random_int() e random_bytes() fornecem uma API conveniente e segura que é garantida pelo CSPRNG do sistema operacional.

    Parâmetros

    array

    O array.

    Valor Retornado

    Sempre retorna true.

    Registro de Alterações

    VersãoDescrição
    7.1.0 O algoritmo interno de randomização mudou para o Gerado de Números Aleatórios » Mersenne Twister no lugar da função rand do libc.

    Exemplos

    Exemplo #1 Exemplo de shuffle()

    <?php
    $numeros     = range(1,20);
    shuffle($numeros);
    foreach (    $numeros as $numero) {
    echo     "$numero ";
    }
    ?>

    Notas

    Nota: Esta função atribui novas chaves aos elementos do array. Ela removerá todas as chaves existentes que possam ter sido atribuídas, em vez de apenas reordenar as chaves.

    Nota:

    Redefine o ponteiro interno do array para o primeiro elemento.

    Veja Também

    To Top