grapheme_str_split

(PHP 8 >= 8.4.0)

grapheme_str_split — Split a string into an array

Açıklama

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).

Bağımsız Değişkenler

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.

Dönen Değerler

grapheme_str_split() returns an array of strings, başarısızlık durumunda false döner.

Hatalar/İstisnalar

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

Ayrıca Bakınız

str_split() - Bir dizgeyi bir diziye dönüştürür
mb_str_split() - Belirtilen çok baytlı dizgenin karakterlerini içeren bir dizi döndürür
» Unicode Text Segmentation: Grapheme Cluster Boundaries

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 days 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