grapheme_str_split

    (PHP 8 >= 8.4.0)

    grapheme_str_split — 書記素クラスターを受け取り、文字の配列を返す

    説明

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

    この関数は文字の配列を返します。 これは str_split() に書記素クラスターのサポートを追加したものです。 length を指定すると、文字列は指定された数の 書記素クラスターに分割されます。

    パラメータ

    string

    書記素クラスターまたはチャンクに分割するstring。 string はUTF-8でなければなりません。

    length

    配列の各要素が length 書記素クラスターで構成されます。

    戻り値

    grapheme_str_split() は文字列の配列を返します。 失敗した場合に false を返します。

    エラー / 例外

    length が 1 未満のとき、 ValueError がスローされます。

    参考

    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
    11 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
    To Top