stripos

(PHP 5, PHP 7, PHP 8)

striposВозвращает позицию первого вхождения подстроки без учёта регистра

Описание

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

Функция ищет в строке 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;
}

?>

Примечания

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

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

  • mb_stripos() - Находит позицию первого вхождения подстроки в строку без учёта регистра
  • str_contains() - Определяет, содержит ли строка подстроку
  • str_ends_with() - Проверяет, заканчивается ли строка подстрокой
  • str_starts_with() - Проверяет, начинается ли строка с подстроки
  • strpos() - Находит позицию первого вхождения подстроки
  • strrpos() - Возвращает позицию последнего вхождения подстроки в строку
  • strripos() - Возвращает позицию последнего вхождения подстроки без учёта регистра
  • stristr() - Регистронезависимый вариант функции strstr
  • substr() - Возвращает подстроку
  • str_ireplace() - Регистронезависимый вариант функции str_replace