str_shuffle

    (PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

    str_shuffle — Embaralha uma string aleatoriamente

    Descrição

    str_shuffle(string$string): string

    str_shuffle() embaralha uma string. Uma permutação de todas as possíveis é criada.

    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

    string

    A string de entrada.

    Valor Retornado

    Retorna a string embaralhada.

    Registro de Alterações

    VersãoDescrição
    7.1.0 O algoritmo interno de randomização mudou e agora usa o Gerador de Números Aleatórios » Mersenne Twister em vez da função rand da biblioteca libc.

    Exemplos

    Exemplo #1 Exemplo de str_shuffle()

    <?php
    $str     = 'abcdef';
    $shuffled = str_shuffle($str);

    // Isto exibirá algo como: bfdaec
    echo $shuffled;
    ?>

    Veja Também

    To Top