Manuel PHP
Précédent |  | Suivant

# str_word_count

(PHP 4 >= 4.3.0, PHP 5)

str_word_count -- Compte le nombre de mots utilisés dans une chaîne

## Description

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

str_word_count() compte le nombre de mots dans la chaîne `string`. Si le paramètre optionnel `format` n'est pas spécifié, alors la valeur retournée sera un entier, représentant le nombre de mots trouvés. Si `format` est spécifié, la valeur retournée sera un tableau, qui dépend du format `format`. Les valeurs possibles pour `format` sont listées plus bas.

Dans cette fonction, la notion de "mot" dépend de la configuration de localisation. C'est une chaîne qui contient tous les caractères alphabétiques, et qui peut contenir, mais pas commencer par "'" et "-".

## Liste de paramètres

`string`

  La chaîne de caractères

`format`

  Spécifie la valeur de retour de cette fonction. Les valeurs actuellement supportées sont :

  - 0 - retourne le nombre de mots trouvés

  - 1 - retourne un tableau contenant tous les mots trouvés à l'intérieur de `string`

  - 2 - retourne un tableau associatif, où la clé indique la position numérique du mot à l'intérieur de `string` et la valeur est le mot actuel

`charlist`

  Une liste des caractères additionnels qui seront considérés comme un 'mot'

## Valeurs de retour

Retourne un tableau ou un entier, dépendamment du `format` choisi.

## Historique

Version | Description
--- | ---
5.1.0 | Ajout du paramètre `charlist`

## Exemples

Exemple 1. Exemple avec str_word_count()

`<?php $str = "Salut l'ami, vous avez une b3lle mine !"; 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); ?>`

L'exemple ci-dessus va afficher :

    Array
    (
        [0] => Salut
        [1] => l'ami
        [2] => vous
        [3] => avez
        [4] => une
        [5] => b
        [6] => lle
        [7] => mine
    )

    Array
    (
        [0] => Salut
        [6] => l'ami
        [13] => vous
        [26] => avez
        [40] => une
        [44] => b
        [46] => lle
        [50] => mine
    )

    Array
    (
        [0] => Salut
        [1] => l'ami
        [2] => vous
        [3] => avez
        [4] => une
        [5] => belle
        [6] => mine
    )

    8

## Voir aussi

explode()
preg_split()
split()
count_chars()
substr_count()

Précédent | Sommaire | Suivant
str_split | Niveau supérieur | strcasecmp