(PHP 7 >= 7.4.0, PHP 8)
mb_str_split — Given a multibyte string, return an array of its characters
This function will return an array of strings, it is a version of str_split() with support for encodings of variable character size as well as fixed-size encodings of 1,2 or 4 byte characters.
If the length parameter is specified, the string is broken down into chunks of the specified length in characters (not bytes).
The encoding parameter can be optionally specified and it is good practice to do so.
stringThe string to split into characters or chunks.
lengthIf specified, each element of the returned array will be composed of multiple characters instead of a single character.
encodingThe encoding
parameter is the character encoding. If it is omitted or null, the internal character
encoding value will be used.
A string specifying one of the supported encodings.
mb_str_split() returns an array of strings.
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.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.
|
| 8.0.0 |
This function no longer returns false on failure.
|