stristr - Регистро-независимый вариант функции strstr
Вернуться к: Обработка строк
Описание
Возвращает всю строку haystack начиная с первого вхождения needle.
Список параметров
- haystack
-
Строка, в которой производится поиск
- needle
-
Если needle не является строкой, он приводится к целому и трактуется как код символа.
- before_needle
-
Если установлен в TRUE, stristr() возвращает часть строки haystack до первого вхождения needle.
needle и haystack обрабатываются без учета регистра.
Возвращаемые значения
Возвращает указанную подстроку. Если подстрока needle не найдена, возвращается FALSE.
Список изменений
| Версия | Описание |
|---|---|
| 5.3.0 | Добавлен необязательный параметр before_needle. |
| 4.3.0 | stristr() теперь бинарно-безопасна. |
Примеры
Пример #1 Пример использования stristr()
<?php
$email = 'USER@EXAMPLE.com';
echo stristr($email, 'e'); // выводит ER@EXAMPLE.com
echo stristr($email, 'e', true); // Начиная с PHP 5.3.0, выводит US
?>
Пример #2 Проверка на вхождение строки
<?php
$string = 'Hello World!';
if(stristr($string, 'earth') === FALSE) {
echo '"earth" не найдена в строке';
}
// выводит: "earth" не найдена в строке
?>
Пример #3 Использование "нестроки" в поиске
<?php
$string = 'APPLE';
echo stristr($string, 97); // 97 = a в нижнем регистре
// выводит: APPLE
?>
Примечания
Замечание: Эта функция безопасна для обработки данных в двоичной форме.
Смотрите также
- strstr() - Находит первое вхождение подстроки
- strrchr() - Находит последнее вхождение символа в строке
- stripos() - Возвращает позицию первого вхождения подстроки без учета регистра
- strpbrk() - Ищет в строке любой символ из заданного набора
- preg_match() - Выполняет проверку на соответствие регулярному выражению
Вернуться к: Обработка строк