cvs: phpdoc-fr /reference/pcre configure.xml constants.xml reference.xml /reference/pcre/functions pcre.pattern.syntax.xml preg-grep.xml
preg-match-all.xml preg-match.xml preg-replace-callback.xml
| From: | Damien Seguy | Date: | Wed, 29 Jan 2003 11:44:40 +0000 |
| Subject: | cvs: phpdoc-fr /reference/pcre configure.xml constants.xml reference.xml /reference/pcre/functions pcre.pattern.syntax.xml preg-grep.xml preg-match-all.xml preg-match.xml preg-replace-callback.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-173@lists.php.net to get a copy of this message | ||
dams Wed Jan 29 06:44:40 2003 EDT
Added files:
/phpdoc-fr/reference/pcre configure.xml constants.xml
Modified files:
/phpdoc-fr/reference/pcre reference.xml
/phpdoc-fr/reference/pcre/functions pcre.pattern.syntax.xml
preg-grep.xml
preg-match-all.xml
preg-match.xml
preg-replace-callback.xml
Log:
correcting typo in syntax
Index: phpdoc-fr/reference/pcre/reference.xml diff -u phpdoc-fr/reference/pcre/reference.xml:1.2 phpdoc-fr/reference/pcre/reference.xml:1.3 --- phpdoc-fr/reference/pcre/reference.xml:1.2 Mon Apr 15 20:54:44 2002 +++ phpdoc-fr/reference/pcre/reference.xml Wed Jan 29 06:44:39 2003 @@ -1,10 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <reference id="ref.pcre"> <title>Expressions régulières compatibles Perl</title> <titleabbrev>PCRE</titleabbrev> <partintro> - <para> + <section id="pcre.intro"> + &reftitle.intro; + <para> La syntaxe des masques utilisés dans ces fonctions ressemble fort à celle de Perl. Les expressions seront entourées de délimiteurs, slash (/), par exemple. N'importe quel @@ -20,8 +22,36 @@ affecteront la recherche. Voir aussi <link linkend="pcre.pattern.modifiers">options de recherche</link>. </para> - <para> - <example> + </section> + + <section id="pcre.requirements"> + &reftitle.required; + <para> + Le support des expressions régulières est assuré + par la librairie PCRE, qui est open source, et écrite par Philip + Hazel. Elle est soumise au copyright de l'University of Cambridge, + Angleterre. Elle est disponible à <ulink url="&url.pcre;">&url.pcre;</ulink>. + </para> + </section> + + &reference.pcre.configure; + + <section id="pcre.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="pcre.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.pcre.constants; + + <section id="pcre.examples"> + &reftitle.examples; + <para> + <example> <title>Exemples de masques valides</title> <itemizedlist> <listitem> @@ -69,19 +99,8 @@ </itemizedlist> </example> </para> - <note> - <simpara> - Les expressions régulières Perl sont disponibles - depuis la PHP 4 et PHP 3.0.9. - </simpara> - <simpara> - Le support des expressions régulières est assuré - par la librairie PCRE, qui est open source, et écrite par Philip - Hazel. Elle est soumise au copyright de l'University of Cambridge, - Angleterre. Elle est disponible à <ulink url="&url.pcre;">&url.pcre;</ulink>. - </simpara> - </note> - </partintro> + </section> + </partintro> &reference.pcre.functions; Index: phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml diff -u phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml:1.2 phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml:1.3 --- phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml:1.2 Wed Nov 6 08:10:33 2002 +++ phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml Wed Jan 29 06:44:39 2003 @@ -199,7 +199,7 @@ A l'extérieur des crochets, les méta caractères sont : <variablelist> <varlistentry> - <term><emphasis>/</emphasis> antislash</term> + <term><emphasis>\</emphasis> antislash</term> <listitem> <simpara> Caractère d'échappement, avec de multiples usages @@ -356,7 +356,7 @@ méta-caractères. </para> </refsect2> - <refsect2 id="regexp.reference.antislash"> + <refsect2 id="regexp.reference.backslash"> <title>Antislash</title> <para> Le caractère antislash a de nombreuses utilisations. @@ -964,7 +964,7 @@ que si le masque principal réussi aussi. </para> </refsect2> - <refsect2 id="regexp.reference.internal_options"> + <refsect2 id="regexp.reference.internal-options"> <title>Options internes</title> <para> Les options <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link>, @@ -1118,7 +1118,7 @@ les masques ci-dessus accepteront aussi bien "DIMANCHE" que "Dimanche". </para> </refsect2> - <refsect2 id="regexp.reference.repetitions"> + <refsect2 id="regexp.reference.repetition"> <title>Répétitions</title> <para> Les répétitions sont spécifiées avec @@ -1303,7 +1303,7 @@ la deuxième valeur capturée est "<literal>b</literal>". </para> </refsect2> - <refsect2 id="regexp.reference.back_references"> + <refsect2 id="regexp.reference.back-references"> <title>Références arrières </title> <para> En dehors des classes de caractères, un antislash suivi Index: phpdoc-fr/reference/pcre/functions/preg-grep.xml diff -u phpdoc-fr/reference/pcre/functions/preg-grep.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-grep.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-grep.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-grep.xml Wed Jan 29 06:44:39 2003 @@ -4,7 +4,7 @@ <refentry id="function.preg-grep"> <refnamediv> <refname>preg_grep</refname> - <refpurpose>Retourne un tableau avec les résultat de la recherche.</refpurpose> + <refpurpose>Retourne un tableau avec les résultat de la recherche</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.2 phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.3 --- phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.2 Mon Oct 14 18:38:26 2002 +++ phpdoc-fr/reference/pcre/functions/preg-match-all.xml Wed Jan 29 06:44:39 2003 @@ -4,7 +4,7 @@ <refentry id="function.preg-match-all"> <refnamediv> <refname>preg_match_all</refname> - <refpurpose>Expression régulière globale.</refpurpose> + <refpurpose>Expression régulière globale</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,7 +13,7 @@ <methodparam><type>string</type><parameter>pattern</parameter></methodparam> <methodparam><type>string</type><parameter>subject</parameter></methodparam> <methodparam><type>array</type><parameter>matches</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>order</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>preg_match_all</function> analyse <parameter>subject</parameter> @@ -26,10 +26,13 @@ la recherche continue jusqu'à la fin de la chaîne. </para> <para> - <parameter>order</parameter> peut prendre une des deux valeurs suivantes : + <parameter>order</parameter> peut prendre une des deux valeurs suivantes + (notez bien qu'il est incohérent d'utiliser + <constant>PREG_PATTERN_ORDER</constant> avec + <constant>PREG_SET_ORDER</constant> ) : <variablelist> <varlistentry> - <term>PREG_PATTERN_ORDER</term> + <term><constant>PREG_PATTERN_ORDER</constant></term> <listitem> <para> L'ordre est tel que $matches[0] est un tableau qui @@ -41,9 +44,12 @@ <programlisting role="php"> <![CDATA[ <?php - preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); - print $out[0][0].", ".$out[0][1]."\n"; - print $out[1][0].", ".$out[1][1]."\n"; + preg_match_all("|<[^>]+>(.*)</[^>]+>|U", + "<b>exemple : </b><div align=left>un test</div>", + $out, + PREG_PATTERN_ORDER); + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; ?> ]]> @@ -55,8 +61,8 @@ <literallayout> <computeroutput> <![CDATA[ -<b>exemple: </b>, <div align=left>ceci est un test</div> -exemple: , ceci est un test +<b>exemple : </b>, <div align=left>un test</div> +exemple : , un test ]]> </computeroutput> </literallayout> @@ -68,7 +74,7 @@ </listitem> </varlistentry> <varlistentry> - <term>PREG_SET_ORDER</term> + <term><constant>PREG_SET_ORDER</constant></term> <listitem> <para> Les résultats sont classés de telle @@ -80,11 +86,11 @@ <![CDATA[ <?php preg_match_all("|<[^>]+>(.*)</[^>]+>|U", - "<b>exemple: </b><div align=left>un test</div>", + "<b>exemple : </b><div align=left>un test</div>", $out, PREG_SET_ORDER); - print $out[0][0].", ".$out[0][1]."\n"; - print $out[1][0].", ".$out[1][1]."\n"; + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; ?> ]]> @@ -95,7 +101,7 @@ <literallayout> <computeroutput> <![CDATA[ -<b>exemple: </b>, exemple: +<b>exemple : </b>, exemple : <div align=left>un test</div>, un test ]]> </computeroutput> @@ -107,6 +113,19 @@ première parenthèse capturante, etc... De même, $matches[1] contient le texte qui satisfait le masque complet, etc... </para> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>PREG_OFFSET_CAPTURE</constant></term> + <listitem> + <simpara> + Si cette option est activée, toutes les sous chaînes qui satisfont + le masque seront aussi identifiées par leur offset. Notez que cela + modifie le format de la valeur retournée , puisque chaque élément + de réponse devient un tableau contenant la sous-chaîne résultat, + à l'index <literal>0</literal> dans la chaîne <parameter>subject</parameter> + constant <literal>1</literal>. Cette option a été ajoutée en &php; 4.3.0 . + </simpara> </listitem> </varlistentry> </variablelist> Index: phpdoc-fr/reference/pcre/functions/preg-match.xml diff -u phpdoc-fr/reference/pcre/functions/preg-match.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-match.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-match.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-match.xml Wed Jan 29 06:44:39 2003 @@ -4,7 +4,7 @@ <refentry id="function.preg-match"> <refnamediv> <refname>preg_match</refname> - <refpurpose>Expression régulière standard.</refpurpose> + <refpurpose>Expression régulière standard</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,6 +13,7 @@ <methodparam><type>string</type><parameter>pattern</parameter></methodparam> <methodparam><type>string</type><parameter>subject</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>matches</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>preg_match</function> analyse <parameter>subject</parameter> @@ -26,26 +27,53 @@ etc.. </para> <para> - <function>preg_match</function> retourne &true; si la - recherche réussit, et &false; sinon (notamment - en cas d'erreur). + Le paramètre <parameter>flags</parameter> peut prendre l'une des valeurs + suivantes : + <variablelist> + <varlistentry> + <term><constant>PREG_OFFSET_CAPTURE</constant></term> + <listitem> + <simpara> + Si cette option est activée, toutes les sous chaînes qui satisfont + le masque seront aussi identifiées par leur offset. Notez que cela + modifie le format de la valeur retournée , puisque chaque élément + de réponse devient un tableau contenant la sous-chaîne résultat, + à l'index <literal>0</literal> dans la chaîne <parameter>subject</parameter> + constant <literal>1</literal>. Cette option a été ajoutée en &php; 4.3.0 . + </simpara> + </listitem> + </varlistentry> + </variablelist> + Le paramètre <parameter>flags</parameter> a été ajouté en + &php; 4.3.0 . + </para> + <para> + <function>preg_match</function> retourne le nombre de fois où le + masque <parameter>pattern</parameter> a été trouvé. Cela peut aller de + 0 (pas de solutioon) à un 1 car <function>preg_match</function> s'arrête + dès qu'il a trouvé une première solution. <function>preg_match_all</function>, + au contraire, va continue jusqu'à la fin de la chaîne <parameter>subject</parameter>. + <function>preg_match</function> retourne &false; si une erreur survient. </para> <para> <example> <title>Extraction d'un numéro de page d'une chaîne.</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (preg_match("/page\s+#(\d+)/i", "Aller à la page numéro 9.", $parts)) print "La page suivante est $parts[1]"; else print "Page introuvable."; -?> +?> +]]> </programlisting> </example> <example> <title>Trouve le mot "web"</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // \b, dans le masque, indique une limite de mot, de façon à ce que le mot // "web" uniquement soit repéré, et pas seulement des parties de mots comme // dans "webbing" ou "cobweb" @@ -59,26 +87,31 @@ } else { print "Un mot n'a pas été trouvé."; } -?> +?> +]]> </programlisting> </example> <example> <title>Lire un nom de domaine dans une URL</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // repérer le nom de l'hôte dans l'URL -preg_match("/^(http:\/\/)?([^\/]+)/i", -"http://www.php.net/index.html", $matches); -$host = $matches[2]; + preg_match("/^(http:\/\/)?([^\/]+)/i", + "http://www.php.net/index.html", $matches); + $host = $matches[2]; // repérer les deux derniers segments du nom de l'hôte -preg_match("/[^\.\/]+\.[^\.\/]+$/",$host,$matches); -echo "Le nom de domaine est : ".$matches[0]."\n"; -?> + preg_match("/[^\.\/]+\.[^\.\/]+$/",$host,$matches); + echo "Le nom de domaine est : ".$matches[0]."\n"; +?> +]]> </programlisting> </example> Cet exemple va afficher : <computeroutput> +<![CDATA[ Le nom de domaine est : php.net +]]> </computeroutput> Voir aussi <function>preg_match_all</function>, Index: phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml diff -u phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml Wed Jan 29 06:44:39 2003 @@ -4,14 +4,14 @@ <refentry id="function.preg-replace-callback"> <refnamediv> <refname>preg_replace_callback</refname> - <refpurpose>Rechercher/remplacer avec fonction de callback</refpurpose> + <refpurpose>Rechercher/remplacer avec une expression régulière et fonction de callback</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>preg_replace_callback</methodname> <methodparam><type>mixed</type><parameter>pattern</parameter></methodparam> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> + <methodparam><type>callback</type><parameter>callback</parameter></methodparam> <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> </methodsynopsis> @@ -22,10 +22,6 @@ spécifier une fonction de callback <parameter>callback</parameter> qui sera appelée, avec les éléments trouvés en arguments. Cette fonction retourne alors la chaîne de remplacement. - </para> - <para> - <function>preg_replace_callback</function> a été ajoutée - en PHP 4.0.5. </para> <para> Voir aussi <function>preg_replace</function>. Index: phpdoc-fr/reference/pcre/configure.xml +++ phpdoc-fr/reference/pcre/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="pcre.installation"> &reftitle.install; <para> A partir de &php; 4.2.0, ces fonctions activées par défaut. Pour les anciennes versions, vous devez configurer et compiler &php; avec l'option <option role="configure">--with-pcre-regex[=DIR]</option> afin de pouvoir les utiliser. Vous pouvez aussi désactiver le support des expressions régulières avec l'option <option role="configure">--without-pcre-regex</option>. </para> &windows.builtin; </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/pcre/constants.xml +++ phpdoc-fr/reference/pcre/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="pcre.constants"> &reftitle.constants; &extension.constants; <table> <title>Constantes PREG</title> <tgroup cols="2"> <thead> <row> <entry>Constante</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>PREG_PATTERN_ORDER</entry> <entry> Ordonne les résultats de façon à ce que $matches[0] contienne les résultats qui correspondent au masque entier, $matches[1] contienne les résultats qui correspondent à la première parenthèse capturante, $matches[2] contienne les résultats qui correspondent à la deuxième parenthèse capturante, etc... Cette constante est utilisée avec <function>preg_match_all</function>. </entry> </row> <row> <entry>PREG_SET_ORDER</entry> <entry> Les résultats sont classés de telle façon que $matches[0] contient la première série de résultat, $matches[1] contient la deuxième série de résultat, etc... Cette constante est utilisée avec <function>preg_match_all</function>. </entry> </row> <row> <entry>PREG_OFFSET_CAPTURE</entry> <entry> Voir la description de <constant>PREG_SPLIT_OFFSET_CAPTURE</constant>. Cette constante est utilisée depuis &php; 4.3.0 . </entry> </row> <row> <entry>PREG_SPLIT_NO_EMPTY</entry> <entry> Si cette option est activée, seules les sous-chaînes non vides seront retournées par <function>preg_split</function>. </entry> </row> <row> <entry>PREG_SPLIT_DELIM_CAPTURE</entry> <entry> Si cette option est activée, les expressions entre parenthèses entre les délimiteurs de masques seront aussi capturées et retournées. Cette option a été ajoutée en &php; 4.0.5. Cette constante est utilisée avec <function>preg_split</function>. </entry> </row> <row> <entry>PREG_SPLIT_OFFSET_CAPTURE</entry> <entry> Si cette constante est utilisée avec <function>preg_split</function>, l'offset de début de résultat sera retourné, en plus de la chaîne résultat. Notez que cela change la nature du résultat retourné en un tableau contenant une chaîne à l'offset &zero; et une chaîne contenant un offset à l'offset &one;. Cette option est disponible depuis &php; 4.3.0. </entry> </row> </tbody> </tgroup> </table> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-fr/reference/pcre/reference.xml diff -u phpdoc-fr/reference/pcre/reference.xml:1.2 phpdoc-fr/reference/pcre/reference.xml:1.3 --- phpdoc-fr/reference/pcre/reference.xml:1.2 Mon Apr 15 20:54:44 2002 +++ phpdoc-fr/reference/pcre/reference.xml Wed Jan 29 06:44:39 2003 @@ -1,10 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <reference id="ref.pcre"> <title>Expressions régulières compatibles Perl</title> <titleabbrev>PCRE</titleabbrev> <partintro> - <para> + <section id="pcre.intro"> + &reftitle.intro; + <para> La syntaxe des masques utilisés dans ces fonctions ressemble fort à celle de Perl. Les expressions seront entourées de délimiteurs, slash (/), par exemple. N'importe quel @@ -20,8 +22,36 @@ affecteront la recherche. Voir aussi <link linkend="pcre.pattern.modifiers">options de recherche</link>. </para> - <para> - <example> + </section> + + <section id="pcre.requirements"> + &reftitle.required; + <para> + Le support des expressions régulières est assuré + par la librairie PCRE, qui est open source, et écrite par Philip + Hazel. Elle est soumise au copyright de l'University of Cambridge, + Angleterre. Elle est disponible à <ulink url="&url.pcre;">&url.pcre;</ulink>. + </para> + </section> + + &reference.pcre.configure; + + <section id="pcre.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="pcre.resources"> + &reftitle.resources; + &no.resource; + </section> + + &reference.pcre.constants; + + <section id="pcre.examples"> + &reftitle.examples; + <para> + <example> <title>Exemples de masques valides</title> <itemizedlist> <listitem> @@ -69,19 +99,8 @@ </itemizedlist> </example> </para> - <note> - <simpara> - Les expressions régulières Perl sont disponibles - depuis la PHP 4 et PHP 3.0.9. - </simpara> - <simpara> - Le support des expressions régulières est assuré - par la librairie PCRE, qui est open source, et écrite par Philip - Hazel. Elle est soumise au copyright de l'University of Cambridge, - Angleterre. Elle est disponible à <ulink url="&url.pcre;">&url.pcre;</ulink>. - </simpara> - </note> - </partintro> + </section> + </partintro> &reference.pcre.functions; Index: phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml diff -u phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml:1.2 phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml:1.3 --- phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml:1.2 Wed Nov 6 08:10:33 2002 +++ phpdoc-fr/reference/pcre/functions/pcre.pattern.syntax.xml Wed Jan 29 06:44:39 2003 @@ -199,7 +199,7 @@ A l'extérieur des crochets, les méta caractères sont : <variablelist> <varlistentry> - <term><emphasis>/</emphasis> antislash</term> + <term><emphasis>\</emphasis> antislash</term> <listitem> <simpara> Caractère d'échappement, avec de multiples usages @@ -356,7 +356,7 @@ méta-caractères. </para> </refsect2> - <refsect2 id="regexp.reference.antislash"> + <refsect2 id="regexp.reference.backslash"> <title>Antislash</title> <para> Le caractère antislash a de nombreuses utilisations. @@ -964,7 +964,7 @@ que si le masque principal réussi aussi. </para> </refsect2> - <refsect2 id="regexp.reference.internal_options"> + <refsect2 id="regexp.reference.internal-options"> <title>Options internes</title> <para> Les options <link linkend="pcre.pattern.modifiers">PCRE_CASELESS</link>, @@ -1118,7 +1118,7 @@ les masques ci-dessus accepteront aussi bien "DIMANCHE" que "Dimanche". </para> </refsect2> - <refsect2 id="regexp.reference.repetitions"> + <refsect2 id="regexp.reference.repetition"> <title>Répétitions</title> <para> Les répétitions sont spécifiées avec @@ -1303,7 +1303,7 @@ la deuxième valeur capturée est "<literal>b</literal>". </para> </refsect2> - <refsect2 id="regexp.reference.back_references"> + <refsect2 id="regexp.reference.back-references"> <title>Références arrières </title> <para> En dehors des classes de caractères, un antislash suivi Index: phpdoc-fr/reference/pcre/functions/preg-grep.xml diff -u phpdoc-fr/reference/pcre/functions/preg-grep.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-grep.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-grep.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-grep.xml Wed Jan 29 06:44:39 2003 @@ -4,7 +4,7 @@ <refentry id="function.preg-grep"> <refnamediv> <refname>preg_grep</refname> - <refpurpose>Retourne un tableau avec les résultat de la recherche.</refpurpose> + <refpurpose>Retourne un tableau avec les résultat de la recherche</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/pcre/functions/preg-match-all.xml diff -u phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.2 phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.3 --- phpdoc-fr/reference/pcre/functions/preg-match-all.xml:1.2 Mon Oct 14 18:38:26 2002 +++ phpdoc-fr/reference/pcre/functions/preg-match-all.xml Wed Jan 29 06:44:39 2003 @@ -4,7 +4,7 @@ <refentry id="function.preg-match-all"> <refnamediv> <refname>preg_match_all</refname> - <refpurpose>Expression régulière globale.</refpurpose> + <refpurpose>Expression régulière globale</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,7 +13,7 @@ <methodparam><type>string</type><parameter>pattern</parameter></methodparam> <methodparam><type>string</type><parameter>subject</parameter></methodparam> <methodparam><type>array</type><parameter>matches</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>order</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>preg_match_all</function> analyse <parameter>subject</parameter> @@ -26,10 +26,13 @@ la recherche continue jusqu'à la fin de la chaîne. </para> <para> - <parameter>order</parameter> peut prendre une des deux valeurs suivantes : + <parameter>order</parameter> peut prendre une des deux valeurs suivantes + (notez bien qu'il est incohérent d'utiliser + <constant>PREG_PATTERN_ORDER</constant> avec + <constant>PREG_SET_ORDER</constant> ) : <variablelist> <varlistentry> - <term>PREG_PATTERN_ORDER</term> + <term><constant>PREG_PATTERN_ORDER</constant></term> <listitem> <para> L'ordre est tel que $matches[0] est un tableau qui @@ -41,9 +44,12 @@ <programlisting role="php"> <![CDATA[ <?php - preg_match_all("|<[^>]+>(.*)</[^>]+>|U", "<b>example: </b><div align=left>a test</div>", $out, PREG_PATTERN_ORDER); - print $out[0][0].", ".$out[0][1]."\n"; - print $out[1][0].", ".$out[1][1]."\n"; + preg_match_all("|<[^>]+>(.*)</[^>]+>|U", + "<b>exemple : </b><div align=left>un test</div>", + $out, + PREG_PATTERN_ORDER); + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; ?> ]]> @@ -55,8 +61,8 @@ <literallayout> <computeroutput> <![CDATA[ -<b>exemple: </b>, <div align=left>ceci est un test</div> -exemple: , ceci est un test +<b>exemple : </b>, <div align=left>un test</div> +exemple : , un test ]]> </computeroutput> </literallayout> @@ -68,7 +74,7 @@ </listitem> </varlistentry> <varlistentry> - <term>PREG_SET_ORDER</term> + <term><constant>PREG_SET_ORDER</constant></term> <listitem> <para> Les résultats sont classés de telle @@ -80,11 +86,11 @@ <![CDATA[ <?php preg_match_all("|<[^>]+>(.*)</[^>]+>|U", - "<b>exemple: </b><div align=left>un test</div>", + "<b>exemple : </b><div align=left>un test</div>", $out, PREG_SET_ORDER); - print $out[0][0].", ".$out[0][1]."\n"; - print $out[1][0].", ".$out[1][1]."\n"; + print $out[0][0].", ".$out[0][1]."\n"; + print $out[1][0].", ".$out[1][1]."\n"; ?> ]]> @@ -95,7 +101,7 @@ <literallayout> <computeroutput> <![CDATA[ -<b>exemple: </b>, exemple: +<b>exemple : </b>, exemple : <div align=left>un test</div>, un test ]]> </computeroutput> @@ -107,6 +113,19 @@ première parenthèse capturante, etc... De même, $matches[1] contient le texte qui satisfait le masque complet, etc... </para> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>PREG_OFFSET_CAPTURE</constant></term> + <listitem> + <simpara> + Si cette option est activée, toutes les sous chaînes qui satisfont + le masque seront aussi identifiées par leur offset. Notez que cela + modifie le format de la valeur retournée , puisque chaque élément + de réponse devient un tableau contenant la sous-chaîne résultat, + à l'index <literal>0</literal> dans la chaîne <parameter>subject</parameter> + constant <literal>1</literal>. Cette option a été ajoutée en &php; 4.3.0 . + </simpara> </listitem> </varlistentry> </variablelist> Index: phpdoc-fr/reference/pcre/functions/preg-match.xml diff -u phpdoc-fr/reference/pcre/functions/preg-match.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-match.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-match.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-match.xml Wed Jan 29 06:44:39 2003 @@ -4,7 +4,7 @@ <refentry id="function.preg-match"> <refnamediv> <refname>preg_match</refname> - <refpurpose>Expression régulière standard.</refpurpose> + <refpurpose>Expression régulière standard</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,6 +13,7 @@ <methodparam><type>string</type><parameter>pattern</parameter></methodparam> <methodparam><type>string</type><parameter>subject</parameter></methodparam> <methodparam choice="opt"><type>array</type><parameter>matches</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> </methodsynopsis> <para> <function>preg_match</function> analyse <parameter>subject</parameter> @@ -26,26 +27,53 @@ etc.. </para> <para> - <function>preg_match</function> retourne &true; si la - recherche réussit, et &false; sinon (notamment - en cas d'erreur). + Le paramètre <parameter>flags</parameter> peut prendre l'une des valeurs + suivantes : + <variablelist> + <varlistentry> + <term><constant>PREG_OFFSET_CAPTURE</constant></term> + <listitem> + <simpara> + Si cette option est activée, toutes les sous chaînes qui satisfont + le masque seront aussi identifiées par leur offset. Notez que cela + modifie le format de la valeur retournée , puisque chaque élément + de réponse devient un tableau contenant la sous-chaîne résultat, + à l'index <literal>0</literal> dans la chaîne <parameter>subject</parameter> + constant <literal>1</literal>. Cette option a été ajoutée en &php; 4.3.0 . + </simpara> + </listitem> + </varlistentry> + </variablelist> + Le paramètre <parameter>flags</parameter> a été ajouté en + &php; 4.3.0 . + </para> + <para> + <function>preg_match</function> retourne le nombre de fois où le + masque <parameter>pattern</parameter> a été trouvé. Cela peut aller de + 0 (pas de solutioon) à un 1 car <function>preg_match</function> s'arrête + dès qu'il a trouvé une première solution. <function>preg_match_all</function>, + au contraire, va continue jusqu'à la fin de la chaîne <parameter>subject</parameter>. + <function>preg_match</function> retourne &false; si une erreur survient. </para> <para> <example> <title>Extraction d'un numéro de page d'une chaîne.</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (preg_match("/page\s+#(\d+)/i", "Aller à la page numéro 9.", $parts)) print "La page suivante est $parts[1]"; else print "Page introuvable."; -?> +?> +]]> </programlisting> </example> <example> <title>Trouve le mot "web"</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // \b, dans le masque, indique une limite de mot, de façon à ce que le mot // "web" uniquement soit repéré, et pas seulement des parties de mots comme // dans "webbing" ou "cobweb" @@ -59,26 +87,31 @@ } else { print "Un mot n'a pas été trouvé."; } -?> +?> +]]> </programlisting> </example> <example> <title>Lire un nom de domaine dans une URL</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // repérer le nom de l'hôte dans l'URL -preg_match("/^(http:\/\/)?([^\/]+)/i", -"http://www.php.net/index.html", $matches); -$host = $matches[2]; + preg_match("/^(http:\/\/)?([^\/]+)/i", + "http://www.php.net/index.html", $matches); + $host = $matches[2]; // repérer les deux derniers segments du nom de l'hôte -preg_match("/[^\.\/]+\.[^\.\/]+$/",$host,$matches); -echo "Le nom de domaine est : ".$matches[0]."\n"; -?> + preg_match("/[^\.\/]+\.[^\.\/]+$/",$host,$matches); + echo "Le nom de domaine est : ".$matches[0]."\n"; +?> +]]> </programlisting> </example> Cet exemple va afficher : <computeroutput> +<![CDATA[ Le nom de domaine est : php.net +]]> </computeroutput> Voir aussi <function>preg_match_all</function>, Index: phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml diff -u phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml:1.1 phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml:1.2 --- phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml:1.1 Sun Apr 14 20:36:28 2002 +++ phpdoc-fr/reference/pcre/functions/preg-replace-callback.xml Wed Jan 29 06:44:39 2003 @@ -4,14 +4,14 @@ <refentry id="function.preg-replace-callback"> <refnamediv> <refname>preg_replace_callback</refname> - <refpurpose>Rechercher/remplacer avec fonction de callback</refpurpose> + <refpurpose>Rechercher/remplacer avec une expression régulière et fonction de callback</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>mixed</type><methodname>preg_replace_callback</methodname> <methodparam><type>mixed</type><parameter>pattern</parameter></methodparam> - <methodparam><type>mixed</type><parameter>callback</parameter></methodparam> + <methodparam><type>callback</type><parameter>callback</parameter></methodparam> <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>limit</parameter></methodparam> </methodsynopsis> @@ -22,10 +22,6 @@ spécifier une fonction de callback <parameter>callback</parameter> qui sera appelée, avec les éléments trouvés en arguments. Cette fonction retourne alors la chaîne de remplacement. - </para> - <para> - <function>preg_replace_callback</function> a été ajoutée - en PHP 4.0.5. </para> <para> Voir aussi <function>preg_replace</function>. Index: phpdoc-fr/reference/pcre/configure.xml +++ phpdoc-fr/reference/pcre/configure.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="pcre.installation"> &reftitle.install; <para> A partir de &php; 4.2.0, ces fonctions activées par défaut. Pour les anciennes versions, vous devez configurer et compiler &php; avec l'option <option role="configure">--with-pcre-regex[=DIR]</option> afin de pouvoir les utiliser. Vous pouvez aussi désactiver le support des expressions régulières avec l'option <option role="configure">--without-pcre-regex</option>. </para> &windows.builtin; </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> Index: phpdoc-fr/reference/pcre/constants.xml +++ phpdoc-fr/reference/pcre/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <section id="pcre.constants"> &reftitle.constants; &extension.constants; <table> <title>Constantes PREG</title> <tgroup cols="2"> <thead> <row> <entry>Constante</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>PREG_PATTERN_ORDER</entry> <entry> Ordonne les résultats de façon à ce que $matches[0] contienne les résultats qui correspondent au masque entier, $matches[1] contienne les résultats qui correspondent à la première parenthèse capturante, $matches[2] contienne les résultats qui correspondent à la deuxième parenthèse capturante, etc... Cette constante est utilisée avec <function>preg_match_all</function>. </entry> </row> <row> <entry>PREG_SET_ORDER</entry> <entry> Les résultats sont classés de telle façon que $matches[0] contient la première série de résultat, $matches[1] contient la deuxième série de résultat, etc... Cette constante est utilisée avec <function>preg_match_all</function>. </entry> </row> <row> <entry>PREG_OFFSET_CAPTURE</entry> <entry> Voir la description de <constant>PREG_SPLIT_OFFSET_CAPTURE</constant>. Cette constante est utilisée depuis &php; 4.3.0 . </entry> </row> <row> <entry>PREG_SPLIT_NO_EMPTY</entry> <entry> Si cette option est activée, seules les sous-chaînes non vides seront retournées par <function>preg_split</function>. </entry> </row> <row> <entry>PREG_SPLIT_DELIM_CAPTURE</entry> <entry> Si cette option est activée, les expressions entre parenthèses entre les délimiteurs de masques seront aussi capturées et retournées. Cette option a été ajoutée en &php; 4.0.5. Cette constante est utilisée avec <function>preg_split</function>. </entry> </row> <row> <entry>PREG_SPLIT_OFFSET_CAPTURE</entry> <entry> Si cette constante est utilisée avec <function>preg_split</function>, l'offset de début de résultat sera retourné, en plus de la chaîne résultat. Notez que cela change la nature du résultat retourné en un tableau contenant une chaîne à l'offset &zero; et une chaîne contenant un offset à l'offset &one;. Cette option est disponible depuis &php; 4.3.0. </entry> </row> </tbody> </tgroup> </table> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->