ereg_replace
eregi_replace
Fonctions POSIX Regex
PHP Manual

# ereg

(PHP 4, PHP 5)

ereg — Recherche par expression rationnelle standard

### Description

int ereg ( string `$pattern` , string `$string` [, array `&$regs` ] )

Recherche dans la chaîne `string` les séquences de caractères qui correspondent au masque `pattern` , en tenant compte de la casse.

### Liste de paramètres

`pattern`

  Expression rationnelle sensible à la casse.

`string`

  La chaîne d'entrée.

`regs`

  Si au moins une séquence est trouvée (éventuellement dans les parenthèses capturantes de `pattern` ), et que la fonction est appelée avec un troisième argument `regs` , les résultats seront enregistrés dans `regs` .

  $regs[1] contiendra la première parenthèse capturante (celle qui commence le plus tôt), $regs[2] contiendra la deuxième parenthèse capturante (celle qui commence après la première), et ainsi de suite. $regs[0] contient une copie de la chaîne.

### Valeurs de retour

Retourne la longueur de l'occurrence trouvée si une occurrence a été trouvée dans la chaîne `string` et `FALSE` dans le cas contraire ou si une erreur est survenue.

Si le paramètre optionnel `regs` n'est pas passé à la fonction ou si la longueur du paramètre `string` vaut 0, la fonction retournera 1.

### Historique

Version | Description
--- | ---
4.1.0 | Pour les versions de PHP inférieures ou égales à 4.1.0, $regs sera rempli d'exactement dix éléments, même s'il y a plus ou moins de dix parenthèses capturantes. Cela n'a aucun effet sur ereg() pour chercher plus de sous-chaînes. Si aucun résultat n'est trouvé, $regs ne sera pas altéré par ereg().

### Exemples

Exemple #1 Exemple avec ereg()

L'exemple suivant prend une date au format ISO (YYYY-MM-DD) et l'affiche sous la forme DD.MM.YYYY :

`<?php
if (ereg ("([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs)) {
echo "$regs[3].$regs[2].$regs[1]";
} else {
echo "Format de date invalide : $date";
}
?>`

### Notes

> Note: À partir de PHP 5.3.0, l'extension regex est obsolète : un appel à cette fonction émettra une erreur de niveau `E_DEPRECATED`.

> Note: preg_match(), qui utilise la syntaxe des expressions rationnelles compatibles PERL, est une alternative plus rapide de ereg().

### Voir aussi

- eregi() - Recherche par expression rationnelle insensible à la casse
- ereg_replace() - >Remplacement par expression rationnelle
- eregi_replace() - Remplacement par expression rationnelle insensible à la casse
- preg_match() - Expression rationnelle standard
- strpos() - Trouve la position d'un caractère dans une chaîne
- strstr() - Trouve la première occurrence dans une chaîne
- quotemeta() - Protège les métacaractères

ereg_replace
eregi_replace
Fonctions POSIX Regex
PHP Manual