(PHP 5, PHP 7, PHP 8)
stripos — Возвращает позицию первого вхождения подстроки без учёта регистра
Функция ищет в строке haystack
позицию первого вхождения подстроки needle
.
В отличие от функции strpos(), эта функция не учитывает регистр символов.
haystack
Строка, в которой выполняется поиск.
needle
Строка, которую требуется найти.
До PHP 8.0.0 нестроковый аргумент needle
преобразовывался в целое число и заменялся на символ с этим порядковым значением в однобайтовой таблице символов.
Начиная с PHP 7.3.0 передача нестроковых значений устарела и полагаться на него настоятельно не рекомендуют.
Перед вызовом функции нестроковый аргумент needle
требовалось
либо приводить к строке, либо получать строковое значение символа функцией chr().
offset
При установке параметра поиск начинается с заданного количества символов с начала строки. При установке отрицательного значения отсчёт позиции начала поиска выполняется с конца строки.
Функция возвращает позицию, в которой находится искомая строка, относительно
начала строки haystack
независимо от смещения (offset).
Обратите также внимание, что позиция строки отсчитывается от 0, а не от 1.
Функция возвращает значение false
, если не находит подстроку.
Функция
возвращает как логическое значение false
,
так и нелогическое значение, которое приводится к false
.
Прочитайте раздел
«Логический тип»,
чтобы получить дополнительную информацию.
Используйте оператор ===
для проверки значения, которое возвращает функция.
Версия | Описание |
---|---|
8.2.0 | Приведение к единому регистру больше не зависит от региональных настроек, которые установили функцией setlocale(). Преобразовываются только символы кодировки ASCII. Байты, которые не относятся к кодировке ASCII, сравнятся по значению байта. |
8.0.0 |
Параметр needle теперь разрешает пустую строку.
|
8.0.0 |
Передача целого числа (int) в параметр needle больше не поддерживается.
|
7.3.0 |
Передача целого числа (int) в параметр needle устарела.
|
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'", PHP_EOL;
}
// Заметьте, что выполняется строгое сравнение оператором !==. Оператор != сработает
// не так, как ожидается, поскольку символ 'a' идёт первым и поэтому стоит в нулевой позиции
if ($pos2 !== false) {
echo "Функция нашла подстроку '$findme' в строке '$mystring2' на позиции $pos2", PHP_EOL;
}
?>
Замечание: Функция безопасна для обработки данных в двоичной форме.