Retorna parte de uma string a partir da primeira ocorrência de outra string (insensível a maiúsculas/minúsculas) até o final

# grapheme_stristr

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

grapheme_stristr — Retorna parte de uma string a partir da primeira ocorrência de outra string (insensível a maiúsculas/minúsculas) até o final

### Descrição

Estilo procedural

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

Retorna parte da string `haystack` iniciando da primeira ocorrência de uma outra string (insensível a maiúsculas/minúsculas) até o final de `haystack`.

### Parâmetros

`haystack`

  A string de entrada. Deve ser em UTF-8 válido.

`needle`

  A string a ser procurada. Deve ser em UTF-8 válido.

`beforeNeedle`

  Caso seja `true`, grapheme_stristr() retorna a parte da string `haystack` antes da primeira ocorrência da string procurada (excluindo `needle`).

`locale`
  Localidade a ser usada.

### Valor Retornado

Retorna a parte de `haystack`, ou `false` se `needle` não for encontrada.

### Registro de Alterações

Versão | Descrição
--- | ---
8.5.0 | O parâmetro opcional `locale` foi adicionado.

### Exemplos

Exemplo #1 Exemplo de grapheme_stristr()

    <?php

    $char_a_ring_nfd = "a\xCC\x8A";  // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) NFD
    $char_o_diaeresis_nfd = "o\xCC\x88"; // '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

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

    ?>

O exemplo acima produzirá:

    o%CC%88a%CC%8A

### Veja Também

- grapheme_stripos() - Encontra a posição (em unidades de grafema) da primeira ocorrência de uma string não sensível a maiúsculas/minúsculas
- grapheme_strpos() - Encontra a posição (em unidades de grafema) da primeira ocorrência de uma string
- grapheme_strripos() - Encontra a posição (em unidades de grafema) da última ocorrência de uma string (insensível a maiúsculas/minúsculas)
- grapheme_strrpos() - Encontra a posição (em unidades de grafema) da última ocorrência de uma string
- grapheme_strstr() - Retorna parte de uma string a partir da primeira ocorrência de outra string até o final
- » Unicode Text Segmentation: Grapheme Cluster Boundaries

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