array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.stripos.php', 1 => 'stripos', 2 => 'Возвращает позицию первого вхождения подстроки без учёта регистра', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.stripcslashes.php', 1 => 'stripcslashes', ), 'next' => array ( 0 => 'function.stripslashes.php', 1 => 'stripslashes', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/stripos.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 независимо от смещения. Обратите также внимание, что позиция строки отсчитывается с 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;
}

// Обратите внимание на строгое сравнение оператором !==. Оператор != при сравнении
// логического false с нулем — позиция символа 'a' — вернёт ложь
if ($pos2 !== false) {
echo "Функция нашла подстроку '$findme' в строке '$mystring2' на позиции $pos2", PHP_EOL;
}

?>

Примечания

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

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