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: 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&eacute;guli&egrave;res compatibles Perl</title> <titleabbrev>PCRE</titleabbrev> <partintro> - <para> + <section id="pcre.intro"> + &reftitle.intro; + <para> La syntaxe des masques utilis&eacute;s dans ces fonctions ressemble fort &agrave; celle de Perl. Les expressions seront entour&eacute;es de d&eacute;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&eacute;guli&egrave;res est assur&eacute; + par la librairie PCRE, qui est open source, et &eacute;crite par Philip + Hazel. Elle est soumise au copyright de l'University of Cambridge, + Angleterre. Elle est disponible &agrave; <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&eacute;guli&egrave;res Perl sont disponibles - depuis la PHP 4 et PHP 3.0.9. - </simpara> - <simpara> - Le support des expressions r&eacute;guli&egrave;res est assur&eacute; - par la librairie PCRE, qui est open source, et &eacute;crite par Philip - Hazel. Elle est soumise au copyright de l'University of Cambridge, - Angleterre. Elle est disponible &agrave; <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&eacute;rieur des crochets, les m&eacute;ta caract&egrave;res sont : <variablelist> <varlistentry> - <term><emphasis>/</emphasis> antislash</term> + <term><emphasis>&#92;</emphasis> antislash</term> <listitem> <simpara> Caract&egrave;re d'&eacute;chappement, avec de multiples usages @@ -356,7 +356,7 @@ m&eacute;ta-caract&egrave;res. </para> </refsect2> - <refsect2 id="regexp.reference.antislash"> + <refsect2 id="regexp.reference.backslash"> <title>Antislash</title> <para> Le caract&egrave;re antislash a de nombreuses utilisations. @@ -964,7 +964,7 @@ que si le masque principal r&eacute;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&eacute;p&eacute;titions</title> <para> Les r&eacute;p&eacute;titions sont sp&eacute;cifi&eacute;es avec @@ -1303,7 +1303,7 @@ la deuxi&egrave;me valeur captur&eacute;e est "<literal>b</literal>". </para> </refsect2> - <refsect2 id="regexp.reference.back_references"> + <refsect2 id="regexp.reference.back-references"> <title>R&eacute;f&eacute;rences arri&egrave;res </title> <para> En dehors des classes de caract&egrave;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&eacute;sultat de la recherche.</refpurpose> + <refpurpose>Retourne un tableau avec les r&eacute;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&eacute;guli&egrave;re globale.</refpurpose> + <refpurpose>Expression r&eacute;guli&egrave;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'&agrave; la fin de la cha&icirc;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&eacute;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]."&#92;n"; - print $out[1][0].", ".$out[1][1]."&#92;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&eacute;sultats sont class&eacute;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]."&#92;n"; - print $out[1][0].", ".$out[1][1]."&#92;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&egrave;re parenth&egrave;se capturante, etc... De m&ecirc;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&eacute;e, toutes les sous cha&icirc;nes qui satisfont + le masque seront aussi identifi&eacute;es par leur offset. Notez que cela + modifie le format de la valeur retourn&eacute;e , puisque chaque &eacute;l&eacute;ment + de r&eacute;ponse devient un tableau contenant la sous-cha&icirc;ne r&eacute;sultat, + &agrave; l'index <literal>0</literal> dans la cha&icirc;ne <parameter>subject</parameter> + constant <literal>1</literal>. Cette option a &eacute;t&eacute; ajout&eacute;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&eacute;guli&egrave;re standard.</refpurpose> + <refpurpose>Expression r&eacute;guli&egrave;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&eacute;ussit, et &false; sinon (notamment - en cas d'erreur). + Le param&egrave;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&eacute;e, toutes les sous cha&icirc;nes qui satisfont + le masque seront aussi identifi&eacute;es par leur offset. Notez que cela + modifie le format de la valeur retourn&eacute;e , puisque chaque &eacute;l&eacute;ment + de r&eacute;ponse devient un tableau contenant la sous-cha&icirc;ne r&eacute;sultat, + &agrave; l'index <literal>0</literal> dans la cha&icirc;ne <parameter>subject</parameter> + constant <literal>1</literal>. Cette option a &eacute;t&eacute; ajout&eacute;e en &php; 4.3.0 . + </simpara> + </listitem> + </varlistentry> + </variablelist> + Le param&egrave;tre <parameter>flags</parameter> a &eacute;t&eacute; ajout&eacute; en + &php; 4.3.0 . + </para> + <para> + <function>preg_match</function> retourne le nombre de fois o&ugrave; le + masque <parameter>pattern</parameter> a &eacute;t&eacute; trouv&eacute;. Cela peut aller de + 0 (pas de solutioon) &agrave; un 1 car <function>preg_match</function> s'arr&ecirc;te + d&egrave;s qu'il a trouv&eacute; une premi&egrave;re solution. <function>preg_match_all</function>, + au contraire, va continue jusqu'&agrave; la fin de la cha&icirc;ne <parameter>subject</parameter>. + <function>preg_match</function> retourne &false; si une erreur survient. </para> <para> <example> <title>Extraction d'un num&eacute;ro de page d'une cha&icirc;ne.</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php if (preg_match("/page&#92;s+#(&#92;d+)/i", "Aller &agrave; la page num&eacute;ro 9.", $parts)) print "La page suivante est $parts[1]"; else print "Page introuvable."; -?&gt; +?> +]]> </programlisting> </example> <example> <title>Trouve le mot "web"</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // &#92;b, dans le masque, indique une limite de mot, de fa&ccedil;on &agrave; ce que le mot // "web" uniquement soit rep&eacute;r&eacute;, et pas seulement des parties de mots comme // dans "webbing" ou "cobweb" @@ -59,26 +87,31 @@ } else { print "Un mot n'a pas &eacute;t&eacute; trouv&eacute;."; } -?&gt; +?> +]]> </programlisting> </example> <example> <title>Lire un nom de domaine dans une URL</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php // rep&eacute;rer le nom de l'h&ocirc;te dans l'URL -preg_match("/^(http:&#92;/&#92;/)?([^&#92;/]+)/i", -"http://www.php.net/index.html", $matches); -$host = $matches[2]; + preg_match("/^(http:&#92;/&#92;/)?([^&#92;/]+)/i", + "http://www.php.net/index.html", $matches); + $host = $matches[2]; // rep&eacute;rer les deux derniers segments du nom de l'h&ocirc;te -preg_match("/[^&#92;.&#92;/]+&#92;.[^&#92;.&#92;/]+$/",$host,$matches); -echo "Le nom de domaine est : ".$matches[0]."&#92;n"; -?&gt; + preg_match("/[^&#92;.&#92;/]+&#92;.[^&#92;.&#92;/]+$/",$host,$matches); + echo "Le nom de domaine est : ".$matches[0]."&#92;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&eacute;guli&egrave;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&eacute;cifier une fonction de callback <parameter>callback</parameter> qui sera appel&eacute;e, avec les &eacute;l&eacute;ments trouv&eacute;s en arguments. Cette fonction retourne alors la cha&icirc;ne de remplacement. - </para> - <para> - <function>preg_replace_callback</function> a &eacute;t&eacute; ajout&eacute;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&eacute;es par d&eacute;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&eacute;sactiver le support des expressions r&eacute;guli&egrave;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&eacute;sultats de fa&ccedil;on &agrave; ce que $matches[0] contienne les r&eacute;sultats qui correspondent au masque entier, $matches[1] contienne les r&eacute;sultats qui correspondent &agrave; la premi&egrave;re parenth&egrave;se capturante, $matches[2] contienne les r&eacute;sultats qui correspondent &agrave; la deuxi&egrave;me parenth&egrave;se capturante, etc... Cette constante est utilis&eacute;e avec <function>preg_match_all</function>. </entry> </row> <row> <entry>PREG_SET_ORDER</entry> <entry> Les r&eacute;sultats sont class&eacute;s de telle fa&ccedil;on que $matches[0] contient la premi&egrave;re s&eacute;rie de r&eacute;sultat, $matches[1] contient la deuxi&egrave;me s&eacute;rie de r&eacute;sultat, etc... Cette constante est utilis&eacute;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&eacute;e depuis &php; 4.3.0 . </entry> </row> <row> <entry>PREG_SPLIT_NO_EMPTY</entry> <entry> Si cette option est activ&eacute;e, seules les sous-cha&icirc;nes non vides seront retourn&eacute;es par <function>preg_split</function>. </entry> </row> <row> <entry>PREG_SPLIT_DELIM_CAPTURE</entry> <entry> Si cette option est activ&eacute;e, les expressions entre parenth&egrave;ses entre les d&eacute;limiteurs de masques seront aussi captur&eacute;es et retourn&eacute;es. Cette option a &eacute;t&eacute; ajout&eacute;e en &php; 4.0.5. Cette constante est utilis&eacute;e avec <function>preg_split</function>. </entry> </row> <row> <entry>PREG_SPLIT_OFFSET_CAPTURE</entry> <entry> Si cette constante est utilis&eacute;e avec <function>preg_split</function>, l'offset de d&eacute;but de r&eacute;sultat sera retourn&eacute;, en plus de la cha&icirc;ne r&eacute;sultat. Notez que cela change la nature du r&eacute;sultat retourn&eacute; en un tableau contenant une cha&icirc;ne &agrave; l'offset &zero; et une cha&icirc;ne contenant un offset &agrave; 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 -->
« previous php.doc.fr (#173) next »