Возвращает часть строки относительно первого вхождения подстроки без учёта регистра

# grapheme_stristr

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

grapheme_stristr — Возвращает часть строки относительно первого вхождения подстроки без учёта регистра

### Описание

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

function grapheme_stristr(
string `$haystack`,
string `$needle`,
bool `$beforeNeedle` = `false`,
string `$locale` = ""
): string|false

По умолчанию функция возвращает часть строки `haystack` от первого вхождения подстроки до конца строки `haystack`. Функция ищет подстроку без учёта регистра.

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

`haystack`

  Строка по стандарту UTF-8, в которой требуется найти подстроку.

`needle`

  Подстрока по стандарту UTF-8, которую требуется найти в строке.

`beforeNeedle`

  При передаче значения `true` функция grapheme_stristr() возвращает часть строки `haystack` до первого вхождения подстроки `needle`, не включая подстроку `needle`.

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

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

Функция возвращает часть строки `haystack`. Функция вернёт значение `false`, если не найдёт подстроку `needle`.

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

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

### Примеры

Пример #1 Пример извлечения части строки функцией grapheme_stristr()

    <?php

    // Символ | Название | Кодовая точка | Форма нормализации

    // å: 'LATIN SMALL LETTER A WITH RING ABOVE', U+00E5, NFD
    $char_a_ring_nfd = "a\xCC\x8A";

    // ö: 'LATIN SMALL LETTER O WITH DIAERESIS', U+00F6, NFD
    $char_o_diaeresis_nfd = "o\xCC\x88";

    // Ö: 'LATIN CAPITAL LETTER O WITH DIAERESIS', U+00D6, NFD
    $char_O_diaeresis_nfd = "O\xCC\x88";

    print urlencode(grapheme_stristr(
        $char_a_ring_nfd . $char_o_diaeresis_nfd . $char_a_ring_nfd,
        $char_O_diaeresis_nfd
    ));

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

    o%CC%88a%CC%8A

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

- grapheme_stripos() - Вычисляет позицию первого вхождения подстроки в графемных кластерах без учёта регистра
- grapheme_strpos() - Вычисляет позицию первого вхождения подстроки в графемных кластерах
- grapheme_strripos() - Вычисляет позицию последнего вхождения подстроки в графемных кластерах без учёта регистра
- grapheme_strrpos() - Вычисляет позицию последнего вхождения подстроки в графемных кластерах
- grapheme_strstr() - Возвращает часть строки относительно первого вхождения подстроки
- » Сегментация текста в Юникоде: Границы графемных кластеров

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open