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

# str_contains

(PHP 8)

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

### Описание

function 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() - Выполняет проверку на соответствие регулярному выражению

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open