cvs: phpdoc /fr/functions pcre.xml

From: Date: Wed, 31 Jan 2001 07:57:50 +0000
Subject: cvs: phpdoc /fr/functions pcre.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969334072@lists.php.net to get a copy of this message
dams Tue Jan 30 23:57:50 2001 EDT Modified files: /phpdoc/fr/functions pcre.xml Log: preg_grep's update

Index: phpdoc/fr/functions/pcre.xml diff -u phpdoc/fr/functions/pcre.xml:1.12 phpdoc/fr/functions/pcre.xml:1.13 --- phpdoc/fr/functions/pcre.xml:1.12 Tue Jan 30 01:06:54 2001 +++ phpdoc/fr/functions/pcre.xml Tue Jan 30 23:57:49 2001 @@ -22,7 +22,7 @@ <example> <title>Exemples de masques valides</title> <itemizedlist> - <listitem><simpara>/<\/\w+>/</simpara></listitem> + <listitem><simpara>/&tl;\/\w+>/</simpara></listitem> <listitem><simpara>|(\d{3})-\d+|Sm</simpara></listitem> <listitem><simpara>/^(?i)php[34]/</simpara></listitem> <listitem><simpara>{^\s+(\s+)?$}</simpara></listitem> @@ -87,15 +87,16 @@ etc.. </para> <para> - Retourne <literal>TRUE</literal> si la recherche &agrave; r&eacute;ussie, et - <literal>FALSE</literal> sinon (notamment en cas d'erreur). + <function>preg_match</function> retourne <literal>TRUE</literal> si la + recherche r&eacute;ussit, et <literal>FALSE</literal> sinon (notamment + en cas d'erreur). </para> <para> <example> <title>Extraction d'un num&eacute;ro de page d'une cha&icirc;ne.</title> <programlisting role="php"> &lt;?php -if (preg_match("/page\s+#(\d+)/i", "Go to page #9.", $parts)) +if (preg_match("/page\s+#(\d+)/i", "Aller &agrave; la page num&eacute;ro 9.", $parts)) print "La page suivante est $parts[1]"; else print "Page introuvable."; @@ -188,7 +189,7 @@ <informalexample> <programlisting role="php"> &lt;?php -preg_match_all("|&lt;[^>]+>(.*)&lt;/[^>]+>|U", "&lt;b>example: &lt;/b>&lt;div align=left>a test&lt;/div>", $out, PREG_PATTERN_ORDER); +preg_match_all("|&lt;[^&gt;]+&gt;(.*)&lt;/[^&gt;]+&gt;|U", "&lt;b&gt;example: &lt;/b&gt;&lt;div align=left&gt;a test&lt;/div&gt;", $out, PREG_PATTERN_ORDER); print $out[0][0].", ".$out[0][1]."\n"; print $out[1][0].", ".$out[1][1]."\n"; ?&gt; @@ -197,13 +198,13 @@ Cet exemple va afficher : <informalexample> <computeroutput> -&lt;b>exemple: &lt/b>, &lt;div align=left>ceci est un test&lt;/div> +&lt;b&gt;exemple: &lt/b&gt;, &lt;div align=left&gt;ceci est un test&lt;/div&gt; exemple: , ceci est un test </computeroutput> </informalexample> - Ainsi, $out[0] est un tableau qui contient les - r&eacute;sultats qui satisfont le masque complet, - et $out[1] est un tableau qui contient les balises entre &gt; et &lt;. + Ainsi, $out[0] est un tableau qui contient les r&eacute;sultats qui + satisfont le masque complet, et $out[1] est un tableau qui contient + les balises entre &gt; et &lt;. </para> </listitem> </varlistentry> @@ -215,27 +216,27 @@ 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... - <informalexample> - <programlisting role="php"> + <informalexample> + <programlisting role="php"> &lt;?php -preg_match_all("|&lt;[^>]+>(.*)&lt;/[^>]+>|U", "&lt;b>exemple: &lt;/b>&lt;div align=left>un test&lt;/div>", $out, PREG_SET_ORDER); +preg_match_all("|&lt;[^&gt;]+&gt;(.*)&lt;/[^&gt;]+&gt;|U", "&lt;b&gt;exemple: &lt;/b&gt;&lt;div align=left&gt;un test&lt;/div&gt;", $out, PREG_SET_ORDER); print $out[0][0].", ".$out[0][1]."\n"; print $out[1][0].", ".$out[1][1]."\n"; ?&gt; - </programlisting> - </informalexample> - Cet exemple va afficher : - <informalexample> - <computeroutput> -&lt;b>exemple: &lt;/b>, exemple: -&lt;div align=left>un test&lt;/div>, un test - </computeroutput> - </informalexample> - Dans ce cas, $matches[0] est la premi&egrave;re s&eacute;rie de - r&eacute;sultat, et $matches[0][0] contient le texte qui satisfait - le masque complet, $matches[0][1] contient le texte de la - premi&egrave;re parenth&egrave;se capturante, etc... De m&ecirc;me, - $matches[1] contient le texte qui satisfait le masque complet, etc. + </programlisting> + </informalexample> + Cet exemple va afficher : + <informalexample> + <computeroutput> +&lt;b&gt;exemple: &lt;/b&gt;, exemple: +&lt;div align=left&gt;un test&lt;/div&gt;, un test + </computeroutput> + </informalexample> + Dans ce cas, $matches[0] est la premi&egrave;re s&eacute;rie de + r&eacute;sultat, et $matches[0][0] contient le texte qui satisfait + le masque complet, $matches[0][1] contient le texte de la + 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> @@ -303,7 +304,9 @@ <refentry id="function.preg-replace"> <refnamediv> <refname>preg_replace</refname> - <refpurpose>Rechercher et remplacer par expression r&eacute;guli&egrave;re standard.</refpurpose> + <refpurpose> + Rechercher et remplacer par expression r&eacute;guli&egrave;re standard. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -324,18 +327,18 @@ r&eacute;sultats par <parameter>replacement</parameter>. </para> <para> - <parameter>replacement</parameter> peut contenir des - r&eacute;f&eacute;rences de la forme - <literal>\\<replaceable>n</replaceable></literal> ou (depuis PHP 4.0.4) - <literal><replaceable>$n</replaceable></literal>. Cette derni&egrave;re forme - est recommand&eacute;e. Ces r&eacute;f&eacute;rences seront remplac&eacute;es - par le texte captur&eacute; par la <replaceable>n</replaceable>'-i&egrave;me - parenth&egrave;se capturante du masque. <replaceable>n</replaceable> - peut prendre des valeurs de 0 &agrave; 99, et <literal>\\0</literal> - ou <literal>$0</literal>, correspondent au texte de qui satisfait le masque - complet. Les parenth&egrave;ses ouvrantes sont compt&eacute;es de gauche - &agrave; droit (en commencant &agrave; 1) pour d&eacute;terminer - le num&eacute;ro de parenth&egrave;se capturante. + <parameter>replacement</parameter> peut contenir des r&eacute;f&eacute;rences + de la forme <literal>\\<replaceable>n</replaceable></literal> ou, + depuis PHP 4.0.4) <literal><replaceable>$n</replaceable></literal>. + Cette derni&egrave;re forme est recommand&eacute;e. Ces + r&eacute;f&eacute;rences seront remplac&eacute;es par le texte captur&eacute; + par la <replaceable>n</replaceable>'-i&egrave;me parenth&egrave;se capturante + du masque. <replaceable>n</replaceable> peut prendre des valeurs de 0 &agrave; + 99, et <literal>\\0</literal> ou <literal>$0</literal>, correspondent + au texte de qui satisfait le masque complet. Les parenth&egrave;ses + ouvrantes sont compt&eacute;es de gauche &agrave; droite (en commencant + &agrave; 1) pour d&eacute;terminer le num&eacute;ro de parenth&egrave;se + capturante. </para> <para> Si la recherche n'aboutit &agrave; aucun r&eacute;sultat, @@ -397,7 +400,7 @@ <title>Utilisation de l'option /e </title> <programlisting role="php"> &lt;?php -preg_replace("/(<\/?)(\w+)([^>]*>)/e", "'\\1'.strtoupper('\\2').'\\3'", $html_body); +preg_replace("/(<\/?)(\w+)([^>]*&gt;/e", "'\\1'.strtoupper('\\2').'\\3'", $html_body); ?&gt; </programlisting> </example> @@ -450,8 +453,7 @@ </para> </note> <para> - Voir aussi <function>preg_match</function>, - <function>preg_match_all</function> + Voir aussi <function>preg_match</function>, <function>preg_match_all</function> et <function>preg_split</function>. </para> </refsect1> @@ -521,8 +523,7 @@ ?&gt; </programlisting> <para> - Voir aussi <function>preg_match</function>, - <function>preg_match_all</function> + Voir aussi <function>preg_match</function>, <function>preg_match_all</function> et <function>preg_replace</function>. </para> </refsect1> @@ -531,7 +532,8 @@ <refnamediv> <refname>preg_quote</refname> <refpurpose> - Echappement des caract&egrave;res sp&eacute;ciaux des expressions r&eacute;guli&egrave;res. + Echappement des caract&egrave;res sp&eacute;ciaux des expressions + r&eacute;guli&egrave;res. </refpurpose> </refnamediv> <refsect1> @@ -610,6 +612,13 @@ qui satisfont le masque <parameter>pattern</parameter>. </para> <para> + Depuis PHP 4.0.4, le tableau retourn&eacute; par <function>preg_grep</function> + est index&eacute; en utilisant les cl&eacute;s issues du tableau + <parameter>input</parameter>. Si ces cl&eacute;s sont inutiles, utilisez + la fonction <function>array_values</function> sur le tableau retourn&eacute; + par <function>preg_grep</function> pour obtenir le comportement traditionnel. + </para> + <para> <example> <title>Exemple avec <function>preg_grep</function></title> <programlisting role="php"> @@ -715,7 +724,7 @@ substitution normale des r&eacute;f&eacute;rences arri&egrave;res dans la cha&icirc;ne de remplacement, puis l'&eacute;value comme un code PHP, et utilise le r&eacute;sultat pour remplacer la cha&icirc;ne de recherche. - Cette optoin ne peut pas &ecirc;tre utilis&eacute;e avec <literal>/F modifier</literal>. + Cette optoin ne peut pas &ecirc;tre utilis&eacute;e avec <literal>/F</literal>. </simpara> <simpara> Seule <function>preg_replace</function> utilise cette option. Elle est @@ -727,15 +736,17 @@ <term><emphasis>F</emphasis></term> <listitem> <simpara> - Avec cette option, <function>preg_replace</function> consid&egrave;re le param&egrave;tre - de remplacement comme un nom de fonction, qui doit &ecirc;tre appel&eacute; pour fournir - la cha&icirc;ne de remplacement. La fonction recoit un tableau d'&eacute;l&eacute;ments trouv&eacute;s. - Cette option ne peut pas &ecirc;tre utilis&eacute;e avec l'option <literal>/e</literal>. + Avec cette option, <function>preg_replace</function> consid&egrave;re + le param&egrave;tre de remplacement comme un nom de fonction, qui doit + &ecirc;tre appel&eacute; pour fournir la cha&icirc;ne de remplacement. + La fonction recoit un tableau d'&eacute;l&eacute;ments trouv&eacute;s. + Cette option ne peut pas &ecirc;tre utilis&eacute;e avec l'option + <literal>/e</literal>. </simpara> <simpara> <function>preg_replace</function> seuelement utilise cette option. - Elle est ignor&eacute;e par les autres fonctions PCRE. Cette option a &eacute;t&eacute; ajout&eacute;e - en PHP 4.0.4. + Elle est ignor&eacute;e par les autres fonctions PCRE. Cette option a + &eacute;t&eacute; ajout&eacute;e en PHP 4.0.4. </simpara> </listitem> </varlistentry> @@ -1054,7 +1065,7 @@ "\0\x\07", sera comprise comme deux caract&egrave;res nuls, suivi d'un caract&egrave;re alarme (BEL). Assurez vous que vous fournissez suffisamment de chiffres apr&egrave;s le m&eacute;ta-caract&egrave;re. - La gestion de la s&eacute;quence "\y", avec y &lt;> 0 est plutot compliqu&eacute;e. En dehors + La gestion de la s&eacute;quence "\y", avec y &lt;&gt; 0 est plutot compliqu&eacute;e. En dehors des caract&egrave;res de classes, PCRE va lire y et tous les caract&egrave;res qui suivent comme des chiffres d&eacute;cimaux. Si y est plus petit que 10, ou bien si il y a d&eacute;j&agrave; eu au moins autant de parenth&egrave;ses ouvrantes auparavant, la s&eacute;quence est prise @@ -1518,8 +1529,8 @@ d'&ecirc;tre r&eacute;&eacute;valu&eacute;e &agrave; chaque tentative. Ceci conduirait &agrave; ce que la recherche &eacute;choue imm&eacute;diatement apr&egrave;s le premier test. Ces assertions ont leur propre notation, - commencant avec (?>comme ceci : -(?>\d+)bar + commencant avec (?&gt;comme ceci : +(?&gt;\d+)bar Apr&egrave;s avoir tent&eacute; d'utiliser les 6 chiffres suivi de "foo" qui fait &eacute;chouer, l'action habituelle sera de r&eacute;essayer avec 5 chiffres, puis avec 4, et ainsi de suite jusqu'&agrave; l'&eacute;chec @@ -1528,7 +1539,7 @@ n'a pas besoin d'&ecirc;tre r&eacute;&eacute;valu&eacute;e &agrave; chaque tentative. Ceci conduirait &agrave; ce que la recherche &eacute;choue imm&eacute;diatement apr&egrave;s le premier test. Ces assertions ont leur - propre notation, commencant avec (?>comme ceci : (?&gt;\d+)bar. + propre notation, commencant avec (?&gt; comme ceci : (?&gt;\d+)bar. Ce type de parenth&egrave;ses verrouille le sous-masque qu'il contient un fois qu'il a &eacute;t&eacute; trouv&eacute;, et emp&ecirc;che un &eacute;chec ult&eacute;rieur d'y repasser, mais autorise &agrave; revenir
« previous php.doc (#969334072) next »