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