str_word_count

    (PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

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

    Описание

    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.0characters теперь допускает значение 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() - Возвращает число вхождений подстроки
    To Top