PHP Conference Japan 2024

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, если возникла ошибка.

Ошибки

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

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

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top