str_contains

(PHP 8)

str_containsОпределяет, содержит ли строка подстроку

Описание

str_contains(string $haystack, string $needle): bool

Функция выполняет регистрозависимую проверку, которая указывает, содержится ли подстрока needle в строке haystack.

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

haystack

Строка, в которой требуется найти подстроку.

needle

Подстрока для поиска в строке haystack.

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

Функция возвращает true, если подстрока needle содержится в строке haystack, иначе возвращает false.

Примеры

Пример #1 Пример поиска в строке пустой подстроки ''

<?php

if (str_contains('абв', '')) {
echo
"Функция возвращает true, поскольку каждая PHP-строка содержит пустую подстроку";
}

?>

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

Функция возвращает true, поскольку каждая PHP-строка содержит пустую подстроку

Пример #2 Демонстрация чувствительности к регистру

<?php

$string
= 'Ленивая лиса перепрыгнула через забор';

if (
str_contains($string, 'лиса')) {
echo
"Функция нашла в строке подстроку 'лиса'\n";
}

if (
str_contains($string, 'Лиса')) {
echo
'Функция нашла в строке подстроку "Лиса"';
} else {
echo
'Функция не нашла в строке подстроку "Лиса", потому что регистр не совпадает';
}

?>

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

Функция нашла в строке подстроку 'лиса'
Функция не нашла в строке подстроку "Лиса", потому что регистр не совпадает

Примечания

Замечание: Функция безопасна для обработки данных в двоичной форме.

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

  • str_ends_with() - Проверяет, заканчивается ли строка подстрокой
  • str_starts_with() - Проверяет, начинается ли строка с подстроки
  • stripos() - Возвращает позицию первого вхождения подстроки без учёта регистра
  • strrpos() - Возвращает позицию последнего вхождения подстроки в строке
  • strripos() - Возвращает позицию последнего вхождения подстроки без учёта регистра
  • strstr() - Находит первое вхождение подстроки
  • strpbrk() - Ищет в строке любой символ из набора
  • substr() - Возвращает подстроку
  • preg_match() - Выполняет проверку на соответствие регулярному выражению