dams Thu Feb 15 11:22:20 2001 EDT
Modified files:
/phpdoc/fr/functions strings.xml
Log:
Corrected one title (trim).Added readablility
Index: phpdoc/fr/functions/strings.xml
diff -u phpdoc/fr/functions/strings.xml:1.27 phpdoc/fr/functions/strings.xml:1.28
--- phpdoc/fr/functions/strings.xml:1.27 Tue Feb 13 03:30:39 2001
+++ phpdoc/fr/functions/strings.xml Thu Feb 15 11:22:20 2001
@@ -212,11 +212,12 @@
<function>chunk_split</function> permet de scinder une chaîne en
plus petit morceaux, comme dans le cas de la conversion en
<link linkend="function.base64-encode">base64_encode</link> pour se
- conformer à la RFC 2045. Cette fonction insère une fin
- de chaîne <parameter>end</parameter> (par défaut "\r\n"),
- tous les <parameter>chunklen</parameter> (par défaut 76)
- caractères. La chaîne retournée est une nouvelle
- chaîne, et l'original n'est pas modifié.
+ conformer à la RFC 2045. <function>chunk_split</function>
+ insère une fin de chaîne <parameter>end</parameter>
+ (par défaut "\r\n"), tous les <parameter>chunklen</parameter>
+ (par défaut 76) caractères. La chaîne
+ retournée est une nouvelle chaîne, et
+ l'original n'est pas modifié.
<example>
<title>Exemple avec <function>chunk_split</function></title>
<programlisting role="php">
@@ -316,9 +317,10 @@
</funcprototype>
</funcsynopsis>
<para>
- Compte le nombre d'occurence de chaque octet (0..255) dans la chaîne
- <parameter>string</parameter> et le retourne de différente
- façon. L'option <parameter>mode</parameter> prend, par défaut,
+ <function>count_chars</function> compte le nombre d'occurence de
+ chaque octet (0..255) dans la chaîne <parameter>string</parameter> et
+ le retourne de différentes façons. L'option
+ <parameter>mode</parameter> prend, par défaut,
la valeur 0. Suivant le <parameter>mode</parameter>,
<function>count_chars</function> retourne une des réponses suivante :
<itemizedlist>
@@ -353,7 +355,8 @@
</para>
<note>
<para>
- Cette fonction a été ajoutée en PHP 4.0.
+ <function>count_chars</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</refsect1>
@@ -374,7 +377,7 @@
<para>
<function>crc32</function> génère la somme de
vérification
de redondance cyclique (32-bit) de la chaîne <parameter>str</parameter>.
- Cette valeur sert généralement à vérifier
+ Cette valeur sert généralement à vérifier
l'intégrité de données transmises.
</para>
<para>
@@ -424,9 +427,9 @@
</simpara>
<simpara>
Si vous utilisez le grain de sel fourni, retenez bien que ce grain
- de sel est généré une seule fois. Si vous appelez cette
fonction
- récursivement, cela aura un impact sur l'apparance et finalement
- la sécurité de votre cryptage.
+ de sel est généré une seule fois. Si vous appelez
+ <function>crypt</function> récursivement, cela aura un impact sur
+ l'apparance et finalement la sécurité de votre cryptage.
</simpara>
<simpara>
L'encryption standard fournit le grain de sel dans les deux premiers octets
@@ -535,7 +538,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>explode</function> retourne un tableau qui contient
+ <function>explode</function> retourne un tableau qui contient
les éléments de la
chaîne, séparés par <replaceable>separator</replaceable>.
<example>
@@ -621,7 +624,8 @@
Le contenu de <literal>$original</literal> sera : "Hallo & <Frau> &
Krämer".
<note>
<para>
- Cette fonction a été ajoutée en PHP 4.0.
+ <function>get_html_translation_table</function> a été
+ ajoutée en PHP 4.0.
</para>
</note>
</para>
@@ -759,8 +763,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction est identique à <function>htmlspecialchars</function>
- en tous points, sauf que tous les caractères qui ont une entité
+ <function>htmlentities</function> est identique à
+ <function>htmlspecialchars</function> en tous points, sauf que
+ tous les caractères qui ont une entité
équivalente en HTML sont replacés par ces entités.
Comme <function>htmlspecialchars</function>, elle prend un argument
optionnel qui indique ce qui doit être fait avec les guillemets
@@ -798,18 +803,20 @@
<para>
Certains caractères ont une valeur avec HTML, et doivent
être remplacés par des balises HTML pour conserver
- leur valeur. Cette fonction retourne une chaîne avec
- tous les caractères sensibles remplacés par leur
- équivalent.
+ leur valeur. <function>htmlspecialchars</function> retourne une
+ chaîne dont tous les caractères sensibles ont
+ été remplacés par leur équivalent.
</para>
<simpara>
- Cette fonction est utile pour empêcher un utilisateur de
- fournir un texte avec un sens HTML, comme dans un livre d'or.
+ <function>htmlspecialchars</function> est utile pour empêcher
+ un utilisateur de fournir un texte avec un sens HTML, comme dans
+ un livre d'or.
</simpara>
<simpara>
<function>htmlspecialchars</function> est pratique pour éviter que
les textes fournis par les utilisateurs contiennent des balises HTML,
- comme dans le cas d'un livre d'or ou d'une tribune. Cette fonction
+ comme dans le cas d'un livre d'or ou d'une tribune.
+ <function>htmlspecialchars</function>
prend un argument optionnel qui indique ce qui doit être fait
avec les guillemets simples et doubles. <constant>ENT_COMPAT</constant>
(par défaut) convertira les guillemets doubles, et ignorera
@@ -855,9 +862,9 @@
</programlisting>
</example>
<para>
- Notez bien que cette fonction ne fait aucun autre remplacment que
- ceux listés ci-dessus. Pour une traduction complète
- de toutes les balises, reportez vous à
+ Notez bien que <function>htmlspecialchars</function> ne fait aucun
+ autre remplacment que ceux listés ci-dessus. Pour une
+ traduction complète de toutes les balises, reportez vous à
<function>htmlentities</function>. Notez que l'argument optionnel
a été ajouté PHP 3.0.17 et PHP 4.0.3.
</para>
@@ -884,7 +891,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>implode</function> retourne une chaîne
+ <function>implode</function> retourne une chaîne
constituée de tous les
éléments du tableau, pris dans l'ordre,
transformés en chaîne, et séparés par
@@ -1000,7 +1007,7 @@
simple, mais qui n'est pas aussi efficace.
</para>
<para>
- La troisième variante n'est pas encore implémentée.
+ La troisième variante n'est pas encore implémentée.
Elle est encore plus générale, et plus souple, mais plus lente.
Elle appelera une fonction utilisateur qui déterminera le coût
de chaque opération.
@@ -1051,7 +1058,7 @@
</para>
<para>
L'utilisation d'une fonction utilisateur permet de prendre en
- compte la différence entre certains caractères, ou
+ compte la différence entre certains caractères, ou
leur contexte pour déterminer le coût d'une opération
d'insertion, remplacement ou effacement. Elle accroit la charge de calcul
demandée au CPU, et annule l'optimisation des autres variantes.
@@ -1077,7 +1084,7 @@
</funcsynopsis>
<para>
<function>localeconv</function> retourne un tableau associatif contenant
- les informations locales de format monétaire et numérique
+ les informations locales de format monétaire et numérique
utilisé par le serveur.
</para>
<para>
@@ -1200,7 +1207,7 @@
</informaltable>
</para>
<para>
- Le champs de groupage contient un tableau qui définit comment les
+ Le champs de groupage contient un tableau qui définit comment les
chiffres doivent être regroupés. Par exemple, ce champs pour
le dollar américain contient un tableau de deux éléments
(3 et 3). Les éléments sont classés de gauche à
droite.
@@ -1251,7 +1258,7 @@
<refnamediv>
<refname>ltrim</refname>
<refpurpose>
- Enlève les espaces de début de chaîne.
+ Enlève les espaces de début de chaîne.
</refpurpose>
</refnamediv>
<refsect1>
@@ -1263,7 +1270,7 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction enlève les caractères blancs
+ <function>ltrim</function> enlève les caractères blancs
placés au début d'une chaîne et retourne la
chaîne raccourcie. Les caractères blancs sont :
"\n", "\r", "\t", "\v", "\0", et " ".
@@ -1323,7 +1330,8 @@
["Practical Algorithms for Programmers", Binstock & Rex, Addison Wesley, 1995].
<note>
<para>
- Cette fonction a été ajoutée en PHP 4.0.
+ C<function>metaphone</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</para>
@@ -1367,9 +1375,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>ord</function> retourne la valeur ASCII du premier
+ <function>ord</function> retourne la valeur ASCII du premier
caractère de la chaîne
- <parameter>string</parameter>. Cette fonction est le contraire de
+ <parameter>string</parameter>. <function>ord</function> est le contraire de
<function>chr</function>.
<example>
<title>Exemple avec <function>ord</function></title>
@@ -1544,7 +1552,8 @@
<para>
<function>rtrim</function> la chaîne <parameter>str</parameter>,
débarassée de ses espaces terminaux, y compris les
- nouvelles lignes. Cette fonction est un alias de <function>chop</function>.
+ nouvelles lignes. <function>rtrim</function> est un alias de
+ <function>chop</function>.
<example>
<title>Exemple avec <function>rtrim</function> example</title>
<programlisting role="php">
@@ -1583,8 +1592,8 @@
données de la chaîne <parameter>str</parameter> et
interprète son contenu en fonction du format
<parameter>format</parameter>. Si seulement deux paramètres
- sont passés à cette fonction, les valeurs obtenues
- seront retournées sous forme d'un tableau.
+ sont passés à <function>sscanf</function>,
+ les valeurs obtenues seront retournées sous forme d'un tableau.
<example>
<title>Exemple avec <function>sscanf</function></title>
<programlisting role="php">
@@ -1717,7 +1726,8 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction calcule la similarité entre deux chaînes,
+ <function>similar_text</function> calcule la similarité
+ entre deux chaînes,
comme décrit par Oliver [1993]. Notez que cette
implémentation n'utilise pas une pile, comme dans le
pseudo-code d'Oliver, mais un appel récursif qui
@@ -1759,9 +1769,9 @@
par une lettre.
</para>
<para>
- Cette fonction particulière a été décrite
- par Donald Knuth dans "The Art Of Computer Programming, vol. 3: Sorting And
Searching",
- Addison-Wesley (1973), pp. 391-392.
+ <function>soundex</function> particulière a été
+ décrite par Donald Knuth dans "The Art Of Computer Programming,
+ vol. 3: Sorting And Searching", Addison-Wesley (1973), pp. 391-392.
</para>
<para>
<example>
@@ -1855,7 +1865,7 @@
<literal>%</literal> - un signe pourcentage : aucun argument
nécessaire.
</member>
<member>
- <literal>b</literal> - l'argument est traité comme un entier, et
+ <literal>b</literal> - l'argument est traité comme un entier, et
représenté comme un nombre binaire.
</member>
<member>
@@ -1863,11 +1873,11 @@
représenté comme un nombre ascii.
</member>
<member>
- <literal>d</literal> - l'argument est traité comme un entier,
+ <literal>d</literal> - l'argument est traité comme un entier,
et représenté comme un nombre décimal.
</member>
<member>
- <literal>f</literal> - l'argument est traité comme un double,
+ <literal>f</literal> - l'argument est traité comme un double,
et représenté comme un nombre à virgule flottante.
</member>
<member>
@@ -1883,7 +1893,7 @@
et représenté comme un nombre hexadécimal (en
minuscules).
</member>
<member>
- <literal>X</literal> - l'argument est traité comme un entier,
+ <literal>X</literal> - l'argument est traité comme un entier,
et représenté comme un nombre hexadécimal (en
majuscules).
</member>
</simplelist>
@@ -1979,7 +1989,7 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>strcasecmp</function> retourne < 0 si
+ <function>strcasecmp</function> retourne < 0 si
<parameter>str1</parameter> est plus petit que
<parameter>str2</parameter>; > 0 si <parameter>str1</parameter>
est plus grand que <parameter>str2</parameter>, et 0 si ils sont égaux.
@@ -2179,9 +2189,10 @@
</funcsynopsis>
<para>
<function>stripcslashes</function> retourne une chaîne dont les
- antislash ont été supprimés. Cette fonction reconnait
- les <literal>\n</literal>, <literal>\r</literal>..., et les
représentations
- octales et hexadécimales utilisées en C.
+ antislash ont été supprimés.
+<function>stripcslashes</function>
+ reconnait les <literal>\n</literal>, <literal>\r</literal>...,
+ et les représentations octales et hexadécimales
+ utilisées en C.
<note>
<simpara>
<function>stripcslashes</function> a été ajouté en
@@ -2242,11 +2253,11 @@
sont examinés sans tenir compte de la casse.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas trouvé, retourne
+ Si <parameter>needle</parameter> n'est pas trouvé, retourne
<literal>FALSE</literal>.
</para>
<para>
- Si <parameter>needle</parameter> n'est pas une chaîne, elle est
+ Si <parameter>needle</parameter> n'est pas une chaîne, elle est
convertie en entier, puis est utilisée comme si elle était
passée à <function>chr</function>.
</para>
@@ -2495,7 +2506,7 @@
<refnamediv>
<refname>strpos</refname>
<refpurpose>
- Recherche la première occurrence d'un caractère dans une
+ Recherche la première occurrence d'un caractère dans une
chaîne.
</refpurpose>
</refnamediv>
@@ -2586,7 +2597,7 @@
la chaîne <parameter>haystack</parameter>.
</para>
<para>
- <function>strrchr</function> retourne <literal>FALSE</literal>
+ <function>strrchr</function> retourne <literal>FALSE</literal>
si <parameter>needle</parameter> n'est pas trouvé.
</para>
<para>
@@ -2647,7 +2658,8 @@
</para>
<note>
<para>
- Cette fonction a été ajoutée en PHP 4.0.
+ <function>str_repeat</function> a été ajoutée
+ en PHP 4.0.
</para>
</note>
</refsect1>
@@ -2787,9 +2799,9 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>strstr</function> retourne toute la chaîne
- <parameter>haystack</parameter> à partir de la première
- occurrence de <parameter>needle</parameter>, jusqu'à la fin.
+ <function>strstr</function> retourne toute la chaîne
+ <parameter>haystack</parameter> à partir de la première
+ occurrence de <parameter>needle</parameter>, jusqu'à la fin.
</para>
<para>
Si <parameter>needle</parameter> n'est pas trouvé, retourne
<literal>FALSE</literal>.
@@ -2797,8 +2809,8 @@
<para>
<note>
<para>
- Notez que cette fonction est sensible à la casse :
- sinon, utilisez <function>stristr</function>.
+ Notez que <function>strstr</function> est sensible à
+ la casse. Au besoin, utilisez <function>stristr</function>.
</para>
</note>
</para>
@@ -3275,7 +3287,7 @@
<refnamediv>
<refname>trim</refname>
<refpurpose>
- Enlève les espaces de fin et de fin de chaîne.
+ Enlève les espaces de début et de fin de chaîne
</refpurpose>
</refnamediv>
<refsect1>
@@ -3287,9 +3299,9 @@
</funcprototype>
</funcsynopsis>
<para>
- Cette fonction retire les espaces blancs de début et de fin de
- chaîne, et retourne la chaîne nettoyée. Les espaces
- blancs sont : "\n", "\r", "\t", "\v", "\0", et " " (espace).
+ <function>trim</function> retire les espaces blancs de début et de
+ fin de chaîne, et retourne la chaîne nettoyée. Les
+ espaces blancs sont : "\n", "\r", "\t", "\v", "\0", et " " (espace).
</para>
<para>
Voir aussi <function>chop</function> et <function>ltrim</function>.
