Correspondência de expressão regular com suporte multibyte

Descrição

mb_ereg(string $pattern, string $string, array &$matches = null): bool

Executa a correspondência de expressão regular com suporte multibyte..

Parâmetros

pattern

O padrão de busca.

string

A string de busca.

matches

Se forem encontradas correspondências para substrings entre parênteses de pattern e a função for chamada com o terceiro argumento matches, as correspondências serão armazenadas nos elementos do array matches. Se não forem encontradas correspondências, matches é definido como um array vazio.

$matches[1] conterá a substring que começa no primeiro parêntese à esquerda; $matches[2] conterá a substring que começa no segundo parêntese, e assim por diante. $matches[0] conterá uma cópia da string completa correspondida.

Valor Retornado

Retorna se pattern corresponde a string.

Registro de Alterações

Versão	Descrição
8.0.0	Esta função agora retorna `true` em caso de sucesso. Anteriormente, ela retornava o comprimento em bytes da string correspondida se uma correspondência para `pattern` fosse encontrada em `string` e `matches` fosse passado. Se o parâmetro opcional `matches` não fosse passado ou o comprimento da string correspondida fosse `0`, esta função retornava `1`.
7.1.0	mb_ereg() agora define `matches` como um array vazio se nada for correspondido. Anteriormente, `matches` não era modificado nesse caso.

Notas

Note:
A codificação interna ou a codificação de caracteres especificada por mb_regex_encoding() será usada como a codificação de caracteres para esta função.

Veja Também

mb_regex_encoding() - Define/Obtém codificação de caracteres para regex multibyte
mb_eregi() - Correspondência de expressão regular sem diferenciar maiúsculas e minúsculas com suporte multibyte