grapheme_str_split

Split a string into an array

&reftitle.description; ``array``false```grapheme_str_split` `string` `string` `int` `length` 1

This function will return an array of strings, it is a version of `str_split` with support for grapheme cluster byte characters. If the `length` parameter is specified, the string is broken down into chunks of the specified length in grapheme clusters (not bytes).

&reftitle.parameters;

`string`

- The `string` to split into grapheme clusters or chunks. `string` must be valid UTF-8.

`length`

- Each element of the returned array will be composed of `length` grapheme clusters.

&reftitle.returnvalues;

`grapheme_str_split` returns an array of strings, &return.falseforfailure;.

&reftitle.errors;

If `length` is less than `1`, a `ValueError` will be thrown.

&reftitle.seealso;

- `str_split`
- `mb_str_split`
- Unicode Text Segmentation: Grapheme Cluster Boundaries