Возвращает информацию о словах, которые входят в строку

Описание

str_word_count(string $string, int $format = 0, ?string $characters = null): array|int

Функция подсчитывает количество слов, которые входят в строку string. Если необязательный аргумент format не передали, возвращается целое число, равное количеству слов. Если указали аргумент format, возвращается массив, содержимое которого зависит от значения параметра format. Возможные значения параметра format и результирующие выходные данные описание перечисляет ниже.

Для этой функции "слово" обозначает строку с алфавитными символами, которая зависит от региональных настроек, которая также может содержать символы "'" и "-", но не может начинаться с них. Обратите внимание, что многобайтовые локали не поддерживаются.

Список параметров

string

Строка.

format

Параметр указывает возвращаемое значение функции. Поддерживаются следующие значения:

0 — возвращает количество найденных слов
1 — возвращается массив, который содержит каждое слово, которое входит в строку string
2 — возвращается ассоциативный массив, ключи которого — позиция слова в строке string, а значения — само слово.

characters

Список дополнительных символов, которые будут рассматриваться как «слово».

Возвращаемые значения

Функция возвращает массив или целое число, в зависимости от параметра format.

Список изменений

Версия	Описание
8.0.0	Параметр `characters` теперь принимает значение null.

Примеры

Пример #1 Пример использования функции 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);

?>

Результат выполнения приведённого примера:

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

Смотрите также

explode() - Разбивает строку разделителем
preg_split() - Разбивает строку по регулярному выражению
count_chars() - Возвращает информацию о символах, которые входят в строку
substr_count() - Возвращает число вхождений подстроки