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: | Damien Seguy | 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înes de caractères (Strings)</title> <titleabbrev>Chaînes</titleabbrev> <partintro> <simpara> + </simpara> + <para> + du manuel. + </para> + + <section id="strings.intro"> + &reftitle.intro; + <para> Ces fonctions permettent de manipuler des chaînes de caractères de différentes façons. Certaines fonctionnalités plus spécialisées sont disponibles dans les sections d'expression - régulières et de gestion des URL. - </simpara> - <para> + réguliè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étails sur le comportement des chaînes de caractères, notamment avec les guillemets simples et doubles, les séquences d'échappement, reportez-vous à la section <link linkend="language.types.string">Chaînes de caractè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înes, reportez-vous aux <link linkend="ref.regex">expressions régulières POSIX</link> et <link linkend="ref.pcre">expressions réguliè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érification CRC32</refpurpose> + <refpurpose>Calcule la somme de contrô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énère la somme de vérification - cyclique CRC 32, calculée sur 32 bits de long, appliqués à la - chaîne <parameter>str</parameter>. Cette fonction généralement utilisée - pour valider l'intégritée de données durant une transmission. + <function>crc32</function> génère la somme de contrôle + cyclique CRC 32, calculée sur 32 bits, et appliqués à + la chaîne <parameter>str</parameter>. Cette fonction est + généralement utilisée pour valider + l'intégritée de données durant une transmission. </para> <para> - Voir aussi - <function>md5</function> + <note> + <para> + Comme le type d'entier de &php; est signé, et que de nombreuses + sommes de contrôle CRC32 aboutissent à un nombre négatif, vous + devez utiliser le format "%u" de la fonction <function>sprintf</function> ou + <function>printf</function> pour obtenir la représentation + littérale de la somme de contrôle CRC32. + </para> + </note> + Ce second illustre comment afficher la somme de contrôle + avec la focntion <function>printf</function> : + <example> + <title>Displaying a crc32 checksum</title> + <programlisting role="php"> +<![CDATA[ +<?php + $checksum = crc32("Le vif zé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> à 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 "$foo""; +echo "foo vaut \"$foo\""; // foo vaut "foobar" // Les guillemets simples évitent le remplacement des variables @@ -78,13 +78,14 @@ <function>echo</function> dispose aussi d'une version courte, où vous pouvez faire suivre la balise PHP ouvrante d'un signe é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ème argument optionnel, qui indique comment doivent être traité les guillemets doubles et simples. Vous pouvez utiliser l'une des constantes suivantes : - <constant>ENT_COMPAT</constant>, la constante par dé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ères ISO-8859-1 est utilisé par - défaut. Le support pour le second argument optionnel a été - ajouté en PHP 3.0.17 et PHP 4.0.3. + Le support du paramètre optionnel <parameter>quote</parameter> a été ajouté + en &php; 4.0.3. </para> <para> Comme <function>htmlspecialchars</function>, cette fonction prend un troisième argument optionnel qui définit le jeux de caractères - utilisé durant la conversion. Le support de cet argumetn a été - ajouté en PHP 4.1.0. + utilisé durant la conversion. Le support de cet argument a été + ajouté en PHP 4.1.0. Actuellement, le jeu de caractères + ISO-8859-1 est utilisé par défaut. </para> + &reference.strings.charsets; <para> - Il n'y a pas de fonction inverse de cette fonction. Toutefois, vous - pouvez en créer une facilement. Voici comment faire : + Si vous voulez réaliser l'opé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; +// <a href='test'>Test</a> ?> ]]> </programlisting> @@ -92,9 +94,11 @@ utilisé durant la conversion. Le support de cet argument a été ajouté 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ée. Le résultat est un nombre de 32 - caractères hexadécimaux. + caractères hexadécimaux. Si le paramètre + optionnel <parameter>raw_output</parameter> vaut &true;, + le digest MD5 est retournée au format binaire brut, avec + une taille de 16. </para> + <note> + <simpara> + Le paramètre optionnel <parameter>raw_output</parameter> a été ajouté + en &false; 5.0.0 et vaut par défaut &false;. + </simpara> + </note> <para> <function>md5_file</function> a la même utilité 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ésultat. Le résultat est un nombre de 32 caractères hexadécimaux. </para> + <note> + <simpara> + Le paramètre <parameter>raw_output</parameter> a été ajouté en + &php; 5.0.0 et vaut par dé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ère des retours à la ligne HTML à chaque nouvelle ligne + Insère un retour à la ligne HTML à 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às avoir inséré '<br />' devant toutes les nouvelles lignes. + <function>nl2br</function> retourne <parameter>string</parameter> + apràs avoir inséré '<br />' + 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îne de caractères @@ -29,17 +28,31 @@ ajouté en PHP 4.0.3. </para> </note> + <note> + <para> + Pour accéder à 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éressant de lire la section sur les + <link linkend="language.variables.external">variables externes à &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 "$foo""; +print "foo vaut \"$foo\""; // foo vaut "foobar" // Les guillemets simples é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éro ou <literal>"0"</literal>, + la configuration locale ne sera pas modifiée, et la configuration + courante sera retournée. + </para> + <note> + <simpara> + La possibilité 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é de localisation + n'est pas implémentée sur cette plate-forme, si la locale spécifiée + n'existe pas, ou si la catégorie n'existe pas. Une catégorie invalide + causera aussi l'affichage d'un message d'alerte. + </para> + <para> Si <parameter>locale</parameter> vaut zéro ou <literal>"0"</literal>, la configuration de localisation ne sera pas modifiée, et seule la valeur courante sera retournée. </para> + <note> + <para> + La valeur retournée par <function>setlocale</function> dépend + du système d'explotiation qui fait tourner &php;. la valeur + retournée est exactement celle que la fonction setlocale() du + systè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é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è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>&count</parameter></methodparam> </methodsynopsis> <para> <function>str_replace</function> retourne une chaîne ou un tableau, @@ -69,8 +70,16 @@ étaient buggée jusqu'en PHP 3.0.8. </para> </note> + <note> + <simpara> + Depuis &php; 5.0, le nombre de valeur de <parameter>needle</parameter> + trouvées et remplacées seront reoturnées dans le paramètre + <parameter>count</parameter> passé par réfé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ée, la fonction retourne &false;. - <note> + </para> + &return.falseproblem; <para> - Il est facile de confondre le résultat "caractère trouvé à la - position 0" et "caractère non trouvé". Voici comment faire la différence : <informalexample> <programlisting role="php"> <![CDATA[ <?php -// en PHP 4.0b3 et plus récent : - $pos = strpos($machaine, "b"); - if ($pos === false) { // note : trois égals - // pas trouvé - } +$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é - } +// Notez l'utilisation de ===. Un simple == ne donnerait pas le résultat escompté +// car la lettre 'a' est à la position 0th (la première). +if ($pos === false) { + echo "La chaîne '$findme' n'a pas été trouvée dans la chaîne '$mystring'"; +} else { + echo "La chaîne '$findme' a été trouvée dans la chaîne '$mystring'"; + echo " et à la position $pos"; +} ?> ]]> </programlisting> </informalexample> </para> - </note> - </para> <para> Si <parameter>needle</parameter> n'est pas une chaîne, elle est convertie en entier, et utilisé comme caractère de code ASCII @@ -64,7 +62,9 @@ relative au début de la chaî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
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înes de caractères (Strings)</title> <titleabbrev>Chaînes</titleabbrev> <partintro> <simpara> + </simpara> + <para> + du manuel. + </para> + + <section id="strings.intro"> + &reftitle.intro; + <para> Ces fonctions permettent de manipuler des chaînes de caractères de différentes façons. Certaines fonctionnalités plus spécialisées sont disponibles dans les sections d'expression - régulières et de gestion des URL. - </simpara> - <para> + réguliè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étails sur le comportement des chaînes de caractères, notamment avec les guillemets simples et doubles, les séquences d'échappement, reportez-vous à la section <link linkend="language.types.string">Chaînes de caractè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înes, reportez-vous aux <link linkend="ref.regex">expressions régulières POSIX</link> et <link linkend="ref.pcre">expressions réguliè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érification CRC32</refpurpose> + <refpurpose>Calcule la somme de contrô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énère la somme de vérification - cyclique CRC 32, calculée sur 32 bits de long, appliqués à la - chaîne <parameter>str</parameter>. Cette fonction généralement utilisée - pour valider l'intégritée de données durant une transmission. + <function>crc32</function> génère la somme de contrôle + cyclique CRC 32, calculée sur 32 bits, et appliqués à + la chaîne <parameter>str</parameter>. Cette fonction est + généralement utilisée pour valider + l'intégritée de données durant une transmission. </para> <para> - Voir aussi - <function>md5</function> + <note> + <para> + Comme le type d'entier de &php; est signé, et que de nombreuses + sommes de contrôle CRC32 aboutissent à un nombre négatif, vous + devez utiliser le format "%u" de la fonction <function>sprintf</function> ou + <function>printf</function> pour obtenir la représentation + littérale de la somme de contrôle CRC32. + </para> + </note> + Ce second illustre comment afficher la somme de contrôle + avec la focntion <function>printf</function> : + <example> + <title>Displaying a crc32 checksum</title> + <programlisting role="php"> +<![CDATA[ +<?php + $checksum = crc32("Le vif zé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> à 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 "$foo""; +echo "foo vaut \"$foo\""; // foo vaut "foobar" // Les guillemets simples évitent le remplacement des variables @@ -78,13 +78,14 @@ <function>echo</function> dispose aussi d'une version courte, où vous pouvez faire suivre la balise PHP ouvrante d'un signe é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ème argument optionnel, qui indique comment doivent être traité les guillemets doubles et simples. Vous pouvez utiliser l'une des constantes suivantes : - <constant>ENT_COMPAT</constant>, la constante par dé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ères ISO-8859-1 est utilisé par - défaut. Le support pour le second argument optionnel a été - ajouté en PHP 3.0.17 et PHP 4.0.3. + Le support du paramètre optionnel <parameter>quote</parameter> a été ajouté + en &php; 4.0.3. </para> <para> Comme <function>htmlspecialchars</function>, cette fonction prend un troisième argument optionnel qui définit le jeux de caractères - utilisé durant la conversion. Le support de cet argumetn a été - ajouté en PHP 4.1.0. + utilisé durant la conversion. Le support de cet argument a été + ajouté en PHP 4.1.0. Actuellement, le jeu de caractères + ISO-8859-1 est utilisé par défaut. </para> + &reference.strings.charsets; <para> - Il n'y a pas de fonction inverse de cette fonction. Toutefois, vous - pouvez en créer une facilement. Voici comment faire : + Si vous voulez réaliser l'opé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; +// <a href='test'>Test</a> ?> ]]> </programlisting> @@ -92,9 +94,11 @@ utilisé durant la conversion. Le support de cet argument a été ajouté 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ée. Le résultat est un nombre de 32 - caractères hexadécimaux. + caractères hexadécimaux. Si le paramètre + optionnel <parameter>raw_output</parameter> vaut &true;, + le digest MD5 est retournée au format binaire brut, avec + une taille de 16. </para> + <note> + <simpara> + Le paramètre optionnel <parameter>raw_output</parameter> a été ajouté + en &false; 5.0.0 et vaut par défaut &false;. + </simpara> + </note> <para> <function>md5_file</function> a la même utilité 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ésultat. Le résultat est un nombre de 32 caractères hexadécimaux. </para> + <note> + <simpara> + Le paramètre <parameter>raw_output</parameter> a été ajouté en + &php; 5.0.0 et vaut par dé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ère des retours à la ligne HTML à chaque nouvelle ligne + Insère un retour à la ligne HTML à 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às avoir inséré '<br />' devant toutes les nouvelles lignes. + <function>nl2br</function> retourne <parameter>string</parameter> + apràs avoir inséré '<br />' + 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îne de caractères @@ -29,17 +28,31 @@ ajouté en PHP 4.0.3. </para> </note> + <note> + <para> + Pour accéder à 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éressant de lire la section sur les + <link linkend="language.variables.external">variables externes à &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 "$foo""; +print "foo vaut \"$foo\""; // foo vaut "foobar" // Les guillemets simples é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éro ou <literal>"0"</literal>, + la configuration locale ne sera pas modifiée, et la configuration + courante sera retournée. + </para> + <note> + <simpara> + La possibilité 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é de localisation + n'est pas implémentée sur cette plate-forme, si la locale spécifiée + n'existe pas, ou si la catégorie n'existe pas. Une catégorie invalide + causera aussi l'affichage d'un message d'alerte. + </para> + <para> Si <parameter>locale</parameter> vaut zéro ou <literal>"0"</literal>, la configuration de localisation ne sera pas modifiée, et seule la valeur courante sera retournée. </para> + <note> + <para> + La valeur retournée par <function>setlocale</function> dépend + du système d'explotiation qui fait tourner &php;. la valeur + retournée est exactement celle que la fonction setlocale() du + systè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é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è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>&count</parameter></methodparam> </methodsynopsis> <para> <function>str_replace</function> retourne une chaîne ou un tableau, @@ -69,8 +70,16 @@ étaient buggée jusqu'en PHP 3.0.8. </para> </note> + <note> + <simpara> + Depuis &php; 5.0, le nombre de valeur de <parameter>needle</parameter> + trouvées et remplacées seront reoturnées dans le paramètre + <parameter>count</parameter> passé par réfé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ée, la fonction retourne &false;. - <note> + </para> + &return.falseproblem; <para> - Il est facile de confondre le résultat "caractère trouvé à la - position 0" et "caractère non trouvé". Voici comment faire la différence : <informalexample> <programlisting role="php"> <![CDATA[ <?php -// en PHP 4.0b3 et plus récent : - $pos = strpos($machaine, "b"); - if ($pos === false) { // note : trois égals - // pas trouvé - } +$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é - } +// Notez l'utilisation de ===. Un simple == ne donnerait pas le résultat escompté +// car la lettre 'a' est à la position 0th (la première). +if ($pos === false) { + echo "La chaîne '$findme' n'a pas été trouvée dans la chaîne '$mystring'"; +} else { + echo "La chaîne '$findme' a été trouvée dans la chaîne '$mystring'"; + echo " et à la position $pos"; +} ?> ]]> </programlisting> </informalexample> </para> - </note> - </para> <para> Si <parameter>needle</parameter> n'est pas une chaîne, elle est convertie en entier, et utilisé comme caractère de code ASCII @@ -64,7 +62,9 @@ relative au début de la chaî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