Опис

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

Find the numeric position of the last occurrence of needle in the haystack string.

Параметри

haystack

The string to search in.

needle

The string to search for.

До версії PHP 8.0.0, якщо параметр needle не є рядком, він перетворюється на ціле число і розглядається як код символу. Ця поведінка є застарілою, починаючи з PHP 7.3.0. Вкрай не рекомендується на неї покладатися. Залежно від потрібної поведінки, параметр needle необхідно привести до рядкового типу або обробити функцією chr().

offset

If zero or positive, the search is performed left to right skipping the first offset bytes of the haystack.

If negative, the search starts offset bytes from the right instead of from the beginning of haystack. The search is performed right to left, searching for the first occurrence of needle from the selected byte.

Зауваження:
This is effectively looking for the last occurrence of needle at or before the last offset bytes.

Значення, що повертаються

Returns the position where the needle exists relative to the beginning of the haystack string (independent of search direction or offset).

Зауваження: String positions start at 0, and not 1.

Returns false if the needle was not found.

Увага

Ця функція може повертати як логічне false, так і не логічне значення, яке прирівнюється до false. Докладніше про це описано в розділі Логічні типи даних. Для перевірки значення, яке повертає ця функція, використовується оператор ===.

Помилки/виключення

If offset is greater than the length of haystack, a ValueError will be thrown.

Журнал змін

Версія	Опис
8.0.0	Тепер параметр `needle` може бути порожнім рядком.
8.0.0	Passing an int as `needle` is no longer supported.
7.3.0	Passing an int as `needle` has been deprecated.

Приклади

Приклад #1 Checking if a needle is in the haystack

It is easy to mistake the return values for "character found at position 0" and "character not found". Here's how to detect the difference:

<?php
$mystring = 'Elephpant';

$pos = strrpos($mystring, "b");
if ($pos === false) { // note: three equal signs
    // not found...
}

?>

Приклад #2 Searching with offsets

<?php
$foo = "0123456789a123456789b123456789c";

// Looking for '0' from the 0th byte (from the beginning)
var_dump(strrpos($foo, '0', 0));

// Looking for '0' from the 1st byte (after byte "0")
var_dump(strrpos($foo, '0', 1));

// Looking for '7' from the 21th byte (after byte 20)
var_dump(strrpos($foo, '7', 20));

// Looking for '7' from the 29th byte (after byte 28)
var_dump(strrpos($foo, '7', 28));

// Looking for '7' right to left from the 5th byte from the end
var_dump(strrpos($foo, '7', -5));

// Looking for 'c' right to left from the 2nd byte from the end
var_dump(strrpos($foo, 'c', -2));

// Looking for '9c' right to left from the 2nd byte from the end
var_dump(strrpos($foo, '9c', -2));
?>

Поданий вище приклад виведе:

int(0)
bool(false)
int(27)
bool(false)
int(17)
bool(false)
int(29)

Прогляньте також

strpos() - Знаходить позицію першого входження підрядка в рядку
stripos() - Find the position of the first occurrence of a case-insensitive substring in a string
strripos() - Find the position of the last occurrence of a case-insensitive substring in a string
strrchr() - Find the last occurrence of a character in a string
substr() - Return part of a string