grapheme_str_split

    (PHP 8 >= 8.4.0)

    grapheme_str_split — Split a string into an array

    Beschreibung

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

    This function will return an array of strings, it is a version of str_split() with support for grapheme cluster byte characters. If the length parameter is specified, the string is broken down into chunks of the specified length in grapheme clusters (not bytes).

    Parameter-Liste

    string

    The string to split into grapheme clusters or chunks. string must be valid UTF-8.

    length

    Each element of the returned array will be composed of length grapheme clusters.

    Rückgabewerte

    grapheme_str_split() returns an array of strings, Bei einem Fehler wird false zurückgegeben..

    Fehler/Exceptions

    If length is less than 1, a ValueError will be thrown.

    Siehe auch

    Found A Problem?

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

    User Contributed Notes 1 note

    up
    1
    cygx1 at blackhole dot io
    4 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;        }    }}?>
    ＋add a note
    To Top