(PHP 5 >= 5.2.0, PHP 7, PHP 8)
mb_strstr — Finds first occurrence of a string within another
$haystack,$needle,$before_needle = false,$encoding = null
mb_strstr() finds the first occurrence of
needle in haystack
and returns the portion of haystack.
If needle is not found, it returns false.
haystack
The string from which to get the first occurrence
of needle
needle
The string to find in haystack
before_needle
Determines which portion of haystack
this function returns.
If set to true, it returns all of haystack
from the beginning to the first occurrence of needle (excluding needle).
If set to false, it returns all of haystack
from the first occurrence of needle to the end (including needle).
encodingThe encoding
parameter is the character encoding. If it is omitted or null, the internal character
encoding value will be used.
Returns the portion of haystack,
or false if needle is not found.
As of PHP 8.0.0, a ValueError is thrown if
encoding is an invalid encoding.
Prior to PHP 8.0.0, an E_WARNING was emitted instead.
| Version | Description |
|---|---|
| 8.3.2 |
On invalid strings (those with encoding errors) and on
SJIS-mac (MacJapanese) strings, the portion of
haystack returned when
before_needle is true is now determined from
the same character indices as the other mbstring functions.
|
| 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.
|