(PHP 5, PHP 7, PHP 8)
strripos — Ищет в строке позицию последнего вхождения подстроки, без учёта регистра
Функция ищет в строке 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`