« Функції Graphemegrapheme\_stripos »PHP ManualФункції Grapheme

grapheme_extract

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

grapheme_extract — Функція для вилучення послідовності кластерів за замовчуванням графем з текстового буфера, яка повинна бути закодована в UTF-8

Опис

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

grapheme_extract(    string $haystack,    int $size,    int $type = GRAPHEME_EXTR_COUNT,    int $offset = 0,    int &$next = null): string|false

Функція для вилучення послідовності кластерів за замовчуванням графем з текстового буфера, яка повинна бути закодована в UTF-8.

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

haystack

Рядок для пошуку.

size

Максимальна кількість елементів, що повертаються на основі type

type

Визначає тип одиниць, на які вказує параметр size :

  • GRAPHEME_EXTR_COUNT (за замовчуванням) -size- кількість кластерів графеми для вилучення за замовчуванням.
  • GRAPHEME_EXTR_MAXBYTES -size- максимальна кількість байтів, що повертаються.
  • GRAPHEME_EXTR_MAXCHARS -size- це максимальна кількість символів UTF-8, що повертаються.

offset

Початкова позиція haystack в байтах - якщо задано, воно має бути нулем або позитивним значенням, яке менше або дорівнює довжині haystack в байтах, або негативним значенням, що відраховується від кінця haystack. Якщо offset не вказує перший байт символу UTF-8, початкова позиція переміщається на межу наступного символу.

next

Посилання на значення, яке буде встановлене для наступної початкової позиції. Коли дзвінок повертається, це може вказувати на позицію першого байта за кінцем рядка.

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

Рядок, що починається зі зміщення offset і межа кластера графеми, що закінчується, за умовчанням, яка відповідає зазначеним sizeиtypeили**false**в случае возникновения ошибки.

список змін

ВерсияОпис
7.1.0Додано підтримку негативних значень offset

Приклади

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

Loading...

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

o%CC%88

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