mb_regex_set_options

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

mb_regex_set_optionsDefine/Obtém as opções padrão para funções mbregex

Descrição

mb_regex_set_options(?string$options = null): string

Define/obtém as opções padrão descritas por options para funções de regex multibyte.

Parâmetros

options

As opções a serem definidas. Esta é uma string onde cada caractere é uma opção. Para definir um modo, o caractere de modo deve ser o último a ser definido, no entanto, pode haver apenas um modo, mas várias opções podem ser definidas.

Opções de Regex
OpçãoSignificadoRegistro de Alterações
icorrespondência ambígua ativada 
xAtiva a forma de padrão estendida 
m'.' corresponde a quebras de linha 
s'^' -> '\A', '$' -> '\Z' 
pMesmo que as opçõe m e s 
lEncontrar as correspondências mais longas 
nIgnorar correspondências vazias 
eeval() código resultanteDescontinuado desde o PHP 7.1.0 e removido a partir do PHP 8.0.0

Nota:

A opção "e" não tem efeito quando definida através de mb_regex_set_options(). Use-a com mb_ereg_replace() ou mb_eregi_replace().

Modos de sintaxe Regex (apenas um pode ser definido)
ModoSignificado
jJava (Sun java.util.regex)
uGNU regex
ggrep
cEmacs
rRuby
zPerl
bRegex Básico POSIX
dRegex Estendido POSIX

Valor Retornado

As opções anteriores. Se options for omitido ou null, retorna a string que descreve as opções atuais.

Registro de Alterações

VersãoDescrição
8.0.0 Se o parâmetro options for fornecido e não for null, as opções anteriores são retornadas. Anteriormente, as opções atuais eram retornadas.
8.0.0options é anulável agora.
8.0.0 A opção "e" agora lança um ValueError.
7.1.0 A opção "e" agora emite um E_DEPRECATED.

Veja Também

  • mb_split() - Divide uma string multibyte usando expressão regular
  • mb_ereg() - Correspondência de expressão regular com suporte multibyte
  • mb_eregi() - Correspondência de expressão regular sem diferenciar maiúsculas e minúsculas com suporte multibyte
To Top