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ão	Descrição
8.0.0	`characters` agora pode ser nulo.

Exemplos

Example #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

explode() - Divide uma string com base em outra string
preg_split() - Divide uma string com base em expressão regular
count_chars() - Retorna informação sobre caracteres usados em uma string
substr_count() - Conta o número de ocorrências de uma substring