grapheme_str_split
(PHP 8 >= 8.4.0)
grapheme_str_split — Разбивает строку на массив графемных кластеров
Описание
Функция возвращает массив строк и работает аналогично функции str_split(),
но разбивает строку по графемным кластерам — последовательностям одно- или многобайтовых кодовых точек,
которыми кодируется единое для восприятия графическое представление символа.
Функция разбивает строку на части заданной длины, если передали аргумент length;
длина отдельной части измеряется не в байтах, а в графемных кластерах.
Список параметров
string
-
Строка (string), которую требуется разбить на части из одного
или большего количества графемных кластеров.
Параметр string принимает строку, которая соответствует стандарту UTF-8.
length
-
Параметр length определяет максимум графемных кластеров в одном элементе массива.
locale
-
Идентификатор языковых и региональных параметров.
Возвращаемые значения
Функция grapheme_str_split() возвращает массив строк или false, если возникла ошибка.
Ошибки
Функция выбросит ошибку ValueError,
если значение параметра length окажется меньше 1.