grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_split — Divide una string en un array

Descripción

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

Esta función devuelve un array de strings, es una versión de str_split() con soporte para caracteres de cluster de grafemas. Si el argumento length es especificado, la string es dividida en trozos de la longitud especificada en clusters de grafemas (no en bytes).

Parámetros

string: La string a dividir en clusters de grafemas o en trozos. string debe ser un UTF-8 válido.
length: Cada elemento del array devuelto estará compuesto por length clusters de grafemas.

Valores devueltos

grapheme_str_split() devuelve un array de strings, o false en caso de error.

Errores/Excepciones

Si string no es una string válida, se lanzará una ValueError.

Ver también

str_split() - Convierte un string en un array
mb_str_split() - Para una cadena multibyte dada, devuelve un array de sus caracteres
» Segmentación de texto Unicode: Límites de Clusters de Grafemas

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

cygx1 at blackhole dot io ¶

2 months ago

Here is a userland implementation that can be included in code that needs to support PHP 8.3 and below:

<?php

if (!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;
        }
    }
}

?>

＋add a note