str_word_count

(PHP 4 >= 4.3.0, PHP 5)

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

Descrição

mixed str_word_count ( string $string [, int $format [, string $charlist ]] )

Conta o número de palavras dentro de string. Se o format opcional não é especificado, então o valor de retorno será um inteiro representando o número de palavras encontrado. No caso de o format estar especificado, o valor de retorno será um array, cujo conteúdo é dependente do format. O valor possível para o format e as saídas resultantes são listadas abaixo.

Devido ao propósito desta função, 'word' é definida como uma string dependente da localidade contendo caracteres alfanuméricos, que também podem contr, mas não iniciar com os caracteres "'" and "-".

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 de 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.

charlist

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

Valor Retornado

Retorna um array ou um inteiro, dependendo do format escolhido.

Changelog

Versão Descrição
5.1.0 Adicionado o parâmetro charlist

Exemplos

Example #1 Um exemplo da 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 irá imprimir:

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
)

Veja Também

  • explode() - Divide uma string em strings
  • preg_split() - Divide a string por uma expressão regular
  • split() - Separa strings em array utilizando expressões regulares
  • count_chars() - Retorna informações sobre os caracteres usados numa string
  • substr_count() - Conta o número de ocorrências de uma substring