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 определяет максимум графемных кластеров в одном элементе массива.

locale
Идентификатор языковых и региональных параметров.

Возвращаемые значения

Функция grapheme_str_split() возвращает массив строк или false, если возникла ошибка.

Ошибки

Функция выбросит ошибку ValueError, если значение параметра length окажется меньше 1.

Список изменений

Версия Описание
8.5.0 Добавили необязательный параметр locale.

Смотрите также