(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
grapheme_extract — Extrai uma sequência de grupos padrão de grafemas de um buffer de texto em UTF-8
Estilo procedural
$haystack,$size,$type = GRAPHEME_EXTR_COUNT,$offset = 0,&$next = nullEsta função extrai uma sequência de grupos padrão de grafemas a partir de um buffer de texto codificado em UTF-8.
haystackA string onde a pesquisa será feita.
size
Número máximo de itens - baseado no tipo type - a retornar.
type
Define o tipo de unidades referidas pelo parâmetro size:
size é o número de grupos padrão
de grafemas a extrair.size é o número máximo de bytes
retornados.size é o número máximo de caracteres
UTF-8 retornados.offset
Posição inicial no haystack em bytes - se informado, precisa ser zero
ou um inteiro positivo que seja menor ou igual ao comprimento de haystack em
bytes, ou um valor negativo que conta a partir do final de haystack.
Se offset não apontar para o primeiro byte de um caractere
UTF-8, a posição de início é movida para o primeiro byte do caractere seguinte.
nextReferência a um valor que será definido para a próxima posição de início. Quando a chamada retornar, esta variável poderá apontar para a primeira posição em bytes após o final da string.
Um string com deslocamento em offset e terminando em um limite de grupo padrão
de grafema que esteja em conformidade com os parâmetros size e type especificados,
ou false em caso de falha.
| Versão | Descrição |
|---|---|
| 7.1.0 |
Suporte para offset negativo foi adicionado.
|
Exemplo #1 Exemplo de grapheme_extract()
<?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_extract( $char_a_ring_nfd . $char_o_diaeresis_nfd, 1, GRAPHEME_EXTR_COUNT, 2));
?>O exemplo acima produzirá:
o%CC%88