strpos

(PHP 4, PHP 5, PHP 7)

strpos — Возвращает позицию первого вхождения подстроки

Описание

strpos ( string $haystack , string $needle , int $offset = 0 ) : int|false

Ищет позицию первого вхождения подстроки needle в строку haystack.

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

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

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

Возвращает позицию, в которой находится искомая строка, относительно начала строки haystack (независимо от смещения (offset)). Также обратите внимание на то, что позиция строки отсчитывается от 0, а не от 1.

Возвращает false, если искомая строка не найдена.

Внимание

Эта функция может возвращать как логическое значение false, так и значение не типа boolean, которое приводится к false. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

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

Версия	Описание
8.0.0	Передача целого числа (int) в `needle` больше не поддерживается.
7.3.0	Передача целого числа (int) в `needle` объявлена устаревшей.
7.1.0	Добавлена поддержка отрицательных значений `offset`.

Примеры

Пример #1 Использование ===


<?php
$mystring = 'abc';
$findme   = 'a';
$pos = strpos($mystring, $findme);

// Заметьте, что используется ===.  Использование == не даст верного 
// результата, так как 'a' находится в нулевой позиции.
if ($pos === false) {
    echo "Строка '$findme' не найдена в строке '$mystring'";
} else {
    echo "Строка '$findme' найдена в строке '$mystring'";
    echo " в позиции $pos";
}
?>

Пример #2 Использование !==


<?php
$mystring = 'abc';
$findme   = 'a';
$pos = strpos($mystring, $findme);

// Оператор !== также можно использовать.  Использование != не даст верного
// результата, так как 'a' находится в нулевой позиции. Выражение (0 != false) приводится
// к false.
if ($pos !== false) {
     echo "Строка '$findme' найдена в строке '$mystring'";
         echo " в позиции $pos";
} else {
     echo "Строка '$findme' не найдена в строке '$mystring'";
}
?>

Пример #3 Использование смещения


<?php
// Можно искать символ, игнорируя символы до определенного смещения
$newstring = 'abcdef abcdef';
$pos = strpos($newstring, 'a', 1); // $pos = 7, не 0
?>

Примечания

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

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

stripos() - Возвращает позицию первого вхождения подстроки без учета регистра
str_contains() - Determine if a string contains a given substring
str_ends_with() - Checks if a string ends with a given substring
str_starts_with() - Checks if a string starts with a given substring
strrpos() - Возвращает позицию последнего вхождения подстроки в строке
strripos() - Возвращает позицию последнего вхождения подстроки без учета регистра
strstr() - Находит первое вхождение подстроки
strpbrk() - Ищет в строке любой символ из заданного набора
substr() - Возвращает подстроку
preg_match() - Выполняет проверку на соответствие регулярному выражению