grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_splitSepara uma string em um array

Descrição

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

Esta função retorna um array de strings. É uma versão de str_split() com suporte para caracteres de byte de grupos de grafema. Se o parâmetro length for especificado, a string é quebrada em pedaços desse comprimento em unidades de grupos de grafema (não em bytes).

Parâmetros

string

A string a ser separada em grupos de grafemas ou pedaços. string precisa ser em UTF-8 válido.

length

Cada elemento do array retornado será composto pelo número de grupos de grafema especificado no parâmetro length.

Valor Retornado

grapheme_str_split() retorna um array de strings, ou false em caso de falha.

Erros/Exceções

Se length for menor que 1, um ValueError será lançado.

Veja Também