mb_regex_set_options

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

mb_regex_set_optionsLit 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, vous devez placer le caractère représentant ce mode en dernier, le reste des caractères sera les options. Vous ne pouvez définir qu'un seul mode, alors que vous pouvez définir plusieurs options.

Options pour l'expression
OptionSignificationHistorique
iActive l'ambiguïté 
xActive les masques étendus 
mLe caractère '.' correspond également à de nouvelles lignes 
s'^' -> '\A', '$' -> '\Z' 
pIdentique aux options m et s 
lTrouve la plus longue correspondance 
nIgnore les correspondances vides 
eUtilise la fonction eval() sur le résultatObsolè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(). Utilisez-la avec mb_ereg_replace() ou mb_eregi_replace().

Modes de syntaxe de l'expression rationnelle (un seul peut être défini)
ModeSignification
jJava (Sun java.util.regex)
uGNU regex
ggrep
cEmacs
rRuby
zPerl
bPOSIX Basic regex
dPOSIX 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é.

Historique

VersionDescription
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.0options 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

  • mb_split() - Scinde une chaîne en tableau avec une expression rationnelle multioctets
  • mb_ereg() - Recherche par expression rationnelle avec support des caractères multioctets
  • mb_eregi() - Expression rationnelle insensible à la casse avec le support des caractères multioctets
To Top