array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.str-word-count.php', 1 => 'str_word_count', 2 => 'Retorna informação sobre palavras usadas em uma string', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.str-starts-with.php', 1 => 'str_starts_with', ), 'next' => array ( 0 => 'function.strcasecmp.php', 1 => 'strcasecmp', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/str-word-count.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 "'" e "-". 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

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