grapheme_str_split

    (PHP 8 >= 8.4.0)

    grapheme_str_split — Separa 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

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 1 note

    up
    1
    cygx1 at blackhole dot io
    3 months ago
    Here is a userland implementation that can be included in code that needs to support PHP 8.3 and below:<?phpif (!function_exists('grapheme_str_split')) {    function grapheme_str_split(string $string, int $length = 1): array|false    {        if ($length < 1) {            throw new \ValueError('Argument #2 ($length) must be greater than 0 and less than or equal to 1073741823');        }        try {            return preg_split('/(\X{' . $length . '})/u', $string, -1, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);        } catch (\Throwable $e) {            return false;        }    }}?>
    ＋adicione uma nota
    To Top