# mb_ereg

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

mb_ereg — Recherche par expression rationnelle avec support des caractères multioctets

### Description

mb_ereg(string `$pattern`, string `$string`, array `&$matches` = `null`): bool

Recherche par expression rationnelle avec support des caractères multioctets.

### Liste de paramètres

`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.

### Valeurs de retour

Retourne si une correspondence de `pattern` a été trouvé dans `string`.

### Historique

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.

### Notes

> 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.

### Voir aussi

- mb_regex_encoding() - Définit/Récupère l'encodage des caractères pour les expressions régulières multioctets
- mb_eregi() - Expression rationnelle insensible à la casse avec le support des caractères multioctets