Retorna parte de uma string a partir da primeira ocorrência de outra string até o final

# grapheme_strstr

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

grapheme_strstr — Retorna parte de uma string a partir da primeira ocorrência de outra string até o final

### Descrição

Estilo procedural

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

Retorna parte de uma string a partir da primeira ocorrência de outra string (inclusive) até o final.

### Parâmetros

`haystack`

  A string onde ocorrerá a pesquisa. 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_strstr() retorna a parte da string `haystack` antes da primeira ocorrência de `needle` (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_strstr()

    <?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

    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_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
- 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
- » Unicode Text Segmentation: Grapheme Cluster Boundaries

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