CascadiaPHP 2024

grapheme_stripos

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

grapheme_striposEncontra 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á:

2

Veja Também

add a note

User Contributed Notes 1 note

up
0
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';}
To Top