array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mb-regex-set-options.php', 1 => 'mb_regex_set_options', 2 => 'Define/Obtém as opções padrão para funções mbregex', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Strings Multibyte e Funções', ), 'prev' => array ( 0 => 'function.mb-regex-encoding.php', 1 => 'mb_regex_encoding', ), 'next' => array ( 0 => 'function.mb-rtrim.php', 1 => 'mb_rtrim', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mbstring/functions/mb-regex-set-options.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_regex_set_options

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

mb_regex_set_options — Define/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ção Significado Registro de Alterações
i correspondência ambígua ativada  
x Ativa a forma de padrão estendida  
m '.' corresponde a quebras de linha  
s '^' -> '\A', '$' -> '\Z'  
p Mesmo que as opçõe m e s  
l Encontrar as correspondências mais longas  
n Ignorar correspondências vazias  
e eval() código resultante Descontinuado 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)
Modo Significado
j Java (Sun java.util.regex)
u GNU regex
g grep
c Emacs
r Ruby
z Perl
b Regex Básico POSIX
d Regex 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ão Descriçã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.0 options é 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