cvs: phpdoc-fr /reference/strings reference.xml /reference/strings/functions crc32.xml echo.xml get-html-translation-table.xml htmlentities.xml
htmlspecialchars.xml md5-file.xml md5.xml nl2br.xml parse-str.xml print.xml setlocale.xml str-replace.xml strpos.xml

From: Date: Sat, 26 Apr 2003 19:25:30 +0000
Subject: cvs: phpdoc-fr /reference/strings reference.xml /reference/strings/functions crc32.xml echo.xml get-html-translation-table.xml htmlentities.xml
htmlspecialchars.xml md5-file.xml md5.xml nl2br.xml parse-str.xml print.xml setlocale.xml str-replace.xml strpos.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-303@lists.php.net to get a copy of this message
dams Sat Apr 26 15:25:30 2003 EDT Modified files: /phpdoc-fr/reference/strings reference.xml /phpdoc-fr/reference/strings/functions crc32.xml echo.xml get-html-translation-table.xml htmlentities.xml htmlspecialchars.xml md5-file.xml md5.xml nl2br.xml parse-str.xml print.xml setlocale.xml str-replace.xml strpos.xml Log: Spring cleaning

Index: phpdoc-fr/reference/strings/reference.xml diff -u phpdoc-fr/reference/strings/reference.xml:1.4 phpdoc-fr/reference/strings/reference.xml:1.5 --- phpdoc-fr/reference/strings/reference.xml:1.4 Wed Oct 9 21:17:16 2002 +++ phpdoc-fr/reference/strings/reference.xml Sat Apr 26 15:25:29 2003 @@ -1,30 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <reference id="ref.strings"> <title>Cha&icirc;nes de caract&egrave;res (Strings)</title> <titleabbrev>Cha&icirc;nes</titleabbrev> <partintro> <simpara> + </simpara> + <para> + du manuel. + </para> + + <section id="strings.intro"> + &reftitle.intro; + <para> Ces fonctions permettent de manipuler des cha&icirc;nes de caract&egrave;res de diff&eacute;rentes fa&ccedil;ons. Certaines fonctionnalit&eacute;s plus sp&eacute;cialis&eacute;es sont disponibles dans les sections d'expression - r&eacute;guli&egrave;res et de gestion des URL. - </simpara> - <para> + r&eacute;guli&egrave;res et de <link linkend="ref.url">gestion des URL</link>. + + These functions all manipulate strings in various ways. Some more + specialized sections can be found in the regular expression and + <link linkend="ref.url">URL handling</link> sections. + </para> + <para> Pour plus de d&eacute;tails sur le comportement des cha&icirc;nes de caract&egrave;res, notamment avec les guillemets simples et doubles, les s&eacute;quences d'&eacute;chappement, reportez-vous &agrave; la section <link linkend="language.types.string">Cha&icirc;nes de caract&egrave;res</link> - dans la section <link linkend="language.types">Types</link> - du manuel. - </para> - <para> + dans la section <link linkend="language.types">Types</link>. + </para> + </section> + + + <section id="strings.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section id="strings.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.strings.constants; + + <section id="strings.seealso"> + &reftitle.seealso; + <para> Pour des fonctions encore plus puissantes de gestion et manipulation des cha&icirc;nes, reportez-vous aux <link linkend="ref.regex">expressions r&eacute;guli&egrave;res POSIX</link> et <link linkend="ref.pcre">expressions r&eacute;guli&egrave;res Perl</link>. - </para> + </para> + </section> + </partintro> &reference.strings.functions; Index: phpdoc-fr/reference/strings/functions/crc32.xml diff -u phpdoc-fr/reference/strings/functions/crc32.xml:1.5 phpdoc-fr/reference/strings/functions/crc32.xml:1.6 --- phpdoc-fr/reference/strings/functions/crc32.xml:1.5 Wed Mar 26 11:17:23 2003 +++ phpdoc-fr/reference/strings/functions/crc32.xml Sat Apr 26 15:25:30 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.37 --> <refentry id="function.crc32"> <refnamediv> <refname>crc32</refname> - <refpurpose>Calcule la somme de v&eacute;rification CRC32</refpurpose> + <refpurpose>Calcule la somme de contr&ocirc;le CRC32</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -13,15 +13,41 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> - <methodname>crc32</methodname> g&eacute;n&egrave;re la somme de v&eacute;rification - cyclique CRC 32, calcul&eacute;e sur 32 bits de long, appliqu&eacute;s &agrave; la - cha&icirc;ne <parameter>str</parameter>. Cette fonction g&eacute;n&eacute;ralement utilis&eacute;e - pour valider l'int&eacute;grit&eacute;e de donn&eacute;es durant une transmission. + <function>crc32</function> g&eacute;n&egrave;re la somme de contr&ocirc;le + cyclique CRC 32, calcul&eacute;e sur 32 bits, et appliqu&eacute;s &agrave; + la cha&icirc;ne <parameter>str</parameter>. Cette fonction est + g&eacute;n&eacute;ralement utilis&eacute;e pour valider + l'int&eacute;grit&eacute;e de donn&eacute;es durant une transmission. </para> <para> - Voir aussi - <function>md5</function> + <note> + <para> + Comme le type d'entier de &php; est sign&eacute;, et que de nombreuses + sommes de contr&ocirc;le CRC32 aboutissent &agrave; un nombre n&eacute;gatif, vous + devez utiliser le format "%u" de la fonction <function>sprintf</function> ou + <function>printf</function> pour obtenir la repr&eacute;sentation + litt&eacute;rale de la somme de contr&ocirc;le CRC32. + </para> + </note> + Ce second illustre comment afficher la somme de contr&ocirc;le + avec la focntion <function>printf</function> : + <example> + <title>Displaying a crc32 checksum</title> + <programlisting role="php"> +<![CDATA[ +<?php + $checksum = crc32("Le vif z&eacute;phyr jubile sur les kumquats du clown gracieux."); + printf("%u\n", $checksum); +?> +]]> + </programlisting> + </example> </para> + <para> + Voir aussi + <function>md5</function> et + <function>sha1</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/strings/functions/echo.xml diff -u phpdoc-fr/reference/strings/functions/echo.xml:1.5 phpdoc-fr/reference/strings/functions/echo.xml:1.6 --- phpdoc-fr/reference/strings/functions/echo.xml:1.5 Thu Feb 6 19:55:33 2003 +++ phpdoc-fr/reference/strings/functions/echo.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.echo"> <refnamediv> @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <methodname>echo</methodname> + <type>void</type><methodname>echo</methodname> <methodparam><type>string</type><parameter>arg1</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>argn...</parameter></methodparam> </methodsynopsis> @@ -25,7 +25,7 @@ dans un contexte de <link linkend="functions.variable-functions">fonction variable</link>. Dans ce cas, il faut utiliser <function>print</function> &agrave; la place. <example> - <title>Exemples <function>echo</function></title> + <title>Exemples avec <function>echo</function></title> <programlisting role="php"> <![CDATA[ <?php @@ -42,7 +42,7 @@ //Vous pouvez utiliser des variables avec echo $foo = "foobar"; $bar = "barbaz"; -echo "foo vaut &quot;$foo&quot;"; +echo "foo vaut \"$foo\""; // foo vaut "foobar" // Les guillemets simples &eacute;vitent le remplacement des variables @@ -78,13 +78,14 @@ <function>echo</function> dispose aussi d'une version courte, o&ugrave; vous pouvez faire suivre la balise PHP ouvrante d'un signe &eacute;gal (<literal>=</literal>). - <informalexample> + <example> + <title>Afficher sans l'aide de <function>echo</function></title> <programlisting role="php"> <![CDATA[ -I have <?=$foo?> foo. +J'ai <?=$foo?> fous. ]]> </programlisting> - </informalexample> + </example> </para> <note> <para> Index: phpdoc-fr/reference/strings/functions/get-html-translation-table.xml diff -u phpdoc-fr/reference/strings/functions/get-html-translation-table.xml:1.3 phpdoc-fr/reference/strings/functions/get-html-translation-table.xml:1.4 --- phpdoc-fr/reference/strings/functions/get-html-translation-table.xml:1.3 Mon Aug 12 22:59:47 2002 +++ phpdoc-fr/reference/strings/functions/get-html-translation-table.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.get-html-translation-table"> <refnamediv> @@ -13,7 +13,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <type>string</type><methodname>get_html_translation_table</methodname> + <type>array</type><methodname>get_html_translation_table</methodname> <methodparam><type>int</type><parameter>table</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter></methodparam> </methodsynopsis> Index: phpdoc-fr/reference/strings/functions/htmlentities.xml diff -u phpdoc-fr/reference/strings/functions/htmlentities.xml:1.4 phpdoc-fr/reference/strings/functions/htmlentities.xml:1.5 --- phpdoc-fr/reference/strings/functions/htmlentities.xml:1.4 Sun Apr 13 09:29:20 2003 +++ phpdoc-fr/reference/strings/functions/htmlentities.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.htmlentities"> <refnamediv> @@ -24,45 +24,55 @@ fonction prend un deuxi&egrave;me argument optionnel, qui indique comment doivent &ecirc;tre trait&eacute; les guillemets doubles et simples. Vous pouvez utiliser l'une des constantes suivantes : - <constant>ENT_COMPAT</constant>, la constante par d&eacute;faut, - va convertir les guillemets doubles, et ignorer les guillemets - simples; <constant>ENT_QUOTES</constant> va convertir les guillemets doubles - et les guillemets simples ; <constant>ENT_NOQUOTES</constant> - va ignorer les guillemets doubles et les guillemets simples. + <table> + <title>Constantes disponibles pour <parameter>quote_style</parameter></title> + <tgroup cols="2"> + <thead> + <row> + <entry>Nom</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>ENT_COMPAT</constant></entry> + <entry>Convertit les guillemets doubles, et ignore les guillemets simples</entry> + </row> + <row> + <entry><constant>ENT_QUOTES</constant></entry> + <entry>Convertit les guillemets doubles et les guillemets simples</entry> + </row> + <row> + <entry><constant>ENT_NOQUOTES</constant></entry> + <entry>Ignore les guillemets doubles et les guillemets simples</entry> + </row> + </tbody> + </tgroup> + </table> </para> <para> - Actuellement, le jeu de caract&egrave;res ISO-8859-1 est utilis&eacute; par - d&eacute;faut. Le support pour le second argument optionnel a &eacute;t&eacute; - ajout&eacute; en PHP 3.0.17 et PHP 4.0.3. + Le support du param&egrave;tre optionnel <parameter>quote</parameter> a &eacute;t&eacute; ajout&eacute; + en &php; 4.0.3. </para> <para> Comme <function>htmlspecialchars</function>, cette fonction prend un troisi&egrave;me argument optionnel qui d&eacute;finit le jeux de caract&egrave;res - utilis&eacute; durant la conversion. Le support de cet argumetn a &eacute;t&eacute; - ajout&eacute; en PHP 4.1.0. + utilis&eacute; durant la conversion. Le support de cet argument a &eacute;t&eacute; + ajout&eacute; en PHP 4.1.0. Actuellement, le jeu de caract&egrave;res + ISO-8859-1 est utilis&eacute; par d&eacute;faut. </para> + &reference.strings.charsets; <para> - Il n'y a pas de fonction inverse de cette fonction. Toutefois, vous - pouvez en cr&eacute;er une facilement. Voici comment faire : + Si vous voulez r&eacute;aliser l'op&eacute;ration inverse, vous devez utiliser + la fonction <function>html_entity_decode</function>. </para> - <example> - <title>Inverse de <function>htmlentities</function></title> - <programlisting role="php"> -<![CDATA[ -<?php - function unhtmlentities ($string){ - $trans_tbl = get_html_translation_table (HTML_ENTITIES); - $trans_tbl = array_flip ($trans_tbl); - return strtr ($string, $trans_tbl); - } -?> -]]> - </programlisting> - </example> <para> Voir aussi - <function>htmlspecialchars</function> et - <function>nl2br</function>. + <function>html_entity_decode</function>, + <function>get_html_translation_table</function>, + <function>htmlspecialchars</function>, + <function>nl2br</function> et + <function>urlencode</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/strings/functions/htmlspecialchars.xml diff -u phpdoc-fr/reference/strings/functions/htmlspecialchars.xml:1.4 phpdoc-fr/reference/strings/functions/htmlspecialchars.xml:1.5 --- phpdoc-fr/reference/strings/functions/htmlspecialchars.xml:1.4 Tue Jan 21 14:09:00 2003 +++ phpdoc-fr/reference/strings/functions/htmlspecialchars.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.htmlspecialchars"> <refnamediv> @@ -74,7 +74,9 @@ <programlisting role="php"> <![CDATA[ <?php - $new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); +$new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES); +echo $new; +// &lt;a href=&#039;test&#039;&gt;Test&lt;/a&gt; ?> ]]> </programlisting> @@ -92,9 +94,11 @@ utilis&eacute; durant la conversion. Le support de cet argument a &eacute;t&eacute; ajout&eacute; en PHP 4.1.0. </para> + &reference.strings.charsets; <para> Voir aussi - <function>htmlentities</function> et + <function>get_html_translation_table</function>, + <function>htmlentities</function> et <function>nl2br</function>. </para> </refsect1> Index: phpdoc-fr/reference/strings/functions/md5-file.xml diff -u phpdoc-fr/reference/strings/functions/md5-file.xml:1.2 phpdoc-fr/reference/strings/functions/md5-file.xml:1.3 --- phpdoc-fr/reference/strings/functions/md5-file.xml:1.2 Mon Aug 12 22:59:47 2002 +++ phpdoc-fr/reference/strings/functions/md5-file.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.md5-file"> <refnamediv> @@ -11,6 +11,7 @@ <methodsynopsis> <type>string</type><methodname>md5_file</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>raw_output</parameter></methodparam> </methodsynopsis> <para> <function>md5_file</function> calcule le MD5 du fichier @@ -18,16 +19,26 @@ <ulink url="&url.rfc;rfc1321.html">RSA Data Security, Inc. MD5 Message-Digest Algorithm</ulink>, puis retourne la valeur ainsi calcul&eacute;e. Le r&eacute;sultat est un nombre de 32 - caract&egrave;res hexad&eacute;cimaux. + caract&egrave;res hexad&eacute;cimaux. Si le param&egrave;tre + optionnel <parameter>raw_output</parameter> vaut &true;, + le digest MD5 est retourn&eacute;e au format binaire brut, avec + une taille de 16. </para> + <note> + <simpara> + Le param&egrave;tre optionnel <parameter>raw_output</parameter> a &eacute;t&eacute; ajout&eacute; + en &false; 5.0.0 et vaut par d&eacute;faut &false;. + </simpara> + </note> <para> <function>md5_file</function> a la m&ecirc;me utilit&eacute; que la commande en ligne md5sum. </para> <para> Voir aussi + <function>sha1_file</function>, <function>md5</function> et - <function>crc32</function> + <function>crc32</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/strings/functions/md5.xml diff -u phpdoc-fr/reference/strings/functions/md5.xml:1.3 phpdoc-fr/reference/strings/functions/md5.xml:1.4 --- phpdoc-fr/reference/strings/functions/md5.xml:1.3 Mon Aug 12 22:59:47 2002 +++ phpdoc-fr/reference/strings/functions/md5.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.135 --> <refentry id="function.md5"> <refnamediv> @@ -11,6 +11,7 @@ <methodsynopsis> <type>string</type><methodname>md5</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>raw_output</parameter></methodparam> </methodsynopsis> <para> <methodname>md5</methodname> calcule le MD5 de la @@ -19,10 +20,17 @@ MD5 Message-Digest Algorithm</ulink>, et retourne le r&eacute;sultat. Le r&eacute;sultat est un nombre de 32 caract&egrave;res hexad&eacute;cimaux. </para> + <note> + <simpara> + Le param&egrave;tre <parameter>raw_output</parameter> a &eacute;t&eacute; ajout&eacute; en + &php; 5.0.0 et vaut par d&eacute;faut &false;. + </simpara> + </note> <para> Voir aussi - <function>crc32</function> et - <function>md5_file</function> + <function>crc32</function>, + <function>md5_file</function> et + <function>sha1</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/strings/functions/nl2br.xml diff -u phpdoc-fr/reference/strings/functions/nl2br.xml:1.3 phpdoc-fr/reference/strings/functions/nl2br.xml:1.4 --- phpdoc-fr/reference/strings/functions/nl2br.xml:1.3 Mon Aug 12 22:59:47 2002 +++ phpdoc-fr/reference/strings/functions/nl2br.xml Sat Apr 26 15:25:30 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.nl2br"> <refnamediv> <refname>nl2br</refname> <refpurpose> - Ins&egrave;re des retours &agrave; la ligne HTML &agrave; chaque nouvelle ligne + Ins&egrave;re un retour &agrave; la ligne HTML &agrave; chaque nouvelle ligne </refpurpose> </refnamediv> <refsect1> @@ -15,8 +15,9 @@ <methodparam><type>string</type><parameter>string</parameter></methodparam> </methodsynopsis> <para> - <methodname>nl2br</methodname> retourne <parameter>string</parameter> - apr&agrave;s avoir ins&eacute;r&eacute; '&lt;br /&gt;' devant toutes les nouvelles lignes. + <function>nl2br</function> retourne <parameter>string</parameter> + apr&agrave;s avoir ins&eacute;r&eacute; '&lt;br /&gt;' + devant toutes les nouvelles lignes. </para> <note> <para> @@ -29,8 +30,9 @@ <para> Voir aussi <function>htmlspecialchars</function>, - <function>htmlentities</function> et - <function>wordwrap</function>. + <function>htmlentities</function>, + <function>wordwrap</function> et + <function>str_replace</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/strings/functions/parse-str.xml diff -u phpdoc-fr/reference/strings/functions/parse-str.xml:1.3 phpdoc-fr/reference/strings/functions/parse-str.xml:1.4 --- phpdoc-fr/reference/strings/functions/parse-str.xml:1.3 Mon Aug 12 22:59:47 2002 +++ phpdoc-fr/reference/strings/functions/parse-str.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.parse-str"> <refnamediv> @@ -11,8 +11,7 @@ <methodsynopsis> <type>void</type><methodname>parse_str</methodname> <methodparam><type>string</type><parameter>str</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>arr - </parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>arr</parameter></methodparam> </methodsynopsis> <para> <function>parse_str</function> analyse la cha&icirc;ne de caract&egrave;res @@ -29,17 +28,31 @@ ajout&eacute; en PHP 4.0.3. </para> </note> + <note> + <para> + Pour acc&eacute;der &agrave; l'URL appelante <emphasis>QUERY_STRING</emphasis>, vous devez + utiliser la variable + <link linkend="reserved.variables.server">$_SERVER['QUERY_STRING']</link>. + Il est auss int&eacute;ressant de lire la section sur les + <link linkend="language.variables.external">variables externes &agrave; &php;</link>. + </para> + </note> <para> <example> <title>Exemple avec <function>parse_str</function></title> <programlisting role="php"> <![CDATA[ <?php - $str = "premier=valeur&second[]=qui+fonctionne&second[]=autre"; - parse_str($str); - echo $premier; /* affiche "valeur" */ - echo $second[0]; /* affiche "qui fonctionne" */ - echo $second[1]; /* affiche "autre" */ +$str = "first=value&arr[]=foo+bar&arr[]=baz"; +parse_str($str); +echo $first; // value +echo $arr[0]; // foo bar +echo $arr[1]; // baz + +parse_str($str, $output); +echo $output['first']; // value +echo $output['arr'][0]; // foo bar +echo $output['arr'][1]; // baz ?> ]]> </programlisting> @@ -47,8 +60,10 @@ </para> <para> Voir aussi - <function>set_magic_quotes_runtime</function> - et <function>urldecode</function>. + <function>parse_url</function>, + <function>pathinfo</function>, + <function>set_magic_quotes_runtime</function> et + <function>urldecode</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/strings/functions/print.xml diff -u phpdoc-fr/reference/strings/functions/print.xml:1.4 phpdoc-fr/reference/strings/functions/print.xml:1.5 --- phpdoc-fr/reference/strings/functions/print.xml:1.4 Tue Jan 21 14:09:00 2003 +++ phpdoc-fr/reference/strings/functions/print.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.print"> <refnamediv> @@ -9,7 +9,7 @@ <refsect1> <title>Description</title> <methodsynopsis> - <methodname>print</methodname> + <type>void</type><methodname>print</methodname> <methodparam><type>string</type><parameter>arg</parameter></methodparam> </methodsynopsis> <simpara> @@ -42,7 +42,7 @@ $foo = "foobar"; $bar = "barbaz"; -print "foo vaut &quot;$foo&quot;"; +print "foo vaut \"$foo\""; // foo vaut "foobar" // Les guillemets simples &eacute;vitent le remplacement des variables Index: phpdoc-fr/reference/strings/functions/setlocale.xml diff -u phpdoc-fr/reference/strings/functions/setlocale.xml:1.3 phpdoc-fr/reference/strings/functions/setlocale.xml:1.4 --- phpdoc-fr/reference/strings/functions/setlocale.xml:1.3 Mon Aug 12 22:59:47 2002 +++ phpdoc-fr/reference/strings/functions/setlocale.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.setlocale"> <refnamediv> @@ -12,6 +12,12 @@ <type>string</type><methodname>setlocale</methodname> <methodparam><type>mixed</type><parameter>category</parameter></methodparam> <methodparam><type>string</type><parameter>locale</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>setlocale</methodname> + <methodparam><type>mixed</type><parameter>category</parameter></methodparam> + <methodparam><type>array</type><parameter>locale</parameter></methodparam> </methodsynopsis> <para> <function>setlocale</function> retourne la nouvelle configuration locale, @@ -68,10 +74,36 @@ depuis "LANG". </para> <para> + Si <parameter>locale</parameter> vaut z&eacute;ro ou <literal>"0"</literal>, + la configuration locale ne sera pas modifi&eacute;e, et la configuration + courante sera retourn&eacute;e. + </para> + <note> + <simpara> + La possibilit&eacute; de passer plusieurs locales est disponible depuis + &php; 4.3.0. + </simpara> + </note> + <para> + <function>setlocale</function> retourne la valeur de la locale + courante, ou bien &false; si la fonctionnalit&eacute; de localisation + n'est pas impl&eacute;ment&eacute;e sur cette plate-forme, si la locale sp&eacute;cifi&eacute;e + n'existe pas, ou si la cat&eacute;gorie n'existe pas. Une cat&eacute;gorie invalide + causera aussi l'affichage d'un message d'alerte. + </para> + <para> Si <parameter>locale</parameter> vaut z&eacute;ro ou <literal>"0"</literal>, la configuration de localisation ne sera pas modifi&eacute;e, et seule la valeur courante sera retourn&eacute;e. </para> + <note> + <para> + La valeur retourn&eacute;e par <function>setlocale</function> d&eacute;pend + du syst&egrave;me d'explotiation qui fait tourner &php;. la valeur + retourn&eacute;e est exactement celle que la fonction setlocale() du + syst&egrave;me retourne. + </para> + </note> <para> <example> <title>Exemple avec <function>setlocale</function></title> @@ -83,6 +115,10 @@ /* Affiche : vrijdag 22 december 1978 */ echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978)); + + /* essai de diff&eacute;rentes valeurs possible pour l'allemande depuis PHP 4.3.0 */ + $loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge'); + echo "L'identifiant de l'allemand sur ce syst&egrave;me est '$loc_de'"; ?> ]]> </programlisting> Index: phpdoc-fr/reference/strings/functions/str-replace.xml diff -u phpdoc-fr/reference/strings/functions/str-replace.xml:1.4 phpdoc-fr/reference/strings/functions/str-replace.xml:1.5 --- phpdoc-fr/reference/strings/functions/str-replace.xml:1.4 Tue Jan 21 14:09:00 2003 +++ phpdoc-fr/reference/strings/functions/str-replace.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 --> <refentry id="function.str-replace"> <refnamediv> @@ -15,6 +15,7 @@ <methodparam><type>mixed</type><parameter>search</parameter></methodparam> <methodparam><type>mixed</type><parameter>replace</parameter></methodparam> <methodparam><type>mixed</type><parameter>subject</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>&amp;count</parameter></methodparam> </methodsynopsis> <para> <function>str_replace</function> retourne une cha&icirc;ne ou un tableau, @@ -69,8 +70,16 @@ &eacute;taient bugg&eacute;e jusqu'en PHP 3.0.8. </para> </note> + <note> + <simpara> + Depuis &php; 5.0, le nombre de valeur de <parameter>needle</parameter> + trouv&eacute;es et remplac&eacute;es seront reoturn&eacute;es dans le param&egrave;tre + <parameter>count</parameter> pass&eacute; par r&eacute;f&eacute;rence. + </simpara> + </note> <para> Voir aussi + <function>str_ireplace</function>, <function>ereg_replace</function>, <function>preg_replace</function> et <function>strtr</function>. Index: phpdoc-fr/reference/strings/functions/strpos.xml diff -u phpdoc-fr/reference/strings/functions/strpos.xml:1.3 phpdoc-fr/reference/strings/functions/strpos.xml:1.4 --- phpdoc-fr/reference/strings/functions/strpos.xml:1.3 Mon Aug 12 22:59:48 2002 +++ phpdoc-fr/reference/strings/functions/strpos.xml Sat Apr 26 15:25:30 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/strings.xml, last change in rev 1.8 --> <refentry id="function.strpos"> <refnamediv> @@ -26,32 +26,30 @@ </para> <para> Si <parameter>needle</parameter> n'est pas trouv&eacute;e, la fonction retourne &false;. - <note> + </para> + &return.falseproblem; <para> - Il est facile de confondre le r&eacute;sultat "caract&egrave;re trouv&eacute; &agrave; la - position 0" et "caract&egrave;re non trouv&eacute;". Voici comment faire la diff&eacute;rence : <informalexample> <programlisting role="php"> <![CDATA[ <?php -// en PHP 4.0b3 et plus r&eacute;cent : - $pos = strpos($machaine, "b"); - if ($pos === false) { // note : trois &eacute;gals - // pas trouv&eacute; - } +$mystring = 'abc'; +$findme = 'a'; +$pos = strpos($mystring, $findme); -// en versions plus ancienne que 4.0b3 : - $pos = strpos($machaine, "b"); - if (!is_integer($pos)) { - // pas trouv&eacute; - } +// Notez l'utilisation de ===. Un simple == ne donnerait pas le r&eacute;sultat escompt&eacute; +// car la lettre 'a' est &agrave; la position 0th (la premi&egrave;re). +if ($pos === false) { + echo "La cha&icirc;ne '$findme' n'a pas &eacute;t&eacute; trouv&eacute;e dans la cha&icirc;ne '$mystring'"; +} else { + echo "La cha&icirc;ne '$findme' a &eacute;t&eacute; trouv&eacute;e dans la cha&icirc;ne '$mystring'"; + echo " et &agrave; la position $pos"; +} ?> ]]> </programlisting> </informalexample> </para> - </note> - </para> <para> Si <parameter>needle</parameter> n'est pas une cha&icirc;ne, elle est convertie en entier, et utilis&eacute; comme caract&egrave;re de code ASCII @@ -64,7 +62,9 @@ relative au d&eacute;but de la cha&icirc;ne <parameter>haystack</parameter>. </para> <para> - Voir aussi <function>strrpos</function>, + Voir aussi + <function>stripos</function>, + <function>strrpos</function>, <function>strrchr</function>, <function>substr</function>, <function>stristr</function> et
« previous php.doc.fr (#303) next »