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
