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