Grapheme Functions
PHP Manual

grapheme_str_split

Split a string into an array

Description

arrayfalse 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).

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.

locale
Locale to use.

Return Values

grapheme_str_split returns an array of strings, or false on failure.

Errors/Exceptions

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

Changelog

Version Description
8.5.0 The optional parameter locale has been added.