array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.mb-regex-set-options.php', 1 => 'mb_regex_set_options', 2 => 'Lit et modifie les options des fonctions d\'expression rationnelle à support de caractères multioctets', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Fonctions sur les chaînes de caractères multioctets', ), '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' => 'fr', '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 — Lit et modifie les options des fonctions d'expression rationnelle à support de caractères multioctets

Description

mb_regex_set_options(?string $options = null): string

Configure les options par défaut avec les nouvelles valeurs contenues dans options, pour les fonctions d'expression rationnelle à support de caractères multioctets.

Liste de paramètres

options

Les options à définir, sous la forme d'une chaîne dont chaque caractère est une option. Pour définir un mode, il faut placer le caractère représentant ce mode en dernier, le reste des caractères sera les options. On ne peut définir qu'un seul mode, alors que l'on peut définir plusieurs options.

Options pour l'expression
Option Signification Historique
i Active l'ambiguïté  
x Active les masques étendus  
m Le caractère '.' correspond également à de nouvelles lignes  
s '^' -> '\A', '$' -> '\Z'  
p Identique aux options m et s  
l Trouve la plus longue correspondance  
n Ignore les correspondances vides  
e Utilise la fonction eval() sur le résultat Obsolète à partir de PHP 7.1.0 et supprimée à partir de PHP 8.0.0

Note:

L'option "e" n'a pas d'effet lorsqu'elle est définie par la mb_regex_set_options(). Utiliser-la avec mb_ereg_replace() ou mb_eregi_replace().

Modes de syntaxe de l'expression rationnelle (un seul peut être défini)
Mode Signification
j Java (Sun java.util.regex)
u GNU regex
g grep
c Emacs
r Ruby
z Perl
b POSIX Basic regex
d POSIX Extended regex

Valeurs de retour

Les options précédentes. Si le paramètre options est omis ou null, une chaîne de caractères décrivant les options courantes sera retournée.

Historique

Version Description
8.0.0 Si le paramètre options est fourni et non null, les options précédentes sont retournées. Auparavant, les options courantes étaient retournées.
8.0.0 options est désormais nullable.
8.0.0 L'option "e" lance désormais une ValueError.
7.1.0 L'option "e" émet désormais une E_DEPRECATED.

Voir aussi