書記素クラスターを受け取り、文字の配列を返す

# grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_split — 書記素クラスターを受け取り、文字の配列を返す

### 説明

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

この関数は文字の配列を返します。 これは str_split() に書記素クラスターのサポートを追加したものです。 `length` を指定すると、文字列は指定された数の 書記素クラスターに分割されます。

### パラメータ

`string`

  書記素クラスターまたはチャンクに分割するstring。 `string` はUTF-8でなければなりません。

`length`

  配列の各要素が `length` 書記素クラスターで構成されます。

### 戻り値

grapheme_str_split() は文字列の配列を返します。 失敗した場合に `false` を返します。

### エラー / 例外

`length` が `1` 未満のとき、 ValueError がスローされます。

### 参考

- str_split() - 文字列を配列に変換する
- mb_str_split() - マルチバイト文字列を受取り、文字の配列を返す
- » Unicode Text Segmentation: Grapheme Cluster Boundaries

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