Master PHP’s str_word_count: Count Words, Get Arrays, Customize Ignored Characters

In PHP, the str_word_count() function counts the number of words in a string. This article explains its syntax, parameters, and provides code examples.

Function Syntax

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

Parameter Description

$string

: required, the string to be analyzed. $format: optional, determines the return format (0, 1, or 2). Default is 0.

If $format is 0, the function returns the word count.

If $format is 1, it returns an array of words.

If $format is 2, it returns an associative array where keys are the positions of words and values are the words. $charlist: optional, a list of characters to ignore when counting words; defaults to whitespace, tabs, and line breaks.

Usage Examples

Example 1: Count words in a string

$string = "Hello, how are you today?";
$wordCount = str_word_count($string);
echo "Word count: " . $wordCount;

Output: Word count: 5

Example 2: Return each word as an array

$string = "Hello, how are you today?";
$wordsArray = str_word_count($string, 1);
echo "Word list: ";
foreach ($wordsArray as $word) {
    echo $word . " ";
}

Output: Word list: Hello how are you today

Example 3: Return positions and words

$string = "Hello, how are you today?";
$wordsArray = str_word_count($string, 2);
foreach ($wordsArray as $position => $word) {
    echo "Position" . $position . ":" . $word . " ";
}

Output: Position0:Hello Position6:how Position10:are Position14:you Position18:today

Example 4: Custom ignore character list

$string = "Hello, how are you today?";
$wordCount = str_word_count($string, 0, "o");
echo "Word count: " . $wordCount;

Output: Word count: 3

Example 5: Use regex to match words

$string = "Hello, how are you today?";
preg_match_all('/\w+/', $string, $matches);
echo "Word list: ";
foreach ($matches[0] as $word) {
    echo $word . " ";
}

Output: Word list: Hello how are you today

The str_word_count() function is a simple yet powerful tool for word counting and extraction in PHP, offering flexibility through its parameters and supporting various string-processing scenarios.