# grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_split — Split a string into an array

### 说明

grapheme_str_split(string `$string`, int `$length` = 1): array|false

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

### 参数

`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`
  要使用的区域设置。

### 返回值

grapheme_str_split() returns an array of strings, 或者在失败时返回 `false`.

### 错误／异常

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

### 更新日志

版本 | 说明
--- | ---
8.5.0 | 已新增可选参数 `locale`。

### 参见

- str_split() - 将字符串转换为数组
- mb_str_split() - 指定多字节字符串，返回其字符数组
- » Unicode Text Segmentation: Grapheme Cluster Boundaries

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open