grapheme_stripos

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

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

Descrição

Estilo procedural

grapheme_stripos(string $haystack, string $needle, int $offset = 0): int|false

Encontra a posição (em unidades de grafema) da primeira ocorrência de uma string não sensível a maiúsculas/minúsculas.

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.
offset: O parâmetro opcional offset permite especificar onde no haystack deve-se iniciar a pesquisa, como uma posição em unidades de grafema (não em bytes ou caracteres). Se a posição for negativa, será tratada como relativa ao final da string. A posição retornada ainda será relativa ao início do haystack independentemente do valor de offset.

Valor Retornado

Retora a posição como um inteiro. Se needle não for encontrado, grapheme_stripos() retornará false.

Registro de Alterações

Versão	Descrição
7.1.0	Suporte para `offset` negativo foi adicionado.

Exemplos

Exemplo #1 Exemplo de grapheme_stripos()

<?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 grapheme_stripos( $char_a_ring_nfd . $char_a_ring_nfd . $char_o_diaeresis_nfd, $char_O_diaeresis_nfd);

?>

O exemplo acima produzirá:

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

add a note

User Contributed Notes 1 note

down

Anonymous ¶

6 years ago


As expected, grapheme_stripos() does return boolean FALSE if the needle is not found in the haystack.
Use strict type comparison to check for that condition, like:

if (FALSE === grapheme_stripos('a', 'b')) {print 'Needle not found';}

add a note