Index: phpdoc/fr/functions/regex.xml diff -u phpdoc/fr/functions/regex.xml:1.10 phpdoc/fr/functions/regex.xml:1.11 --- phpdoc/fr/functions/regex.xml:1.10 Tue Mar 27 03:02:14 2001 +++ phpdoc/fr/functions/regex.xml Mon Apr 23 11:26:41 2001 @@ -1,42 +1,42 @@ - - Expressions régulières - Regex - - - Les expressions régulières sont utilisées - pour effectuer des manipulations complexes de chaînes de - caractères. Les fonctions sont : - - - ereg - - - ereg_replace - - - eregi - - - eregi_replace - - - split - - - spliti - - - Ces fonctions requièrent toutes une expression régulière - comme premier argument. PHP utilise les expressions régulières - avancées de POSIX (POSIX 1003.2). Pour avoir tous les détails - sur ces expressions, reportez vous aux pages de manuel inclues dans le - répertoire de la distribution PHP. - + + Expressions régulières + Regex + + + Les expressions régulières sont utilisées + pour effectuer des manipulations complexes de chaînes de + caractères. Les fonctions sont : + + + ereg + + + ereg_replace + + + eregi + + + eregi_replace + + + split + + + spliti + + + Ces fonctions requièrent toutes une expression régulière + comme premier argument. PHP utilise les expressions régulières + avancées de POSIX (POSIX 1003.2). Pour avoir tous les détails + sur ces expressions, reportez vous aux pages de manuel inclues dans le + répertoire de la distribution PHP. + - - - Expressions régulières - + + + Expressions régulières + <?php ereg("abc",$string); /* Retourne TRUE si "abc" @@ -61,68 +61,68 @@ $string = ereg_replace("\n","",$string); /* Supprime toutes les nouvelles lignes de $string. */ ?> - - - - - - - ereg - Expression régulière 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. - - - 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. + + + + + + + ereg + Expression régulière 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. - - Si ereg trouve ses solutions pour les parenthèses - capturantes, $regs contiendra exactement 10 éléments, - même si il y avait plus ou moins de 10 parenthèses capturantes - qui étaient valides. Cela n'a aucun effet sur les capacités de - la fonction ereg à trouver d'autres sous chaînes. - Si aucune valeur n'est trouvée, $regs ne sera pas modifié par - ereg. - - - La recherche est sensible à la casse. - - - ereg retourne TRUE si une occurence - a été trouvée dans la chaîne et - FALSE dans le cas contraire, ou si une erreur est survenue. - - - L'exemple suivant prend une date au format ISO (YYYY-MM-DD) et l'affiche sous - la forme DD.MM.YYYY : - - Exemple <function>ereg</function> - + + 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. + + + Si ereg trouve ses solutions pour les parenthèses + capturantes, $regs contiendra exactement 10 éléments, + même si il y avait plus ou moins de 10 parenthèses capturantes + qui étaient valides. Cela n'a aucun effet sur les capacités de + la fonction ereg à trouver d'autres sous chaînes. + Si aucune valeur n'est trouvée, $regs ne sera pas modifié par + ereg. + + + La recherche est sensible à la casse. + + + ereg retourne TRUE si une occurrence + a été trouvée dans la chaîne et + FALSE dans le cas contraire, ou si une erreur est survenue. + + + L'exemple suivant prend une date au format ISO (YYYY-MM-DD) et l'affiche sous + la forme DD.MM.YYYY : + + Exemple <function>ereg</function> + <?php if ( ereg( "([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})", $date, $regs ) ) { echo "$regs[3].$regs[2].$regs[1]"; @@ -130,81 +130,81 @@ echo "Format de date invalide : $date"; } ?> - - - - - Voir aussi eregi, ereg_replace - et eregi_replace. - - - - - - ereg_replace - Remplacement par expression régulière. - - - Description - - - string ereg_replace - string pattern - string replacement - string string - - - - ereg_replace effectue une recherche par expression - régulière dans la chaîne - string en recherchant les occurrences de - pattern, puis les remplace par la chaîne - replacement. - - - La chaîne modifiée est retournée. (Ce qui - signifie que la chaîne originale sera retournée si - aucune occurrence n'est trouvée). - - - Si pattern contient des parenthèses - capturantes, replacement pourra contenir des - séquences de la forme \\digit, - qui seront remplacées par le texte capturé par la n-ième - parenthèse capturante. \\0 correspond - à la chaîne originale complète. De 0 à - 9 parenthèses capturantes peuvent être utilisées. - Les parenthèses peuvent être imbriquées, et leur - numéro d'ordre est défini par leur parenthèse - ouvrante. - - - Si aucune occurrence n'est trouvée, la chaîne - string sera retournée intacte. - - - Par exemple, le code suivant affiche "Ceci etait un test" trois fois : - - Exemple avec <function>ereg_replace</function> - + + + + + Voir aussi eregi, ereg_replace + et eregi_replace. + + + + + + ereg_replace + Remplacement par expression régulière. + + + Description + + + string ereg_replace + string pattern + string replacement + string string + + + + ereg_replace effectue une recherche par expression + régulière dans la chaîne + string en recherchant les occurrences de + pattern, puis les remplace par la chaîne + replacement. + + + La chaîne modifiée est retournée. (Ce qui + signifie que la chaîne originale sera retournée si + aucune occurrence n'est trouvée). + + + Si pattern contient des parenthèses + capturantes, replacement pourra contenir des + séquences de la forme \\digit, + qui seront remplacées par le texte capturé par la n-ième + parenthèse capturante. \\0 correspond + à la chaîne originale complète. De 0 à + 9 parenthèses capturantes peuvent être utilisées. + Les parenthèses peuvent être imbriquées, et leur + numéro d'ordre est défini par leur parenthèse + ouvrante. + + + Si aucune occurrence n'est trouvée, la chaîne + string sera retournée intacte. + + + Par exemple, le code suivant affiche "Ceci etait un test" trois fois : + + Exemple avec <function>ereg_replace</function> + <?php $string = "Ceci est un test"; echo ereg_replace( " est", " etait", $string ); echo ereg_replace( "( )est ", "\\1etait", $string ); echo ereg_replace( "(( )est)", "\\2etait", $string ); ?> - - - - - Notez bien que si vous utilisez une valeur de type entier - dans le paramètre de remplacement replacement, - vous risquez de ne pas obtenir le résultat escompté. Tout cela - parce que ereg_replace va interpréter le nombre - comme la valeur ordinale d'un caractère, et l'utiliser. Par exemple : - - Exemple avec <function>ereg_replace</function> - + + + + + Notez bien que si vous utilisez une valeur de type entier + dans le paramètre de remplacement replacement, + vous risquez de ne pas obtenir le résultat escompté. Tout cela + parce que ereg_replace va interpréter le nombre + comme la valeur ordinale d'un caractère, et l'utiliser. Par exemple : + + Exemple avec <function>ereg_replace</function> + <?php /* Cet exemple ne fonctionne pas comme voulu. */ $num = 4; @@ -217,224 +217,224 @@ $string = ereg_replace('quatre', $num, $string); echo $string; /* Affichage : 'Cette chaîne a 4 mots.' */ ?> - - - - - Voir aussi ereg, eregi - et eregi_replace. - - - - - - eregi - - Recherche par expression régulière insensible à la casse. - - - - Description - - - int eregi - string pattern - string string - array - regs - - - - - eregi est identique à ereg, - hormis le fait qu'elle ignore la casse des caractère lors - de la recherche sur les caractère alphabétiques. - - - Voir aussi ereg, ereg_replace et - eregi_replace. - - - - - - eregi_replace - - Remplacement par expression régulière insensible à - la casse. - - - - Description - - - string eregi_replace - string pattern - string replacement - string string - - - - eregi_replace est identique à - ereg_replace, hormis le fait qu'elle ne tient - pas compte de la casse des caractères alphabétiques. - - - Voir aussi ereg, eregi - et ereg_replace. - - - - - - split - - Scinde une chaîne en un tableau, grâce à une - expression régulière. - - - - Description - - array split + + + + + Voir aussi ereg, eregi + et eregi_replace. + + + + + + eregi + + Recherche par expression régulière insensible à la casse. + + + + Description + + + int eregi + string pattern + string string + array + regs + + + + + eregi est identique à ereg, + hormis le fait qu'elle ignore la casse des caractère lors + de la recherche sur les caractère alphabétiques. + + + Voir aussi ereg, ereg_replace et + eregi_replace. + + + + + + eregi_replace + + Remplacement par expression régulière insensible à + la casse. + + + + Description + + + string eregi_replace string pattern + string replacement string string - int limit - - - split retourne une tableau de chaînes : - chacune d'entre elle est une sous-chaîne de - string délimitée par les - occurrences trouvées de l'expression régulière - pattern. Si une erreur survient, retourne - FALSE. - - - Pour lire les 5 premiers champs d'une ligne du fichier - /etc/passwd: - - Exemple avec <function>split</function> - + + + + eregi_replace est identique à + ereg_replace, hormis le fait qu'elle ne tient + pas compte de la casse des caractères alphabétiques. + + + Voir aussi ereg, eregi + et ereg_replace. + + + + + + split + + Scinde une chaîne en un tableau, grâce à une + expression régulière. + + + + Description + + array split + string pattern + string string + int limit + + + split retourne une tableau de chaînes : + chacune d'entre elle est une sous-chaîne de + string délimitée par les + occurrences trouvées de l'expression régulière + pattern. Si une erreur survient, retourne + FALSE. + + + Pour lire les 5 premiers champs d'une ligne du fichier + /etc/passwd: + + Exemple avec <function>split</function> + <?php $passwd_list = split( ":", $passwd_line, 5 ); ?> - - - - - Pour analyser une date qui est délimitée par des /, - des points ou des tirets : - - Exemple avec <function>split</function> - + + + + + Pour analyser une date qui est délimitée par des /, + des points ou des tirets : + + Exemple avec <function>split</function> + <?php $date = "04/30/1973"; // Les délimiteurs peuvent être des /, des points ou des tirets list( $month, $day, $year ) = split( '[/.-]', $date ); echo "Mois: $month; Jour: $day; Annee: $year<br>\n"; ?> - - - - - Notez que patternest insensible à la casse - - - Notez bien que si vous n'avez pas besoin de la puissance - des expressions régulières, il est plus rapide - d'utiliser explode, qui n'utilise pas le - moteur d'expressions régulières. - - - Notez aussi que pattern est une - expression régulière. Si vous voulez utiliser - n'importe quel caractère spécial des expressions - régulières, vous devez les échapper. Si vous - pensez que split (ou toute autre expression - régulière) se comporte bizarrement, lisez d'abord - le fichier regex.7, inclus dans le dossier - regex/ de la distribution PHP . Il est au - format manpage, et vous pourrez le lire avec une commande telle que - man /usr/local/src/regex/regex.7. - - - Voir aussi : explode et implode. - - - - - - spliti - - Scinde une chaîne en un tableau, grâce à une - expression régulière. - - - - Description - - - array spliti - string pattern - string string - int - limit - - - - - spliti est identique à split, - hormis le fait qu'elle ignore la casse. - - - Voir aussi split, - explode et - implode. - - - - - - sql_regcase - - Prépare une expression régulière pour effectuer - une recherche insensible à la casse. - - - - Description - - string sql_regcase + + + + + Notez que patternest insensible à la casse + + + Notez bien que si vous n'avez pas besoin de la puissance + des expressions régulières, il est plus rapide + d'utiliser explode, qui n'utilise pas le + moteur d'expressions régulières. + + + Notez aussi que pattern est une + expression régulière. Si vous voulez utiliser + n'importe quel caractère spécial des expressions + régulières, vous devez les échapper. Si vous + pensez que split (ou toute autre expression + régulière) se comporte bizarrement, lisez d'abord + le fichier regex.7, inclus dans le dossier + regex/ de la distribution PHP . Il est au + format manpage, et vous pourrez le lire avec une commande telle que + man /usr/local/src/regex/regex.7. + + + Voir aussi : explode et implode. + + + + + + spliti + + Scinde une chaîne en un tableau, grâce à une + expression régulière. + + + + Description + + + array spliti + string pattern string string - - - sql_regcase retourne une expression régulière - valide qui acceptera la chaîne string, - et toutes les variantes majuscule/minuscule possibles de cette - chaîne. Cette expression sera construite à partir de - la chaîne string en remplacant tous les - caractères par des expressions entre crochets (des classes de - caractères), contenant la lettre majuscule et minuscule. Si le - caractère n'est pas une lettre, les crochets contiendront - deux fois le caractère original. - - Exemple avec <function>sql_regcase</function> - + int + limit + + + + + spliti est identique à split, + hormis le fait qu'elle ignore la casse. + + + Voir aussi split, + explode et + implode. + + + + + + sql_regcase + + Prépare une expression régulière pour effectuer + une recherche insensible à la casse. + + + + Description + + string sql_regcase + string string + + + sql_regcase retourne une expression régulière + valide qui acceptera la chaîne string, + et toutes les variantes majuscule/minuscule possibles de cette + chaîne. Cette expression sera construite à partir de + la chaîne string en remplacant tous les + caractères par des expressions entre crochets (des classes de + caractères), contenant la lettre majuscule et minuscule. Si le + caractère n'est pas une lettre, les crochets contiendront + deux fois le caractère original. + + Exemple avec <function>sql_regcase</function> + <?php echo sql_regcase( "Foo bar" ); ?> - - - affichera [Ff][Oo][Oo] [Bb][Aa][Rr]. - - - Cette expression sert à effectuer des recherches - insensibles à la casse avec d'autres logiciels, qui - n'acceptent les recherches insensibles à la casse. - - - - + + + affichera [Ff][Oo][Oo] [Bb][Aa][Rr]. + + + Cette expression sert à effectuer des recherches + insensibles à la casse avec d'autres logiciels, qui + n'acceptent les recherches insensibles à la casse. + + + +