mb_strrchr()

mb_strrchr() — Finds the last occurrence of a character in a string within another.

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_strrchr() finds the last occurrence of needle in haystack and returns the portion of haystack. If needle is not found, it returns false.

Signature

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

Parameters

ParameterTypeWhat it takes
$haystackstringThe string from which to get the last occurrence of needle.
$needlestringThe string to find in haystack.
$before_needleboolDetermines 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?stringThe 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_strrchr(); the signature and the parameter table above are the contract.

Changelog

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

See also

strrchr(), mb_strstr(), mb_strrichr()

All PHP 8.5 built-in functions

Reference card built from the PHP manual page mb_strrchr() (PHP documentation, CC BY 3.0). The page is generated from the manual, so the wording of the parameter and return value text follows php.net.