str_word_count

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

    str_word_count — Retorna informação sobre palavras usadas em uma string

    Descrição

    str_word_count(string$string, int$format = 0, ?string$characters = null): array|int

    Conta o número de palavras dentro de string. Se o parâmetro opcional format não for especificado, então o valor de retorno será um inteiro representando o número de palavras encontradas. Caso format seja especificado, o valor de retorno será um array, cujo conteúdo é dependente de format. Os valores possíveis para format e as saídas resultantes estão listadas abaixo.

    Para o propósito desta função, 'palavra' é definida como uma string dependente da localidade contendo caracteres alfabéticos, que também podem conter, mas não iniciar com os caracteres "'" and "-". Note que localidades que utilizam caracteres multibyte não são suportadas.

    Parâmetros

    string

    A string

    format

    Especifica o valor de retorno desta função. Os valores atualmente suportados são:

    • 0 - retorna o número de palavras encontradas
    • 1 - retorna um array contendo todas as palavras encontradas dentro da string
    • 2 - retorna um array associativo, onde a chave é a posição numérica da palavra dentro da string e o valor é a própria palavra
    characters

    Uma lista de caracteres adicionais que serão considerados como 'palavra'.

    Valor Retornado

    Retorna um array ou um inteiro, dependendo do parâmetro format.

    Registro de Alterações

    VersãoDescrição
    8.0.0characters agora pode ser nulo.

    Exemplos

    Exemplo #1 Um exemplo de str_word_count()

    <?php

    $str     = "Hello fri3nd, you're
    looking good today!"    ;

    print_r(str_word_count($str, 1));
    print_r(str_word_count($str, 2));
    print_r(str_word_count($str, 1, 'àáãç3'));

    echo     str_word_count($str);

    ?>

    O exemplo acima produzirá:

    Array ( [0] => Hello [1] => fri [2] => nd [3] => you're [4] => looking [5] => good [6] => today ) Array ( [0] => Hello [6] => fri [10] => nd [14] => you're [29] => looking [46] => good [51] => today ) Array ( [0] => Hello [1] => fri3nd [2] => you're [3] => looking [4] => good [5] => today ) 7

    Veja Também

    To Top