[PHP 4, PHP 5, PHP 7, PHP 8]
explode — Split a string by a string
Description
explode[string $separator
, string $string
, int $limit
= PHP_INT_MAX
]: array
Parameters
separator
The boundary string.
string
The input string.
limit
If limit
is set and positive, the returned array will contain a maximum of limit
elements with the last element containing the rest of string
.
If the limit
parameter is negative, all components except the last -limit
are returned.
If the limit
parameter is zero, then
this is treated as 1.
Note:
Prior to PHP 8.0, implode[] accepted its parameters in either order. explode[] has never supported this: you must ensure that the
separator
argument comes before thestring
argument.
Return Values
Returns an
array of strings created by splitting the string
parameter on boundaries formed by the separator
.
If separator
is an empty string [""], explode[] throws a ValueError. If separator
contains a value that is not contained in string
and a negative limit
is used, then an empty array will be returned, otherwise an
array containing string
will be returned. If separator
values appear at the start or end of string
, said values will be added as an empty array value either in the first or last position of the returned array respectively.
Changelog
8.0.0 | explode[] will now throw ValueError when separator parameter is given an empty string ["" ]. Previously, explode[] returned false instead.
|
Examples
Example #1 explode[] examples
Example #2 explode[] return examples