mb_strrichr()

mb_strrichr() — Finds the last occurrence of a character in a string within another, case insensitive.

Built-in function of PHP 8.5. The manual lists it as available in PHP 5 >= 5.2.0, PHP 7, PHP 8. This page is the reference card: signature, parameters and return value, plus the changelog and the example the manual provides.

What it does

mb_strrichr() finds the last occurrence of needle in haystack and returns the portion of haystack. Unlike mb_strrchr(), mb_strrichr() is case-insensitive. If needle is not found, it returns false.

Signature

mb_strrichr(string $haystack, string $needle, bool $before_needle = false, ?string $encoding = null): string|false

Parameters

Parameter	Type	What it takes
$haystack	string	The string from which to get the last occurrence of needle.
$needle	string	The string to find in haystack.
$before_needle	bool	Determines which portion of haystack this function returns. If set to true, it returns all of haystack from the beginning to the last occurrence of needle. If set to false, it returns all of haystack from the last occurrence of needle to the end.
$encoding	?string	The encoding parameter is the character encoding. If it is omitted or null, the internal character encoding value will be used.

Return value

Returns the portion of haystack. or false if needle is not found.

Example

The PHP manual ships no example for mb_strrichr(); the signature and the parameter table above are the contract.

Changelog

Version	Change
8.0.0	needle now accepts an empty string.
8.0.0	encoding is nullable now.
8.0.0	Now throws a ValueError if encoding is an invalid encoding. Previously, an E_WARNING was emitted and false was returned.