grapheme_strpos

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

grapheme_strpos — Encontra a posição (em unidades de grafema) da primeira ocorrência de uma string

Descrição

Estilo procedural

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

Encontra a posição (em unidades de grafema) da primeira ocorrência de uma string.

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_strpos() retornará false.

Registro de Alterações

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

Exemplos

Example #1 Exemplo de grapheme_strpos()

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

?>

O exemplo acima produzirá:

2

Veja Também