str_word_count

(PHP 4 >= 4.3.0, PHP 5)

str_word_count — Devuelve información sobre las palabras utilizadas en un string

Descripción

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

Cuenta el número de palabras dentro de string. Si no se especifica el format opcional, entonces el valor devuelto será un integer representando el número de palabras encontradas. En el caso en que se especifique format, el valor devuelto será un array cuyo contenido depende de format. Los posibles valores para format y las salidas resultantes están listadas más abajo.

Para los propósitos de esta función, 'palabra' se define como un string dependiente de la configuración regional que contiene caracteres alfabéticos, el cual también puede contener, pero no iniciar con los caracteres "'" y "-".

Parámetros

string

El string

format

Especifica el valor devuelto de esta función. Los valores soportados actualmente son:

  • 0 - devuelve el número de palabras encontradas
  • 1 - devuelve un array que contiene todas las palabras encontradas dentro del string
  • 2 - devuelve un array asociativo, donde la clave es la posición numérica de una palabra dentro del string y el valor es la palabra en sí.

charlist

Una lista de caracteres adicionales los cuales serán considerados como de 'palabra'.

Valores devueltos

Devuelve un array o un integer, dependiendo del format seleccionado.

Historial de cambios

Versión Descripción
5.1.0 Agregado el parámetro charlist

Ejemplos

Ejemplo #1 Ejemplo 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);

?>

El resultado del ejemplo sería:

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

Ver también

  • explode() - Divide un string en varios string
  • preg_split() - Divide un string mediante una expresión regular
  • split() - Divide una cadena en una matriz mediante una expresión regular
  • count_chars() - Devuelve información sobre los caracteres usados en una cadena
  • substr_count() - Cuenta el número de apariciones del substring