# grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_split — Sépare une chaîne en un tableau

### Description

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

Cette fonction renvoie un tableau de chaînes, c'est une version de str_split() avec le support des caractères de cluster de graphèmes. Si le paramètre `length` est spécifié, la chaîne est séparée en morceaux de la longueur spécifiée en clusters de graphèmes (pas en octets).

### Liste de paramètres

`string`

  La string à séparer en clusters de graphèmes ou en morceaux. `string` doit être un UTF-8 valide.

`length`

  Chaque élément du tableau renvoyé sera composé de `length` clusters de graphèmes.

### Valeurs de retour

grapheme_str_split() renvoie un tableau de chaînes, ou `false` si une erreur survient.

### Erreurs / Exceptions

Si `string` n'est pas une chaîne de caractères valide, une ValueError sera lancée.

### Voir aussi

- str_split() - Convertit une chaîne de caractères en tableau
- mb_str_split() - Pour une chaîne multi-octets donnée, renvoie un tableau de ses caractères
- » Segmentation de texte Unicode : Limites des Clusters de Graphèmes