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

strripos

(PHP 5, PHP 7, PHP 8)

strripos — Ищет в строке позицию последнего вхождения подстроки, без учёта регистра

Описание

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

Функция ищет в строке haystack позицию последнего вхождения подстроки needle.

Функция strripos() не учитывает регистр символов, в отличие от функции strrpos().

Список параметров

haystack

Строка, в которой выполняется поиск.

needle

Строка, которую требуется найти.

До PHP 8.0.0 нестроковый аргумент needle преобразовывался в целое число и заменялся на символ с этим порядковым значением в однобайтовой таблице символов. Начиная с PHP 7.3.0 передача нестроковых значений устарела и полагаться на него настоятельно не рекомендуют. Перед вызовом функции нестроковый аргумент needle требовалось либо приводить к строке, либо получать строковое значение символа функцией chr().

offset

При передаче нуля или положительного значения функция пропускает с начала строки haystack байты, количество которых указали в параметре offset, и начинает поиск слева направо.

При отрицательных значениях функция пропускает с конца строки haystack байты, количество которых указали в параметре offset, и начинает поиск первого вхождения подстроки needle при движении справа налево.

Замечание:

Функция ищет последнее вхождение подстроки needle, если представить поиск как движение с начала строки до точки перед смещением с конца строки в байтах, количество которых указали в параметре offset.

Возвращаемые значения

Функция возвращает числовую позицию последнего вхождения подстроки needle относительно начала строки haystack независимо от направления поиска и значения параметра offset.

Замечание: Позици строки начинаются с 0, а не с 1.

Функция возвращет значение false, если строка не содержит подстроку needle.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Список изменений

Версия Описание
8.2.0 Приведение к единому регистру больше не зависит от региональных настроек, которые установили функцией setlocale(). Преобразовываются только символы кодировки ASCII. Байты, которые не относятся к кодировке ASCII, сравнятся по значению байта.
8.0.0 Параметр needle теперь разрешает пустую строку.
8.0.0 Функция перестала поддерживать передачу целого числа (int) в параметр needle.
7.3.0 Передача целого числа (int) в needle устарела.

Примеры

Пример #1 Пример поиска позиции последнего вхождения подстроки функцией strripos()

<?php

$haystack = 'ababcd';
$needle = 'aB';

$pos = strripos($haystack, $needle);

if ($pos === false) {
echo "Функция не нашла в строке `$haystack` подстроку `$needle`";
} else {
echo "Поздравляем!\n";
echo "Функция нашла в строке `$haystack` подстроку `$needle` на позиции `$pos`";
}

?>

Результат выполнения приведённого примера: 

Поздравляем!
Функция нашла в строке `ababcd` подстроку `aB` на позиции `2`

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