[函数]str_word_count()函数—用法及示例

函数名称: str_word_count()

适用版本: PHP 4, PHP 5, PHP 7

函数描述: str_word_count() 函数计算字符串中的单词数。

用法: str_word_count(string $string, int $format = 0, string|null $charlist = null): mixed

参数:

• $string (必需): 要计算单词数的字符串。
• $format (可选): 指定返回值的格式。可选值为 0（默认）表示返回单词数，1 表示返回单词数组，2 表示返回位置数组。
• $charlist (可选): 指定要从字符串中排除的字符列表。默认值为 null，表示不排除任何字符。

返回值:

• 当 $format 参数为 0 时，返回字符串中的单词数。
• 当 $format 参数为 1 时，返回一个包含字符串中所有单词的数组。
• 当 $format 参数为 2 时，返回一个包含字符串中所有单词的位置数组。

示例:

// 示例1: 返回字符串中的单词数
$string = "Hello world! This is a sample string.";
$wordCount = str_word_count($string);
echo $wordCount; // 输出: 7

// 示例2: 返回一个包含字符串中所有单词的数组
$string = "Hello world! This is a sample string.";
$wordArray = str_word_count($string, 1);
print_r($wordArray);
// 输出:
// Array
// (
//     [0] => Hello
//     [1] => world
//     [2] => This
//     [3] => is
//     [4] => a
//     [5] => sample
//     [6] => string
// )

// 示例3: 返回一个包含字符串中所有单词的位置数组
$string = "Hello world! This is a sample string.";
$positionArray = str_word_count($string, 2);
print_r($positionArray);
// 输出:
// Array
// (
//     [0] => 0
//     [6] => 6
//     [12] => 12
//     [16] => 16
//     [19] => 19
//     [21] => 21
//     [28] => 28
// )

注意事项:

• 默认情况下，str_word_count() 函数使用空格字符作为单词的分隔符，可以通过 $charlist 参数指定要排除的字符。
• $charlist 参数中的字符将被视为单词分隔符，不会包含在返回的单词中。
• 字符串中的标点符号和特殊字符会被视为单词的一部分。