Возвращает число вхождений подстроки


(PHP 4, PHP 5)

substr_countВозвращает число вхождений подстроки

Описание

int substr_count ( string $haystack , string $needle [, int $offset = 0 [, int $length ]] )

substr_count() возвращает число вхождений подстроки needle в строку haystack. Заметьте, что параметр needle чувствителен к регистру.

Замечание:

Эта функция не подсчитывает перекрывающиеся подстроки. Смотрите пример ниже!

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

haystack

Строка, в которой ведется поиск

needle

Искомая подстрока

offset

Смещение начала отсчета

length

Максимальная длина строки в которой будет производится поиск подстроки после указанного смещения. Если сумма смещения и максимальной длины будет больше длины haystack, то будет выведено предупреждение.

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

Эта функция возвращает integer.

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

Версия Описание
5.1.0 Добавлены параметры offset и length

Примеры

Пример #1 Пример использования substr_count()

<?php
$text 
'This is a test';
echo 
strlen($text); // 14

echo substr_count($text'is'); // 2

// строка уменьшается до 's is a test', поэтому вывод будет 1
echo substr_count($text'is'3);

// текст уменьшается до 's i', поэтому вывод будет 0
echo substr_count($text'is'33);

// генерирует предупреждение, так как  5+10 > 14
echo substr_count($text'is'510);


// выводит только 1, т.к. перекрывающиеся подстроки не учитываются
$text2 'gcdgcdgcd';
echo 
substr_count($text2'gcdgcd');
?>

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

  • count_chars() - Возвращает информацию о символах, входящих в строку
  • strpos() - Возвращает позицию первого вхождения подстроки
  • substr() - Возвращает подстроку
  • strstr() - Находит первое вхождение подстроки