strstr

(PHP 4, PHP 5, PHP 7)

strstrНаходит первое вхождение подстроки

Описание

strstr ( string $haystack , mixed $needle [, bool $before_needle = FALSE ] ) : string

Возвращает подстроку строки haystack, начиная с первого вхождения needle (и включая его) и до конца строки haystack.

Замечание:

Эта функция учитывает регистр символов. Для поиска без учета регистра используйте stristr().

Замечание:

Если нужно лишь определить, встречается ли подстрока needle в haystack, используйте более быструю и менее ресурсоемкую функцию strpos().

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

haystack

Входная строка.

needle

Если параметр needle не является строкой, он преобразуется в целое число и трактуется как код символа. Это поведение устарело с PHP 7.3.0, и полагаться на него крайне не рекомендуется. В зависимости от предполагаемого поведения, параметр needle должен быть либо явно приведен к строке, либо должен быть выполнен явный вызов chr().

before_needle

Если установлен в TRUE, strstr() возвращает часть строки haystack до первого вхождения needle (исключая needle).

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

Возвращает часть строки или FALSE, если needle не найдена.

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

Версия Описание
5.3.0 Добавлен необязательный параметр before_needle.

Примеры

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

<?php
$email  
'name@example.com';
$domain strstr($email'@');
echo 
$domain// выводит @example.com

$user strstr($email'@'true); // Начиная с PHP 5.3.0
echo $user// выводит name
?>

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

  • stristr() - Регистронезависимый вариант функции strstr
  • strrchr() - Находит последнее вхождение символа в строке
  • strpos() - Возвращает позицию первого вхождения подстроки
  • strpbrk() - Ищет в строке любой символ из заданного набора
  • preg_match() - Выполняет проверку на соответствие регулярному выражению