str_splitConvert a string to an array
&reftitle.description;
arraystr_splitstringstringintlength1
Converts a string to an array.
&reftitle.parameters;
string
The input string.
length
Maximum length of the chunk.
&reftitle.returnvalues;
If the optional length parameter is
specified, the returned array will be broken down into chunks with each
being length in length, except the final chunk
which may be shorter if the string does not divide evenly. The default
length is 1, meaning every chunk will be one byte in size.
&reftitle.errors;
If length is less than 1,
a ValueError will be thrown.
&reftitle.changelog;
&Version;&Description;8.2.0
If string is empty an empty &array; is now returned.
Previously an &array; containing a single empty string was returned.
8.0.0
If length is less than 1,
a ValueError will be thrown now;
previously, an error of level E_WARNING
has been raised instead, and the function returned &false;.
&reftitle.examples;
Example uses of str_split
]]>
&example.outputs;
H
[1] => e
[2] => l
[3] => l
[4] => o
[5] =>
[6] => F
[7] => r
[8] => i
[9] => e
[10] => n
[11] => d
)
Array
(
[0] => Hel
[1] => lo
[2] => Fri
[3] => end
)
]]>
&reftitle.notes;
str_split will split into bytes, rather than characters when dealing with a multi-byte encoded string.
mb_str_split can be used to split the string into code points.
grapheme_str_split can be used to split the string into grapheme clusters.
&reftitle.seealso;
mb_str_splitgrapheme_str_splitchunk_splitpreg_splitexplodecount_charsstr_word_countfor