(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
mb_ereg — Correspondência de expressão regular com suporte multibyte
Executa a correspondência de expressão regular com suporte multibyte..
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.
Retorna se pattern
corresponde a string
.
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.
|
Nota:
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.