(PHP 5, PHP 7)
stripos — Возвращает позицию первого вхождения подстроки без учета регистра
Описание
mixed stripos ( string $haystack , string $needle [, int $offset = 0 ] )
Ищет позицию первого вхождения подстроки needle
в строку haystack
.
В отличие от strpos(), эта функция не учитывает регистр символов.
Список параметров
haystack
-
Строка, в которой производится поиск.
needle
-
Заметьте, что
needle
может содержать строку из одного или более символов.Если
needle
не является строкой, он приводится к целому и трактуется как код символа. offset
-
Если этот параметр указан, то поиск будет начат с указанного количества символов с начала строки. Если задано отрицательное значение, отсчет позиции начала поиска будет произведен с конца строки.
Возвращаемые значения
Возвращает позицию, в которой находится искомая строка, относительно начала строки haystack
(независимо от смещения (offset)). Также обратите внимание на то, что позиция строки отсчитывается от 0, а не от 1.
Возвращает FALSE
, если искомая строка не найдена.
Эта функция может возвращать как boolean FALSE
, так и не-boolean значение, которое приводится к FALSE
. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.
Список изменений
Версия | Описание |
---|---|
7.1.0 | Добавлена поддержка отрицательных значений offset . |
Примеры
Пример #1 Пример использования stripos()
<?php $findme = 'a'; $mystring1 = 'xyz'; $mystring2 = 'ABC'; $pos1 = stripos($mystring1, $findme); $pos2 = stripos($mystring2, $findme); // Конечно, 'a' не входит в 'xyz' if ($pos1 === false) { echo "Строка '$findme' не найдена в строке '$mystring1'"; } // Заметьте, что используется ===. Использование == не даст верного // результата, так как 'a' в нулевой позиции. if ($pos2 !== false) { echo "Нашел '$findme' в '$mystring2' в позиции $pos2"; } ?>
Примечания
Замечание: Эта функция безопасна для обработки данных в двоичной форме.