ereg
(PHP 4, PHP 5)
ereg — Recherche par expression rationnelle standard
Description
$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.
Cette fonction est OBSOLETE depuis PHP 5.3.0. Nous vous encourageons vivement à ne plus l'utiliser.
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 argumentregs
, les résultats seront enregistrés dansregs
.$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()
<?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 et vous devez utiliser l'extension PCRE à la place. Appeler des fonctions de l'extension regex émettra des alertes de type
E_DEPRECATED
. Voir la liste des différences pour vous aider dans la conversion en PCRE.
ereg() est obsolète depuis PHP 5.3.0. Utilisez plutôt la fonction preg_match().
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() - Cherche la position de la première occurrence dans une chaîne
- strstr() - Trouve la première occurrence dans une chaîne
- quotemeta() - Protège les métacaractères