« grapheme\_strstrФункції IDN »PHP ManualФункції Grapheme

grapheme_substr

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

grapheme_substr — Повертає частину рядка

Опис

Процедурний стиль

grapheme_substr(string $string, int $offset, ?int $length = null): string|false

Повертає частину рядка.

Список параметрів

string

Вхідний рядок. Має бути коректним UTF-8.

offset

Початкова позиція в одиницях графеми за промовчанням. Якщо offset більше, або дорівнює нулю, рядок, що повертається, буде починатися з позиції offset $string, починаючи з нуля. Якщо значення offset негативний рядок, що повертається, буде починатися з одиниці графеми offsetот конца строки.

length

Довжина у графемних одиницях. Якщо встановлено позитивне значення length, що повертається рядок міститиме не більше length одиниць графеми, починаючи зі значення offset (залежно від довжини рядка). Якщо встановлено негативне значення length, то така кількість одиниць графеми буде опущена в кінці рядка (після того, як початкова позиція була обчислена, якщо параметр offset негативний). Якщо offset позначає позицію за межами цього усічення, буде повернуто порожній рядок.

Значення, що повертаються

Повертає витягнуту частину stringили**false**в случае возникновения ошибки.

список змін

ВерсияОпис
8.0.0Функція тепер послідовно притискає зсуви, що виходять за межі, до кордону рядка. Раніше в деяких випадках замість порожнього рядка поверталося значення false

Приклади

Приклад #1 Приклад використання grapheme_substr()****

Loading...

Результат виконання наведеного прикладу:

a%CC%8Abco%CC%88

Дивіться також