(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
mb_ereg — Recherche par expression rationnelle avec support des caractères multioctets
$pattern
, string $string
, array &$matches
= null
): boolRecherche par expression rationnelle avec support des caractères multioctets.
pattern
Le masque de recherche.
string
La chaîne sur laquelle porte la recherche.
matches
Si des correspondances sont trouvées pour les sous-chaînes entre
parenthèses de pattern
et si la fonction est
appelée avec le troisième argument matches
, les
correspondances seront stockées dans les éléments du tableau
matches
. Si aucune correspondance n'est trouvée,
matches
a pour valeur un tableau vide.
$matches[1] contiendra la sous-chaîne qui commence à la première parenthèse gauche; $matches[2] contiendra la sous-chaîne commençant à la seconde, et ainsi de suite. $matches[0] contiendra une copie de la chaîne complète assortie.
Retourne si une correspondence de pattern
a été trouvé
dans string
.
Version | Description |
---|---|
8.0.0 |
Cette fonction retourne désormais true en cas de succès.
Auparavant, elle retournait la longueur d'octet de la chaîne trouvé, si une correspondence
pour pattern était trouvé dans string et
que matches était fournis.
Si la paramètre optionnel matches n'était pas fournis ou que la
longueur de la chaîne correspondante était 0 , cette fonction retournait 1 .
|
7.1.0 |
mb_ereg() va maintenant affecter matches
à un array vide, si rien ne correspond. Auparavant, les
matches n'étaient pas modifiées dans ce cas.
|
Note:
L'encodage interne ou l'encodage des caractères spécifié par la fonction mb_regex_encoding() sera utilisé comme encodage de caractères pour cette fonction.