cvs: phpdoc /fr/functions array.xml datetime.xml session.xml sockets.xml strings.xml zlib.xml
| From: | Damien Seguy | Date: | Fri, 26 Jan 2001 14:43:31 +0000 |
| Subject: | cvs: phpdoc /fr/functions array.xml datetime.xml session.xml sockets.xml strings.xml zlib.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333979@lists.php.net to get a copy of this message | ||
dams Fri Jan 26 06:43:31 2001 EDT
Modified files:
/phpdoc/fr/functions datetime.xml session.xml sockets.xml
strings.xml zlib.xml array.xml
Log:
Few updates.
Some misspelling.
Index: phpdoc/fr/functions/datetime.xml diff -u phpdoc/fr/functions/datetime.xml:1.9 phpdoc/fr/functions/datetime.xml:1.10 --- phpdoc/fr/functions/datetime.xml:1.9 Tue Jan 23 02:51:52 2001 +++ phpdoc/fr/functions/datetime.xml Fri Jan 26 06:43:31 2001 @@ -85,7 +85,7 @@ </listitem> <listitem> <simpara> - d - Jour du mois, sur deux chiffres (éventuellement avec un zéros) : + d - Jour du mois, sur deux chiffres (éventuellement avec un zéro) : "01" à "31" </simpara> </listitem> @@ -899,8 +899,8 @@ </itemizedlist> <note> <para> - Tous les caractères suivants ne sont pas toujours supportés par - toutes les librairies C. Dans ce cas, ils ne seront pas supportés + Tous les caractères suivants ne sont pas toujours supportés par + toutes les librairies C. Dans ce cas, ils ne seront pas supportés par PHP non plus. </para> </note> Index: phpdoc/fr/functions/session.xml diff -u phpdoc/fr/functions/session.xml:1.6 phpdoc/fr/functions/session.xml:1.7 --- phpdoc/fr/functions/session.xml:1.6 Tue Jan 23 02:48:27 2001 +++ phpdoc/fr/functions/session.xml Fri Jan 26 06:43:31 2001 @@ -41,8 +41,8 @@ </para> <note> <para> - Depuis PHP 4.0.3, <link - linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours + Depuis PHP 4.0.3, + <link linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours activée. </para> </note> @@ -126,6 +126,15 @@ <literal>session_name=session_id</literal>, ou bien, c'est une chaîne vide. </para> + <note> + <para> + La fonction qui gérera l'écriture des données ne sera appelée + qu'une fois le script aura envoyé toutes ses données. Ainsi, + les affichages tentés par cette fonction ne pourront jamais + être recus par le navigateur. Si un tel affichage est nécessaire, + il est conseillé d'écrire les debugs dans un fichier. + </para> + </note> <para> L'exemple suivant montre comment enregistrer une variable, et comment relier correctement des pages avec SID. @@ -141,8 +150,8 @@ # le <?=SID> est nécessaire pour transmettre l'identifiant de session # au cas oú les utilisateurs auraient inactivé les cookies ?> -Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?> </programlisting> + Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?> </example> </para> <para> @@ -181,7 +190,7 @@ <warning> <para> Si le dossier que vous utilisez a les droits de lecture universels, - comme <filename>/tmp</filename> (valeur par défaut), les autres utilisateurs + comme <filename>/tmp</filename> (valeur par défaut), les autres utilisateurs du serveur peuvent aussi lire ces fichiers, et s'imiscer dans vos sessions. </para> </warning> @@ -322,11 +331,11 @@ session passé par une variable GET ou par un cookie) </simpara> <simpara> - Cette fonction retourne toujours <literal>TRUE</literal>. + <function>session_start</function> retourne toujours <literal>TRUE</literal>. </simpara> <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_start</function> a été ajoutée en PHP 4.0. </para> </note> </refsect1> @@ -351,7 +360,8 @@ données associées à la session courante. </simpara> <simpara> - Cette fonction retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. + <function>session_destroy</function> retourne <literal>TRUE</literal> en + cas de succès, et <literal>FALSE</literal> sinon. </simpara> </refsect1> </refentry> @@ -397,7 +407,8 @@ </example> <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_name</function> a été ajoutée + en PHP 4.0. </para> </note> </refsect1> @@ -423,7 +434,8 @@ est fourni, ce module sera utilisé à la place du courant. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_module_name</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -460,7 +472,8 @@ </note> <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_save_path</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -490,7 +503,8 @@ son identifiant, comme chaîne à ajouter dans les URL. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_id</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -521,11 +535,12 @@ des chaînes ou d'autre tableau (récursif). </para> <para> - Cette fonction retourne <literal>TRUE</literal> lorsque la variable est correctement - enregistrée. + <function>session_register</function> retourne <literal>TRUE</literal> lorsque + la variable est correctement enregistrée. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_register</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -551,12 +566,13 @@ nommée <parameter>name</parameter> dans la session courante. </para> <para> - <function>session_unregister</function> retourne <literal>TRUE</literal> (vrai) + <function>session_unregister</function> retourne <literal>TRUE</literal> lorsque la variable a été correctement supprimée de la session. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_unregister</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -599,12 +615,13 @@ </funcprototype> </funcsynopsis> <para> - <function>session_is_registered</function> retourne <literal>TRUE</literal> si il y - a une variable du nom de <parameter>name</parameter> + <function>session_is_registered</function> retourne <literal>TRUE</literal> + s'il y a une variable du nom de <parameter>name</parameter> enregistrée dans la session courante. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_is_registered</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -703,7 +720,8 @@ et affecte les valeurs des variables de session. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_decode</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -727,7 +745,8 @@ session dans une chaîne. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_encode</function> a été ajoutée + en PHP 4.0. </para> </note> </para> Index: phpdoc/fr/functions/sockets.xml diff -u phpdoc/fr/functions/sockets.xml:1.4 phpdoc/fr/functions/sockets.xml:1.5 --- phpdoc/fr/functions/sockets.xml:1.4 Mon Jan 22 03:58:33 2001 +++ phpdoc/fr/functions/sockets.xml Fri Jan 26 06:43:31 2001 @@ -8,6 +8,12 @@ un serveur aussi bien qu'un client. </simpara> <para> + Les fonctions socket décrites ici sont rassemblées dans une extension + PHP. Pour être activées, il faut utiliser l'option de compilation + <option role="configure">--enable-sockets</option> au script + <command>configure</command>. + </para> + <para> Pour une interface client plus générique, reportez vous à <function>fsockopen</function> et <function>pfsockopen</function>. </para> Index: phpdoc/fr/functions/strings.xml diff -u phpdoc/fr/functions/strings.xml:1.19 phpdoc/fr/functions/strings.xml:1.20 --- phpdoc/fr/functions/strings.xml:1.19 Tue Jan 23 02:48:27 2001 +++ phpdoc/fr/functions/strings.xml Fri Jan 26 06:43:31 2001 @@ -2951,7 +2951,7 @@ <funcdef>mixed <function>str_replace</function></funcdef> <paramdef>mixed <parameter>search</parameter></paramdef> <paramdef>mixed <parameter>replace</parameter></paramdef> - <paramdef>mixed <parameter>subject</parameter></paramdef> + <paramdef>mixed <parameter>subject</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2962,23 +2962,23 @@ utiliser <function>ereg_replace</function>. </para> <para> - En PHP 4.0.5 et plus récent, chaque paramètre de - <function>str_replace</function> peut être un tableau. + En PHP 4.0.5 et plus récent, chaque paramètre de + <function>str_replace</function> peut être un tableau. </para> <para> - Si <parameter>subject</parameter> est un tableau, alors le remplacement - est effectué pour chaque valeur de <parameter>subject</parameter>, et la - valeur retourné sera un tableau. + Si <parameter>subject</parameter> est un tableau, alors le remplacement + est effectué pour chaque valeur de <parameter>subject</parameter>, et la + valeur retourné sera un tableau. </para> <para> Si <parameter>search</parameter> et <parameter>replace</parameter> sont des tableaux, alors <function>str_replace</function> prend une valeur dans - chaque tableau, et s'en sert pour chercher et remplacer dans + chaque tableau, et s'en sert pour chercher et remplacer dans <parameter>subject</parameter>. Si <parameter>replace</parameter> a moins - de valeurs que <parameter>search</parameter>, des chaînes vides seront utilisées - pour compléter le tableau <parameter>replace</parameter> . Si - <parameter>search</parameter> est un tableau et <parameter>replace</parameter> - est une chaîne, alors la même chaîne de remplacement sera utilisée pour chaque + de valeurs que <parameter>search</parameter>, des chaînes vides seront utilisées + pour compléter le tableau <parameter>replace</parameter> . Si + <parameter>search</parameter> est un tableau et <parameter>replace</parameter> + est une chaîne, alors la même chaîne de remplacement sera utilisée pour chaque valeur de <parameter>search</parameter>. Le contraire n'aurait pas beaucoup de sens. </para> Index: phpdoc/fr/functions/zlib.xml diff -u phpdoc/fr/functions/zlib.xml:1.5 phpdoc/fr/functions/zlib.xml:1.6 --- phpdoc/fr/functions/zlib.xml:1.5 Tue Jan 23 02:48:27 2001 +++ phpdoc/fr/functions/zlib.xml Fri Jan 26 06:43:31 2001 @@ -68,7 +68,7 @@ <function>gzclose</function> ferme le pointeur <parameter>zp</parameter>. </para> <para> - <function>gzclose</function> retourne <literal>TRUE</literal> ou + <function>gzclose</function> retourne <literal>TRUE</literal> ou <literal>FALSE</literal>, suivant le succès ou l'échec. </para> <para> @@ -208,7 +208,7 @@ <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> </funcsynopsis> <para> - <function>gzgetss</function> est identique à <function>gzgets</function>, + <function>gzgetss</function> est identique à <function>gzgets</function>, mais elle essaie de supprimer toutes les balises HTML et PHP du texte lu. </para> <para> @@ -241,8 +241,8 @@ <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> </funcsynopsis> <para> - <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz) - pour le lire ou l'écrire. Le paramètre de mode est le même + <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz) + pour le lire ou l'écrire. Le paramètre de mode est le même que dans <function>fopen</function> ("rb" ou "wb") mais il peut aussi inclure un niveau de compression ("wb9") ou une stratégie: 'f' pour les données filtrées, comme dans "wb6f", 'h' pour @@ -419,8 +419,8 @@ <paramdef>int <parameter>offset</parameter></paramdef> </funcsynopsis> <para> - <function>gzseek</function> positionne le pointeur interne du fichier - compressé <parameter>zp</parameter> à la position donnée + <function>gzseek</function> positionne le pointeur interne du fichier + compressé <parameter>zp</parameter> à la position donnée en <parameter>offset</parameter>. Equivalent à l'appel (en C) de <literal>gzseek(zp, offset, SEEK_SET)</literal>. </para> @@ -432,8 +432,8 @@ séquence de zéro jusqu'à la nouvelle position. </para> <para> - <function>gzseek</function> retourne 0 en cas de succès, sinon - retourne -1. Notez que positionner le pointeur au delà de la + <function>gzseek</function> retourne 0 en cas de succès, sinon + retourne -1. Notez que positionner le pointeur au delà de la fin du fichier est une erreur. </para> <para> @@ -519,7 +519,7 @@ <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> </funcsynopsis> <para> - <function>readgzfile</function> lit un fichier, le décompresse et + <function>readgzfile</function> lit un fichier, le décompresse et l'écrit dans la sortie standard. </para> <para> @@ -528,9 +528,9 @@ décompression est omise, et le fichier est directement affiché. </para> <para> - <function>readgzfile</function> retourne le nombre d'octets (non compressé) - lus depuis le fichier. Si une erreur survient, retourne <literal>FALSE</literal>, - et à moins que la fonction n'ai été appelée avec + <function>readgzfile</function> retourne le nombre d'octets (non compressé) + lus depuis le fichier. Si une erreur survient, retourne <literal>FALSE</literal>, + et à moins que la fonction n'ai été appelée avec @readgzfile, l'erreur est affichée. </para> <para> @@ -565,10 +565,10 @@ </funcprototype> </funcsynopsis> <para> - <function>gzcompress</function> retourne la version compressé GZ de - la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal> - en cas d'erreur. Le paramètre <parameter>level</parameter> peut - prendre des valeurs depuis 0 (pas de compression) jusqu'à 9 + <function>gzcompress</function> retourne la version compressé GZ de + la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal> + en cas d'erreur. Le paramètre <parameter>level</parameter> peut + prendre des valeurs depuis 0 (pas de compression) jusqu'à 9 (compression maximum). </para> <para> @@ -596,7 +596,7 @@ <function>gzuncompress</function> prend la chaîne <parameter>data</parameter> en entrée (compressée par <function>gzcompress</function>) et retourne la chaîne originale, - ou bien <literal>FALSE</literal> en cas d'erreur. <function>gzuncompress</function> + ou bien <literal>FALSE</literal> en cas d'erreur. <function>gzuncompress</function> retournera une erreur si la taille de la chaîne décompressée est plus de 256 fois la longueur de la chaîne compressée <parameter>data</parameter> ou plus que le paramètre optionnel @@ -604,8 +604,8 @@ </para> <note> <para> - Ceci <emphasis>n'est pas équivalent</emphasis> à une comrpession gzip, - qui inclus en plus des données d'entête. Voir <function>gzencode</function> + Ceci <emphasis>n'est pas équivalent</emphasis> à une comrpession gzip, + qui inclus en plus des données d'entête. Voir <function>gzencode</function> pour la compression gzip. </para> </note> Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.18 phpdoc/fr/functions/array.xml:1.19 --- phpdoc/fr/functions/array.xml:1.18 Tue Jan 23 02:51:52 2001 +++ phpdoc/fr/functions/array.xml Fri Jan 26 06:43:31 2001 @@ -322,7 +322,7 @@ <para> Si l'option <parameter>search_value</parameter> est spécifiée, seules les clés ayant cette valeur seront retournées. - Sinon, toutes les clés de <parameter>input</parameter> sont + Sinon, toutes les clés de <parameter>input</parameter> sont retournées. </para> <para> @@ -331,17 +331,15 @@ <programlisting role="php"> <?php $array = array(0 => 100, "couleur" => "rouge"); -array_keys($array); +array_keys($array); // retourne array(0, "couleur") - $array = array("bleu", "rouge", "vert", "bleu", "bleu"); -array_keys($array, "bleu"); -// retourne array(0, 3, 4) - -$array = array( "couleur" => array("bleu", "rouge", "vert"), +array_keys($array, "bleu"); +// retourne array(0, 3, 4) +$array = array( "couleur" => array("bleu", "rouge", "vert"), "taille" => array("petit", "moyen", "grand") ); -array_keys($array); -// retourne array("couleur", "taille") +array_keys($array); +// retourne array("couleur", "taille") ?> </programlisting> </example> @@ -767,7 +765,7 @@ <funcprototype> <funcdef>array <function>array_reverse</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>bool + <paramdef>bool <parameter><optional>preserve_keys</optional></parameter> </paramdef> </funcprototype> @@ -775,7 +773,7 @@ <para> <function>array_reverse</function> prend le tableau <parameter>array</parameter> et retourne un nouveau tableau qui contient les mêmes éléments - mais dans l'ordre inverse, en préservant les clés si le paramètre + mais dans l'ordre inverse, en préservant les clés si le paramètre <parameter>preserve_keys</parameter> vaut <literal>TRUE</literal>. </para> <para> @@ -798,7 +796,7 @@ </note> <note> <para> - Le second paramètre <parameter>preserve_keys</parameter> a été éjouté en PHP 4.0.3. + Le second paramètre <parameter>preserve_keys</parameter> a été éjouté en PHP 4.0.3. </para> </note> </para> @@ -1488,9 +1486,9 @@ <title>Exemple avec <function>count</function></title> <programlisting role="php"> <?php -$a[0] = 1; -$a[1] = 3; -$a[2] = 5; +$a[0] = 1; +$a[1] = 3; +$a[2] = 5; $result = count ($a); //$result == 3 ?> @@ -1689,11 +1687,11 @@ </funcprototype> </funcsynopsis> <para> - <function>extract</function> sert à exporter un tableau vers - la table des symboles. Elle prend un tableau associatif - <parameter>var_array</parameter> et crée les variables dont les - noms sont les index de ce tableau, et leur affecte la valeur associée. - Pour chaque paire clé/valeur, <function>extract</function> crée + <function>extract</function> sert à exporter un tableau vers + la table des symboles. Elle prend un tableau associatif + <parameter>var_array</parameter> et crée les variables dont les + noms sont les index de ce tableau, et leur affecte la valeur associée. + Pour chaque paire clé/valeur, <function>extract</function> crée une variable, avec les paramètres <parameter>extract_type</parameter> et <parameter>prefix</parameter>. </para> @@ -1747,8 +1745,8 @@ <term>EXTR_PREFIX_INVALID</term> <listitem> <simpara> - Préfixer uniquement les variables aux noms invalides ou numériques - avec le préfixe <parameter>prefix</parameter>. Ceci a été ajouté + Préfixer uniquement les variables aux noms invalides ou numériques + avec le préfixe <parameter>prefix</parameter>. Ceci a été ajouté en PHP 4.0.5. </simpara> </listitem> @@ -1756,19 +1754,19 @@ </variablelist> </para> <para> - Si <parameter>extract_type</parameter> est omis, <function>extract</function> + Si <parameter>extract_type</parameter> est omis, <function>extract</function> utilise EXTR_OVERWRITE par défault. </para> <para> Notez que <parameter>prefix</parameter> n'est nécessaire que pour les valeurs de <parameter>extract_type</parameter> suivantes : - EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat - préfixé n'est pas un nom de variable valide, il ne sera pas importé dans + EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat + préfixé n'est pas un nom de variable valide, il ne sera pas importé dans la table des symboles. </para> <para> - <function>extract</function> retourne le nombre de variables rééllement - importées dans la table des symbols. + <function>extract</function> retourne le nombre de variables rééllement + importées dans la table des symbols. </para> <para> Une utilisation possible de <function>extract</function> est l'exportation
Index: phpdoc/fr/functions/datetime.xml diff -u phpdoc/fr/functions/datetime.xml:1.9 phpdoc/fr/functions/datetime.xml:1.10 --- phpdoc/fr/functions/datetime.xml:1.9 Tue Jan 23 02:51:52 2001 +++ phpdoc/fr/functions/datetime.xml Fri Jan 26 06:43:31 2001 @@ -85,7 +85,7 @@ </listitem> <listitem> <simpara> - d - Jour du mois, sur deux chiffres (éventuellement avec un zéros) : + d - Jour du mois, sur deux chiffres (éventuellement avec un zéro) : "01" à "31" </simpara> </listitem> @@ -899,8 +899,8 @@ </itemizedlist> <note> <para> - Tous les caractères suivants ne sont pas toujours supportés par - toutes les librairies C. Dans ce cas, ils ne seront pas supportés + Tous les caractères suivants ne sont pas toujours supportés par + toutes les librairies C. Dans ce cas, ils ne seront pas supportés par PHP non plus. </para> </note> Index: phpdoc/fr/functions/session.xml diff -u phpdoc/fr/functions/session.xml:1.6 phpdoc/fr/functions/session.xml:1.7 --- phpdoc/fr/functions/session.xml:1.6 Tue Jan 23 02:48:27 2001 +++ phpdoc/fr/functions/session.xml Fri Jan 26 06:43:31 2001 @@ -41,8 +41,8 @@ </para> <note> <para> - Depuis PHP 4.0.3, <link - linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours + Depuis PHP 4.0.3, + <link linkend="ini.track-vars"><literal>track_vars</literal></link> est toujours activée. </para> </note> @@ -126,6 +126,15 @@ <literal>session_name=session_id</literal>, ou bien, c'est une chaîne vide. </para> + <note> + <para> + La fonction qui gérera l'écriture des données ne sera appelée + qu'une fois le script aura envoyé toutes ses données. Ainsi, + les affichages tentés par cette fonction ne pourront jamais + être recus par le navigateur. Si un tel affichage est nécessaire, + il est conseillé d'écrire les debugs dans un fichier. + </para> + </note> <para> L'exemple suivant montre comment enregistrer une variable, et comment relier correctement des pages avec SID. @@ -141,8 +150,8 @@ # le <?=SID> est nécessaire pour transmettre l'identifiant de session # au cas oú les utilisateurs auraient inactivé les cookies ?> -Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?> </programlisting> + Pour continuer, <A HREF="nextpage.php?<?=SID"?>clique ici</?> </example> </para> <para> @@ -181,7 +190,7 @@ <warning> <para> Si le dossier que vous utilisez a les droits de lecture universels, - comme <filename>/tmp</filename> (valeur par défaut), les autres utilisateurs + comme <filename>/tmp</filename> (valeur par défaut), les autres utilisateurs du serveur peuvent aussi lire ces fichiers, et s'imiscer dans vos sessions. </para> </warning> @@ -322,11 +331,11 @@ session passé par une variable GET ou par un cookie) </simpara> <simpara> - Cette fonction retourne toujours <literal>TRUE</literal>. + <function>session_start</function> retourne toujours <literal>TRUE</literal>. </simpara> <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_start</function> a été ajoutée en PHP 4.0. </para> </note> </refsect1> @@ -351,7 +360,8 @@ données associées à la session courante. </simpara> <simpara> - Cette fonction retourne <literal>TRUE</literal> en cas de succès, et <literal>FALSE</literal> sinon. + <function>session_destroy</function> retourne <literal>TRUE</literal> en + cas de succès, et <literal>FALSE</literal> sinon. </simpara> </refsect1> </refentry> @@ -397,7 +407,8 @@ </example> <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_name</function> a été ajoutée + en PHP 4.0. </para> </note> </refsect1> @@ -423,7 +434,8 @@ est fourni, ce module sera utilisé à la place du courant. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_module_name</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -460,7 +472,8 @@ </note> <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_save_path</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -490,7 +503,8 @@ son identifiant, comme chaîne à ajouter dans les URL. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_id</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -521,11 +535,12 @@ des chaînes ou d'autre tableau (récursif). </para> <para> - Cette fonction retourne <literal>TRUE</literal> lorsque la variable est correctement - enregistrée. + <function>session_register</function> retourne <literal>TRUE</literal> lorsque + la variable est correctement enregistrée. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_register</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -551,12 +566,13 @@ nommée <parameter>name</parameter> dans la session courante. </para> <para> - <function>session_unregister</function> retourne <literal>TRUE</literal> (vrai) + <function>session_unregister</function> retourne <literal>TRUE</literal> lorsque la variable a été correctement supprimée de la session. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_unregister</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -599,12 +615,13 @@ </funcprototype> </funcsynopsis> <para> - <function>session_is_registered</function> retourne <literal>TRUE</literal> si il y - a une variable du nom de <parameter>name</parameter> + <function>session_is_registered</function> retourne <literal>TRUE</literal> + s'il y a une variable du nom de <parameter>name</parameter> enregistrée dans la session courante. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_is_registered</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -703,7 +720,8 @@ et affecte les valeurs des variables de session. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_decode</function> a été ajoutée + en PHP 4.0. </para> </note> </para> @@ -727,7 +745,8 @@ session dans une chaîne. <note> <para> - Cette fonction a été ajoutée dans PHP 4.0. + <function>session_encode</function> a été ajoutée + en PHP 4.0. </para> </note> </para> Index: phpdoc/fr/functions/sockets.xml diff -u phpdoc/fr/functions/sockets.xml:1.4 phpdoc/fr/functions/sockets.xml:1.5 --- phpdoc/fr/functions/sockets.xml:1.4 Mon Jan 22 03:58:33 2001 +++ phpdoc/fr/functions/sockets.xml Fri Jan 26 06:43:31 2001 @@ -8,6 +8,12 @@ un serveur aussi bien qu'un client. </simpara> <para> + Les fonctions socket décrites ici sont rassemblées dans une extension + PHP. Pour être activées, il faut utiliser l'option de compilation + <option role="configure">--enable-sockets</option> au script + <command>configure</command>. + </para> + <para> Pour une interface client plus générique, reportez vous à <function>fsockopen</function> et <function>pfsockopen</function>. </para> Index: phpdoc/fr/functions/strings.xml diff -u phpdoc/fr/functions/strings.xml:1.19 phpdoc/fr/functions/strings.xml:1.20 --- phpdoc/fr/functions/strings.xml:1.19 Tue Jan 23 02:48:27 2001 +++ phpdoc/fr/functions/strings.xml Fri Jan 26 06:43:31 2001 @@ -2951,7 +2951,7 @@ <funcdef>mixed <function>str_replace</function></funcdef> <paramdef>mixed <parameter>search</parameter></paramdef> <paramdef>mixed <parameter>replace</parameter></paramdef> - <paramdef>mixed <parameter>subject</parameter></paramdef> + <paramdef>mixed <parameter>subject</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2962,23 +2962,23 @@ utiliser <function>ereg_replace</function>. </para> <para> - En PHP 4.0.5 et plus récent, chaque paramètre de - <function>str_replace</function> peut être un tableau. + En PHP 4.0.5 et plus récent, chaque paramètre de + <function>str_replace</function> peut être un tableau. </para> <para> - Si <parameter>subject</parameter> est un tableau, alors le remplacement - est effectué pour chaque valeur de <parameter>subject</parameter>, et la - valeur retourné sera un tableau. + Si <parameter>subject</parameter> est un tableau, alors le remplacement + est effectué pour chaque valeur de <parameter>subject</parameter>, et la + valeur retourné sera un tableau. </para> <para> Si <parameter>search</parameter> et <parameter>replace</parameter> sont des tableaux, alors <function>str_replace</function> prend une valeur dans - chaque tableau, et s'en sert pour chercher et remplacer dans + chaque tableau, et s'en sert pour chercher et remplacer dans <parameter>subject</parameter>. Si <parameter>replace</parameter> a moins - de valeurs que <parameter>search</parameter>, des chaînes vides seront utilisées - pour compléter le tableau <parameter>replace</parameter> . Si - <parameter>search</parameter> est un tableau et <parameter>replace</parameter> - est une chaîne, alors la même chaîne de remplacement sera utilisée pour chaque + de valeurs que <parameter>search</parameter>, des chaînes vides seront utilisées + pour compléter le tableau <parameter>replace</parameter> . Si + <parameter>search</parameter> est un tableau et <parameter>replace</parameter> + est une chaîne, alors la même chaîne de remplacement sera utilisée pour chaque valeur de <parameter>search</parameter>. Le contraire n'aurait pas beaucoup de sens. </para> Index: phpdoc/fr/functions/zlib.xml diff -u phpdoc/fr/functions/zlib.xml:1.5 phpdoc/fr/functions/zlib.xml:1.6 --- phpdoc/fr/functions/zlib.xml:1.5 Tue Jan 23 02:48:27 2001 +++ phpdoc/fr/functions/zlib.xml Fri Jan 26 06:43:31 2001 @@ -68,7 +68,7 @@ <function>gzclose</function> ferme le pointeur <parameter>zp</parameter>. </para> <para> - <function>gzclose</function> retourne <literal>TRUE</literal> ou + <function>gzclose</function> retourne <literal>TRUE</literal> ou <literal>FALSE</literal>, suivant le succès ou l'échec. </para> <para> @@ -208,7 +208,7 @@ <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> </funcsynopsis> <para> - <function>gzgetss</function> est identique à <function>gzgets</function>, + <function>gzgetss</function> est identique à <function>gzgets</function>, mais elle essaie de supprimer toutes les balises HTML et PHP du texte lu. </para> <para> @@ -241,8 +241,8 @@ <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> </funcsynopsis> <para> - <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz) - pour le lire ou l'écrire. Le paramètre de mode est le même + <function>gzopen</function> ouvre un fichier compressé avec gzip (.gz) + pour le lire ou l'écrire. Le paramètre de mode est le même que dans <function>fopen</function> ("rb" ou "wb") mais il peut aussi inclure un niveau de compression ("wb9") ou une stratégie: 'f' pour les données filtrées, comme dans "wb6f", 'h' pour @@ -419,8 +419,8 @@ <paramdef>int <parameter>offset</parameter></paramdef> </funcsynopsis> <para> - <function>gzseek</function> positionne le pointeur interne du fichier - compressé <parameter>zp</parameter> à la position donnée + <function>gzseek</function> positionne le pointeur interne du fichier + compressé <parameter>zp</parameter> à la position donnée en <parameter>offset</parameter>. Equivalent à l'appel (en C) de <literal>gzseek(zp, offset, SEEK_SET)</literal>. </para> @@ -432,8 +432,8 @@ séquence de zéro jusqu'à la nouvelle position. </para> <para> - <function>gzseek</function> retourne 0 en cas de succès, sinon - retourne -1. Notez que positionner le pointeur au delà de la + <function>gzseek</function> retourne 0 en cas de succès, sinon + retourne -1. Notez que positionner le pointeur au delà de la fin du fichier est une erreur. </para> <para> @@ -519,7 +519,7 @@ <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> </funcsynopsis> <para> - <function>readgzfile</function> lit un fichier, le décompresse et + <function>readgzfile</function> lit un fichier, le décompresse et l'écrit dans la sortie standard. </para> <para> @@ -528,9 +528,9 @@ décompression est omise, et le fichier est directement affiché. </para> <para> - <function>readgzfile</function> retourne le nombre d'octets (non compressé) - lus depuis le fichier. Si une erreur survient, retourne <literal>FALSE</literal>, - et à moins que la fonction n'ai été appelée avec + <function>readgzfile</function> retourne le nombre d'octets (non compressé) + lus depuis le fichier. Si une erreur survient, retourne <literal>FALSE</literal>, + et à moins que la fonction n'ai été appelée avec @readgzfile, l'erreur est affichée. </para> <para> @@ -565,10 +565,10 @@ </funcprototype> </funcsynopsis> <para> - <function>gzcompress</function> retourne la version compressé GZ de - la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal> - en cas d'erreur. Le paramètre <parameter>level</parameter> peut - prendre des valeurs depuis 0 (pas de compression) jusqu'à 9 + <function>gzcompress</function> retourne la version compressé GZ de + la chaîne <parameter>data</parameter>, ou <literal>FALSE</literal> + en cas d'erreur. Le paramètre <parameter>level</parameter> peut + prendre des valeurs depuis 0 (pas de compression) jusqu'à 9 (compression maximum). </para> <para> @@ -596,7 +596,7 @@ <function>gzuncompress</function> prend la chaîne <parameter>data</parameter> en entrée (compressée par <function>gzcompress</function>) et retourne la chaîne originale, - ou bien <literal>FALSE</literal> en cas d'erreur. <function>gzuncompress</function> + ou bien <literal>FALSE</literal> en cas d'erreur. <function>gzuncompress</function> retournera une erreur si la taille de la chaîne décompressée est plus de 256 fois la longueur de la chaîne compressée <parameter>data</parameter> ou plus que le paramètre optionnel @@ -604,8 +604,8 @@ </para> <note> <para> - Ceci <emphasis>n'est pas équivalent</emphasis> à une comrpession gzip, - qui inclus en plus des données d'entête. Voir <function>gzencode</function> + Ceci <emphasis>n'est pas équivalent</emphasis> à une comrpession gzip, + qui inclus en plus des données d'entête. Voir <function>gzencode</function> pour la compression gzip. </para> </note> Index: phpdoc/fr/functions/array.xml diff -u phpdoc/fr/functions/array.xml:1.18 phpdoc/fr/functions/array.xml:1.19 --- phpdoc/fr/functions/array.xml:1.18 Tue Jan 23 02:51:52 2001 +++ phpdoc/fr/functions/array.xml Fri Jan 26 06:43:31 2001 @@ -322,7 +322,7 @@ <para> Si l'option <parameter>search_value</parameter> est spécifiée, seules les clés ayant cette valeur seront retournées. - Sinon, toutes les clés de <parameter>input</parameter> sont + Sinon, toutes les clés de <parameter>input</parameter> sont retournées. </para> <para> @@ -331,17 +331,15 @@ <programlisting role="php"> <?php $array = array(0 => 100, "couleur" => "rouge"); -array_keys($array); +array_keys($array); // retourne array(0, "couleur") - $array = array("bleu", "rouge", "vert", "bleu", "bleu"); -array_keys($array, "bleu"); -// retourne array(0, 3, 4) - -$array = array( "couleur" => array("bleu", "rouge", "vert"), +array_keys($array, "bleu"); +// retourne array(0, 3, 4) +$array = array( "couleur" => array("bleu", "rouge", "vert"), "taille" => array("petit", "moyen", "grand") ); -array_keys($array); -// retourne array("couleur", "taille") +array_keys($array); +// retourne array("couleur", "taille") ?> </programlisting> </example> @@ -767,7 +765,7 @@ <funcprototype> <funcdef>array <function>array_reverse</function></funcdef> <paramdef>array <parameter>array</parameter></paramdef> - <paramdef>bool + <paramdef>bool <parameter><optional>preserve_keys</optional></parameter> </paramdef> </funcprototype> @@ -775,7 +773,7 @@ <para> <function>array_reverse</function> prend le tableau <parameter>array</parameter> et retourne un nouveau tableau qui contient les mêmes éléments - mais dans l'ordre inverse, en préservant les clés si le paramètre + mais dans l'ordre inverse, en préservant les clés si le paramètre <parameter>preserve_keys</parameter> vaut <literal>TRUE</literal>. </para> <para> @@ -798,7 +796,7 @@ </note> <note> <para> - Le second paramètre <parameter>preserve_keys</parameter> a été éjouté en PHP 4.0.3. + Le second paramètre <parameter>preserve_keys</parameter> a été éjouté en PHP 4.0.3. </para> </note> </para> @@ -1488,9 +1486,9 @@ <title>Exemple avec <function>count</function></title> <programlisting role="php"> <?php -$a[0] = 1; -$a[1] = 3; -$a[2] = 5; +$a[0] = 1; +$a[1] = 3; +$a[2] = 5; $result = count ($a); //$result == 3 ?> @@ -1689,11 +1687,11 @@ </funcprototype> </funcsynopsis> <para> - <function>extract</function> sert à exporter un tableau vers - la table des symboles. Elle prend un tableau associatif - <parameter>var_array</parameter> et crée les variables dont les - noms sont les index de ce tableau, et leur affecte la valeur associée. - Pour chaque paire clé/valeur, <function>extract</function> crée + <function>extract</function> sert à exporter un tableau vers + la table des symboles. Elle prend un tableau associatif + <parameter>var_array</parameter> et crée les variables dont les + noms sont les index de ce tableau, et leur affecte la valeur associée. + Pour chaque paire clé/valeur, <function>extract</function> crée une variable, avec les paramètres <parameter>extract_type</parameter> et <parameter>prefix</parameter>. </para> @@ -1747,8 +1745,8 @@ <term>EXTR_PREFIX_INVALID</term> <listitem> <simpara> - Préfixer uniquement les variables aux noms invalides ou numériques - avec le préfixe <parameter>prefix</parameter>. Ceci a été ajouté + Préfixer uniquement les variables aux noms invalides ou numériques + avec le préfixe <parameter>prefix</parameter>. Ceci a été ajouté en PHP 4.0.5. </simpara> </listitem> @@ -1756,19 +1754,19 @@ </variablelist> </para> <para> - Si <parameter>extract_type</parameter> est omis, <function>extract</function> + Si <parameter>extract_type</parameter> est omis, <function>extract</function> utilise EXTR_OVERWRITE par défault. </para> <para> Notez que <parameter>prefix</parameter> n'est nécessaire que pour les valeurs de <parameter>extract_type</parameter> suivantes : - EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat - préfixé n'est pas un nom de variable valide, il ne sera pas importé dans + EXTR_PREFIX_SAME, EXTR_PREFIX_ALL ou EXTR_PREFIX_INVALID. Le résultat + préfixé n'est pas un nom de variable valide, il ne sera pas importé dans la table des symboles. </para> <para> - <function>extract</function> retourne le nombre de variables rééllement - importées dans la table des symbols. + <function>extract</function> retourne le nombre de variables rééllement + importées dans la table des symbols. </para> <para> Une utilisation possible de <function>extract</function> est l'exportation