cvs: phpdoc /fr/functions zlib.xml
| From: | Damien Seguy | Date: | Tue, 30 Oct 2001 19:37:04 +0000 |
| Subject: | cvs: phpdoc /fr/functions zlib.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338361@lists.php.net to get a copy of this message | ||
dams Tue Oct 30 14:37:04 2001 EDT
Modified files:
/phpdoc/fr/functions zlib.xml
Log:
Adding zml thingy.Removed minot typos
Index: phpdoc/fr/functions/zlib.xml diff -u phpdoc/fr/functions/zlib.xml:1.10 phpdoc/fr/functions/zlib.xml:1.11 --- phpdoc/fr/functions/zlib.xml:1.10 Sat Jul 7 18:22:30 2001 +++ phpdoc/fr/functions/zlib.xml Tue Oct 30 14:37:04 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> <reference id="ref.zlib"> <title>Zlib (Compression)</title> <titleabbrev>Zlib</titleabbrev> @@ -10,7 +12,7 @@ Il faut utiliser la librairie zlib, de version >= 1.0.9. </para> <para> - Ce module contient des versions de la plus part des fonctions du chapitre + Ce module contient des versions de la plupart des fonctions du chapitre <link linkend="ref.filesystem">système de fichier</link>. Mais celles-ci fonctionnent non seulement avec des fichiers compressés, mais aussi des fichiers décompressés @@ -42,7 +44,7 @@ // Affiche le reste du fichier gzpassthru($zp); print "\n"; - // ouvre le fichier, et affiche le contenu (deuxième passe) + // ouvre le fichier et affiche le contenu (deuxième passe) if (readgzfile($filename) != strlen($s)) { echo "Error with zlib functions!"; } @@ -61,8 +63,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzclose</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzclose</function> ferme le pointeur <parameter>zp</parameter>. @@ -72,7 +76,7 @@ &false;, suivant le succès ou l'échec. </para> <para> - Le pointeur de fichier compressé doit être valide, et doit + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> @@ -86,8 +90,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzeof</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzeof</function> retourne &true; si le pointeur @@ -95,7 +101,7 @@ est à la fin du fichier, sinon retourne &false;. </para> <para> - Le pointeur de fichier compressé doit être valide, et doit + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> @@ -111,9 +117,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>gzfile</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>use_include_path</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzfile</function> est identique à @@ -122,24 +131,31 @@ </para> <para> Vous pouvez aussi utiliser le deuxième paramètre optionnel en - le mettant à "1", si vous voulez rechercher le fichier dans le dossier + le mettant à "1", si vous voulez rechercher le fichier dans le + dossier <link linkend="ini.include-path">include_path</link>. </para> <para> - Voir aussi <function>readgzfile</function>, et <function>gzopen</function>. + Voir aussi + <function>readgzfile</function> et + <function>gzopen</function>. </para> </refsect1> </refentry> <refentry id="function.gzgetc"> <refnamediv> <refname>gzgetc</refname> - <refpurpose>Lit un caractère d'un fichier compressé.</refpurpose> + <refpurpose> + Lit un caractère d'un fichier compressé. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzgetc</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzgetc</function> retourne une chaîne @@ -150,7 +166,7 @@ la fin du fichier (voir <function>gzeof</function>). </para> <para> - Le pointeur de fichier compressé doit être valide, et + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> @@ -169,9 +185,11 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzgets</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzgets</function> retourne une chaîne @@ -179,21 +197,23 @@ à length - 1 octets, lue depuis de fichier référencé par le pointeur de fichier <parameter>zp</parameter>. La lecture s'interrompt lorsque - <parameter>length</parameter> - 1 octets ont été lus, ou bien - lorsqu'une nouvelle ligne a été rencontrée, ou bien - lorsque la fin du fichier a été atteinte. + <parameter>length</parameter> - 1 octets ont été lus, ou + bien lorsqu'une nouvelle ligne a été rencontrée, ou + bien lorsque la fin du fichier a été atteinte. </para> <para> Si une erreur survient, retourne &false;. </para> <para> - Le pointeur de fichier compressé doit être valide, et + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> <para> - Voir aussi <function>gzopen</function>, - <function>gzgetc</function>, et <function>fgets</function>. + Voir aussi + <function>gzopen</function>, + <function>gzgetc</function> et + <function>fgets</function>. </para> </refsect1> </refentry> @@ -207,10 +227,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzgetss</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzgetss</function> est identique à <function>gzgets</function>, @@ -218,7 +240,8 @@ depuis <parameter>zp</parameter>. </para> <para> - Vous pouvez utiliser le troisième argument optionnel pour indiquer + Vous pouvez utiliser le troisième argument optionnel + <parameter>allowable_tags</parameter> pour indiquer les balises qui ne doivent pas être supprimées. <note> <para> @@ -228,8 +251,10 @@ </note> </para> <para> - Voir aussi <function>gzgets</function>, - <function>gzopen</function>, et <function>strip_tags</function>. + Voir aussi + <function>gzgets</function>, + <function>gzopen</function> et + <function>strip_tags</function>. </para> </refsect1> </refentry> @@ -241,20 +266,23 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzopen</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>use_include_path</optional></parameter></paramdef> + </funcprototype> </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 - 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 - Huffman seul , comme dans "wb1h". (Voir la description de deflateInit2 - dans zlib.h pour plus de détails a propos des paramètres - de stratégie). + <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 Huffman seul , comme dans "wb1h". (Voir la description de + deflateInit2 dans zlib.h pour plus de détails a propos des + paramètres de stratégie). </para> <para> <function>gzopen</function> peut être utilisé pour @@ -278,16 +306,17 @@ </para> <para> <example> - <title>Exemple <function>gzopen</function></title> + <title>Exemple avec<function>gzopen</function></title> <programlisting role="php"> <?php -$fp = gzopen("/tmp/file.gz", "r"); + $fp = gzopen("/tmp/file.gz", "r"); ?> </programlisting> </example> </para> <para> - Voir aussi <function>gzclose</function>. + Voir aussi + <function>gzclose</function>. </para> </refsect1> </refentry> @@ -301,20 +330,22 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzpassthru</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzpassthru</function> lit toutes les informations d'un fichier compressé jusqu'à la fin du fichier - <parameter>zp</parameter>, et écrit le résultat + <parameter>zp</parameter> et écrit le résultat décompressé dans la sortie standard. </para> <para> Si une erreur survient, retourne &false;. </para> <para> - Le pointeur de fichier doit être valide, et avoir été + Le pointeur de fichier doit être valide et avoir été ouvert par <function>gzopen</function>. </para> <para> @@ -332,13 +363,15 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzputs</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>string <parameter>str</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> - <function>gzputs</function>est un alias de <function>gzwrite</function>, et + <function>gzputs</function>est un alias de <function>gzwrite</function> et lui est identique en tous points. </para> </refsect1> @@ -351,9 +384,11 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzread</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>gzread</function> lit jusqu'à <parameter>length</parameter> @@ -367,11 +402,11 @@ <informalexample> <programlisting role="php"> <?php -// lis le contenu d'un fichier compressé et le met dans une chaîne -$filename = "/usr/local/something.txt.gz"; -$zd = gzopen( $filename, "r" ); -$contents = gzread( $zd, 10000 ); -gzclose( $zd ); +// lit le contenu d'un fichier compressé et le met dans une chaîne + $filename = "/usr/local/something.txt.gz"; + $zd = gzopen( $filename, "r" ); + $contents = gzread( $zd, 10000 ); + gzclose( $zd ); ?> </programlisting> </informalexample> @@ -395,8 +430,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzrewind</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzrewind</function> positionne le pointeur interne du fichier @@ -406,12 +443,14 @@ Si une erreur survient, retourne 0. </para> <para> - Le pointeur de fichier doit être valide, et avoir + Le pointeur de fichier doit être valide et avoir été retourné par la fonction <function>gzopen</function>. </para> <para> - Voir aussi <function>gzseek</function> et <function>gztell</function>. + Voir aussi + <function>gzseek</function> et + <function>gztell</function>. </para> </refsect1> </refentry> @@ -425,30 +464,35 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzseek</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <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>. + 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> <para> Si le fichier est ouvert en lecture seule, cette fonction émulée peut être extrêmement lente. Si le fichier est ouvert en lecture, seul le déplacement avant - (forward seek) sont acceptés. gzseek compresse alors une - séquence de zéro jusqu'à la nouvelle position. + (forward seek) sont acceptés. <function>gzseek</function> compresse + alors une 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 - fin du fichier est une erreur. + <function>gzseek</function> retourne <literal>0</literal> en cas de + succès, sinon retourne <literal>-1</literal>. Notez que + positionner le pointeur au-delà de la fin du fichier est une erreur. </para> <para> - Voir aussi <function>gztell</function> et <function>gzrewind</function>. + Voir aussi + <function>gztell</function> et + <function>gzrewind</function>. </para> </refsect1> </refentry> @@ -460,8 +504,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gztell</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gztell</function> retourne la position du pointeur interne @@ -472,7 +518,7 @@ Si une erreur survient, retourne &false;. </para> <para> - Le pointeur de fichier doit être valide, et doit avoir + Le pointeur de fichier doit être valide et doit avoir été retourné par la fonction <function>gzopen</function>. </para> @@ -492,10 +538,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzwrite</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>string <parameter>string</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>gzwrite</function> écrit le contenu de la chaîne @@ -507,10 +555,10 @@ la fin de la chaîne a été atteinte. </simpara> <simpara> - Notez que si l'argument <parameter>length</parameter> est donnée, + Notez que si l'argument <parameter>length</parameter> est donné, alors l'option <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link> - sera ignorée et les slashes ne seront pas supprimés de + sera ignorée et les slash ne seront pas supprimés de la chaîne <parameter>string</parameter>. </simpara> <simpara> @@ -529,9 +577,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>readgzfile</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>use_include_path</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>readgzfile</function> lit un fichier, le décompresse et @@ -540,17 +591,18 @@ <para> <function>readgzfile</function> peut être utilisé pour lire un fichier qui n'est pas au format gzip, car dans ce cas, la - décompression est omise, et le fichier est directement affiché. + 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 &false;, - et à moins que la fonction n'ai été appelée avec - @readgzfile, l'erreur est affichée. + <function>readgzfile</function> retourne le nombre d'octets (non + compressé) lus depuis le fichier. Si une erreur survient, retourne + &false;, et à moins que la fonction n'ai été + appelée avec @readgzfile, l'erreur est affichée. </para> <para> Le fichier <parameter>filename</parameter> sera ouvert et son contenu - sera écrit danas la sortie standard. + sera écrit dans la sortie standard. </para> <para> Vous pouvez utiliser le paramètre optionnel en le mettant @@ -568,7 +620,7 @@ <refentry id="function.gzcompress"> <refnamediv> <refname>gzcompress</refname> - <refpurpose>Compresse une chaˆne (ZLIB)</refpurpose> + <refpurpose>Compresse une chaîne (ZLIB)</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -583,19 +635,21 @@ </funcsynopsis> <para> <function>gzcompress</function> retourne la version compressé avec - le format de données ZLIB de la chaîne <parameter>data</parameter>, - ou &false; en cas d'erreur. Le paramètre - <parameter>level</parameter> peut prendre des valeurs depuis 0 - (pas de compression) jusqu'à 9 (compression maximum). + le format de données ZLIB de la chaîne + <parameter>data</parameter>, ou &false; en cas d'erreur. Le + paramètre <parameter>level</parameter> peut prendre des valeurs + depuis <literal>0</literal> (pas de compression) jusqu'à + <literal>9</literal> (compression maximum). </para> <para> Pour plus de détails sur la compression ZLIB et son algorithme, - reportez vous au document de spécifications - <ulink url="&url.rfc1950;">ZLIB Compressed Data Format Specification version 3.3</ulink> - (RFC 1950). + reportez-vous au document de spécifications + <ulink url="&url.rfc1950;">ZLIB Compressed Data Format Specification + version 3.3</ulink> (RFC 1950). </para> <para> - Voir aussi <function>gzdeflate</function>, + Voir aussi + <function>gzdeflate</function>, <function>gzinflate</function>, <function>gzuncompress</function> et <function>gzencode</function>. @@ -605,7 +659,9 @@ <refentry id="function.gzuncompress"> <refnamediv> <refname>gzuncompress</refname> - <refpurpose>Décompresse une chaîne gz-compressée</refpurpose> + <refpurpose> + Décompresse une chaîne gz-compressée + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -623,20 +679,23 @@ <parameter>data</parameter> en entrée (compressée par <function>gzcompress</function>) et retourne la chaîne originale, ou bien &false; en cas d'erreur. <function>gzuncompress</function> - retournera une erreur si la taille de la chaîne décompressée + 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 <parameter>length</parameter>. </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 compression gzip, qui inclus en plus des données + d'en-tête. Voir <function>gzencode</function> pour la compression gzip. </para> </note> <para> - Voir aussi <function>gzdeflate</function>, + Voir aussi + <function>gzdeflate</function>, <function>gzinflate</function>, <function>gzcompress</function> et <function>gzencode</function>. @@ -663,15 +722,15 @@ <function>gzdeflate</function> retourne la version compressée de <parameter>data</parameter> en utilisant le format de données DEFLATE, ou &false; si une erreur est survenue. - Le paramètre optionnel <parameter>level</parameter> peut prendre des - valeurs de 0 (pas de compression) jusqu'à 9 (compression maximum, - vitesse minimum). + Le paramètre optionnel <parameter>level</parameter> peut prendre + des valeurs de 0 (pas de compression) jusqu'à 9 (compression + maximum, vitesse minimum). </para> <para> Pour plus de détails sur la compression ZLIB et son algorithme, - reportez vous au document de spécifications - <ulink url="&url.rfc1951;">DEFLATE Compressed Data Format Specification version 1.3</ulink> - (RFC 1951). + reportez-vous au document de spécifications + <ulink url="&url.rfc1951;">DEFLATE Compressed Data Format Specification + version 1.3</ulink> (RFC 1951). </para> <para> Voir aussi @@ -701,17 +760,19 @@ <para> <function>gzinflate</function> décompresse la chaîne <parameter>data</parameter>. <parameter>data</parameter> - doit avoir été compressée avec <function>gzdeflate</function>. + doit avoir été compressée avec + <function>gzdeflate</function>. <function>gzinflate</function> retourne les données originales décompressées, ou bien &false; si une erreur survient. <function>gzinflate</function> - retournera une erreur si les données décompressées sont plus - grandes que 256 fois la taille des données compressées - <parameter>data</parameter> ou que le paramètre + retournera une erreur si les données décompressées + sont plus grandes que 256 fois la taille des données + compressées <parameter>data</parameter> ou que le paramètre optionnel <parameter>length</parameter>. </para> <para> - Voir aussi <function>gzcompress</function>. + Voir aussi + <function>gzcompress</function>, <function>gzuncompress</function>, <function>gzdeflate</function> et <function>gzencode</function>. @@ -721,7 +782,9 @@ <refentry id="function.gzencode"> <refnamediv> <refname>gzencode</refname> - <refpurpose>Crée une chaîne compréssée avec gzip</refpurpose> + <refpurpose> + Crée une chaîne compressée avec gzip + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -745,9 +808,9 @@ 1. </para> <para> - La chaîne retournée contient les entêtes appropriés et la - structure de données demandées par gzip pour faire un - fichier .gz file, e.g.: + La chaîne retournée contient les en-têtes + appropriées et la structure de données demandées par + gzip pour faire un fichier .gz file, e.g.: <example> <title>Création d'un fichier .gz (gzip)</title> <programlisting role="php"> @@ -762,9 +825,9 @@ </example> </para> <para> - Pour plus de détails sur le format GZIP, reportez vous à : - <ulink url="&url.rfc1952">GZIP file format specification version 4.3</ulink> - (RFC 1952). + Pour plus de détails sur le format GZIP, reportez-vous à : + <ulink url="&url.rfc1952;">GZIP file format specification version + 4.3</ulink> (RFC 1952). </para> <para> Voir aussi
Index: phpdoc/fr/functions/zlib.xml diff -u phpdoc/fr/functions/zlib.xml:1.10 phpdoc/fr/functions/zlib.xml:1.11 --- phpdoc/fr/functions/zlib.xml:1.10 Sat Jul 7 18:22:30 2001 +++ phpdoc/fr/functions/zlib.xml Tue Oct 30 14:37:04 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.11 $ --> <reference id="ref.zlib"> <title>Zlib (Compression)</title> <titleabbrev>Zlib</titleabbrev> @@ -10,7 +12,7 @@ Il faut utiliser la librairie zlib, de version >= 1.0.9. </para> <para> - Ce module contient des versions de la plus part des fonctions du chapitre + Ce module contient des versions de la plupart des fonctions du chapitre <link linkend="ref.filesystem">système de fichier</link>. Mais celles-ci fonctionnent non seulement avec des fichiers compressés, mais aussi des fichiers décompressés @@ -42,7 +44,7 @@ // Affiche le reste du fichier gzpassthru($zp); print "\n"; - // ouvre le fichier, et affiche le contenu (deuxième passe) + // ouvre le fichier et affiche le contenu (deuxième passe) if (readgzfile($filename) != strlen($s)) { echo "Error with zlib functions!"; } @@ -61,8 +63,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzclose</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzclose</function> ferme le pointeur <parameter>zp</parameter>. @@ -72,7 +76,7 @@ &false;, suivant le succès ou l'échec. </para> <para> - Le pointeur de fichier compressé doit être valide, et doit + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> @@ -86,8 +90,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzeof</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzeof</function> retourne &true; si le pointeur @@ -95,7 +101,7 @@ est à la fin du fichier, sinon retourne &false;. </para> <para> - Le pointeur de fichier compressé doit être valide, et doit + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> @@ -111,9 +117,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>array <function>gzfile</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>use_include_path</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzfile</function> est identique à @@ -122,24 +131,31 @@ </para> <para> Vous pouvez aussi utiliser le deuxième paramètre optionnel en - le mettant à "1", si vous voulez rechercher le fichier dans le dossier + le mettant à "1", si vous voulez rechercher le fichier dans le + dossier <link linkend="ini.include-path">include_path</link>. </para> <para> - Voir aussi <function>readgzfile</function>, et <function>gzopen</function>. + Voir aussi + <function>readgzfile</function> et + <function>gzopen</function>. </para> </refsect1> </refentry> <refentry id="function.gzgetc"> <refnamediv> <refname>gzgetc</refname> - <refpurpose>Lit un caractère d'un fichier compressé.</refpurpose> + <refpurpose> + Lit un caractère d'un fichier compressé. + </refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzgetc</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzgetc</function> retourne une chaîne @@ -150,7 +166,7 @@ la fin du fichier (voir <function>gzeof</function>). </para> <para> - Le pointeur de fichier compressé doit être valide, et + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> @@ -169,9 +185,11 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzgets</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzgets</function> retourne une chaîne @@ -179,21 +197,23 @@ à length - 1 octets, lue depuis de fichier référencé par le pointeur de fichier <parameter>zp</parameter>. La lecture s'interrompt lorsque - <parameter>length</parameter> - 1 octets ont été lus, ou bien - lorsqu'une nouvelle ligne a été rencontrée, ou bien - lorsque la fin du fichier a été atteinte. + <parameter>length</parameter> - 1 octets ont été lus, ou + bien lorsqu'une nouvelle ligne a été rencontrée, ou + bien lorsque la fin du fichier a été atteinte. </para> <para> Si une erreur survient, retourne &false;. </para> <para> - Le pointeur de fichier compressé doit être valide, et + Le pointeur de fichier compressé doit être valide et doit référencer un fichier qui a été ouvert par <function>gzopen</function>. </para> <para> - Voir aussi <function>gzopen</function>, - <function>gzgetc</function>, et <function>fgets</function>. + Voir aussi + <function>gzopen</function>, + <function>gzgetc</function> et + <function>fgets</function>. </para> </refsect1> </refentry> @@ -207,10 +227,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzgetss</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> <paramdef>string <parameter><optional>allowable_tags</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzgetss</function> est identique à <function>gzgets</function>, @@ -218,7 +240,8 @@ depuis <parameter>zp</parameter>. </para> <para> - Vous pouvez utiliser le troisième argument optionnel pour indiquer + Vous pouvez utiliser le troisième argument optionnel + <parameter>allowable_tags</parameter> pour indiquer les balises qui ne doivent pas être supprimées. <note> <para> @@ -228,8 +251,10 @@ </note> </para> <para> - Voir aussi <function>gzgets</function>, - <function>gzopen</function>, et <function>strip_tags</function>. + Voir aussi + <function>gzgets</function>, + <function>gzopen</function> et + <function>strip_tags</function>. </para> </refsect1> </refentry> @@ -241,20 +266,23 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzopen</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>string <parameter>mode</parameter></paramdef> - <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>use_include_path</optional></parameter></paramdef> + </funcprototype> </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 - 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 - Huffman seul , comme dans "wb1h". (Voir la description de deflateInit2 - dans zlib.h pour plus de détails a propos des paramètres - de stratégie). + <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 Huffman seul , comme dans "wb1h". (Voir la description de + deflateInit2 dans zlib.h pour plus de détails a propos des + paramètres de stratégie). </para> <para> <function>gzopen</function> peut être utilisé pour @@ -278,16 +306,17 @@ </para> <para> <example> - <title>Exemple <function>gzopen</function></title> + <title>Exemple avec<function>gzopen</function></title> <programlisting role="php"> <?php -$fp = gzopen("/tmp/file.gz", "r"); + $fp = gzopen("/tmp/file.gz", "r"); ?> </programlisting> </example> </para> <para> - Voir aussi <function>gzclose</function>. + Voir aussi + <function>gzclose</function>. </para> </refsect1> </refentry> @@ -301,20 +330,22 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzpassthru</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzpassthru</function> lit toutes les informations d'un fichier compressé jusqu'à la fin du fichier - <parameter>zp</parameter>, et écrit le résultat + <parameter>zp</parameter> et écrit le résultat décompressé dans la sortie standard. </para> <para> Si une erreur survient, retourne &false;. </para> <para> - Le pointeur de fichier doit être valide, et avoir été + Le pointeur de fichier doit être valide et avoir été ouvert par <function>gzopen</function>. </para> <para> @@ -332,13 +363,15 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzputs</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>string <parameter>str</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> - <function>gzputs</function>est un alias de <function>gzwrite</function>, et + <function>gzputs</function>est un alias de <function>gzwrite</function> et lui est identique en tous points. </para> </refsect1> @@ -351,9 +384,11 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>string <function>gzread</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>length</parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>gzread</function> lit jusqu'à <parameter>length</parameter> @@ -367,11 +402,11 @@ <informalexample> <programlisting role="php"> <?php -// lis le contenu d'un fichier compressé et le met dans une chaîne -$filename = "/usr/local/something.txt.gz"; -$zd = gzopen( $filename, "r" ); -$contents = gzread( $zd, 10000 ); -gzclose( $zd ); +// lit le contenu d'un fichier compressé et le met dans une chaîne + $filename = "/usr/local/something.txt.gz"; + $zd = gzopen( $filename, "r" ); + $contents = gzread( $zd, 10000 ); + gzclose( $zd ); ?> </programlisting> </informalexample> @@ -395,8 +430,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzrewind</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gzrewind</function> positionne le pointeur interne du fichier @@ -406,12 +443,14 @@ Si une erreur survient, retourne 0. </para> <para> - Le pointeur de fichier doit être valide, et avoir + Le pointeur de fichier doit être valide et avoir été retourné par la fonction <function>gzopen</function>. </para> <para> - Voir aussi <function>gzseek</function> et <function>gztell</function>. + Voir aussi + <function>gzseek</function> et + <function>gztell</function>. </para> </refsect1> </refentry> @@ -425,30 +464,35 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzseek</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>int <parameter>offset</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <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>. + 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> <para> Si le fichier est ouvert en lecture seule, cette fonction émulée peut être extrêmement lente. Si le fichier est ouvert en lecture, seul le déplacement avant - (forward seek) sont acceptés. gzseek compresse alors une - séquence de zéro jusqu'à la nouvelle position. + (forward seek) sont acceptés. <function>gzseek</function> compresse + alors une 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 - fin du fichier est une erreur. + <function>gzseek</function> retourne <literal>0</literal> en cas de + succès, sinon retourne <literal>-1</literal>. Notez que + positionner le pointeur au-delà de la fin du fichier est une erreur. </para> <para> - Voir aussi <function>gztell</function> et <function>gzrewind</function>. + Voir aussi + <function>gztell</function> et + <function>gzrewind</function>. </para> </refsect1> </refentry> @@ -460,8 +504,10 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gztell</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>gztell</function> retourne la position du pointeur interne @@ -472,7 +518,7 @@ Si une erreur survient, retourne &false;. </para> <para> - Le pointeur de fichier doit être valide, et doit avoir + Le pointeur de fichier doit être valide et doit avoir été retourné par la fonction <function>gzopen</function>. </para> @@ -492,10 +538,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>gzwrite</function></funcdef> <paramdef>resource <parameter>zp</parameter></paramdef> <paramdef>string <parameter>string</parameter></paramdef> <paramdef>int <parameter><optional>length</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <simpara> <function>gzwrite</function> écrit le contenu de la chaîne @@ -507,10 +555,10 @@ la fin de la chaîne a été atteinte. </simpara> <simpara> - Notez que si l'argument <parameter>length</parameter> est donnée, + Notez que si l'argument <parameter>length</parameter> est donné, alors l'option <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link> - sera ignorée et les slashes ne seront pas supprimés de + sera ignorée et les slash ne seront pas supprimés de la chaîne <parameter>string</parameter>. </simpara> <simpara> @@ -529,9 +577,12 @@ <refsect1> <title>Description</title> <funcsynopsis> + <funcprototype> <funcdef>int <function>readgzfile</function></funcdef> <paramdef>string <parameter>filename</parameter></paramdef> - <paramdef>int <parameter><optional>use_include_path</optional></parameter></paramdef> + <paramdef>int + <parameter><optional>use_include_path</optional></parameter></paramdef> + </funcprototype> </funcsynopsis> <para> <function>readgzfile</function> lit un fichier, le décompresse et @@ -540,17 +591,18 @@ <para> <function>readgzfile</function> peut être utilisé pour lire un fichier qui n'est pas au format gzip, car dans ce cas, la - décompression est omise, et le fichier est directement affiché. + 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 &false;, - et à moins que la fonction n'ai été appelée avec - @readgzfile, l'erreur est affichée. + <function>readgzfile</function> retourne le nombre d'octets (non + compressé) lus depuis le fichier. Si une erreur survient, retourne + &false;, et à moins que la fonction n'ai été + appelée avec @readgzfile, l'erreur est affichée. </para> <para> Le fichier <parameter>filename</parameter> sera ouvert et son contenu - sera écrit danas la sortie standard. + sera écrit dans la sortie standard. </para> <para> Vous pouvez utiliser le paramètre optionnel en le mettant @@ -568,7 +620,7 @@ <refentry id="function.gzcompress"> <refnamediv> <refname>gzcompress</refname> - <refpurpose>Compresse une chaˆne (ZLIB)</refpurpose> + <refpurpose>Compresse une chaîne (ZLIB)</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -583,19 +635,21 @@ </funcsynopsis> <para> <function>gzcompress</function> retourne la version compressé avec - le format de données ZLIB de la chaîne <parameter>data</parameter>, - ou &false; en cas d'erreur. Le paramètre - <parameter>level</parameter> peut prendre des valeurs depuis 0 - (pas de compression) jusqu'à 9 (compression maximum). + le format de données ZLIB de la chaîne + <parameter>data</parameter>, ou &false; en cas d'erreur. Le + paramètre <parameter>level</parameter> peut prendre des valeurs + depuis <literal>0</literal> (pas de compression) jusqu'à + <literal>9</literal> (compression maximum). </para> <para> Pour plus de détails sur la compression ZLIB et son algorithme, - reportez vous au document de spécifications - <ulink url="&url.rfc1950;">ZLIB Compressed Data Format Specification version 3.3</ulink> - (RFC 1950). + reportez-vous au document de spécifications + <ulink url="&url.rfc1950;">ZLIB Compressed Data Format Specification + version 3.3</ulink> (RFC 1950). </para> <para> - Voir aussi <function>gzdeflate</function>, + Voir aussi + <function>gzdeflate</function>, <function>gzinflate</function>, <function>gzuncompress</function> et <function>gzencode</function>. @@ -605,7 +659,9 @@ <refentry id="function.gzuncompress"> <refnamediv> <refname>gzuncompress</refname> - <refpurpose>Décompresse une chaîne gz-compressée</refpurpose> + <refpurpose> + Décompresse une chaîne gz-compressée + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -623,20 +679,23 @@ <parameter>data</parameter> en entrée (compressée par <function>gzcompress</function>) et retourne la chaîne originale, ou bien &false; en cas d'erreur. <function>gzuncompress</function> - retournera une erreur si la taille de la chaîne décompressée + 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 <parameter>length</parameter>. </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 compression gzip, qui inclus en plus des données + d'en-tête. Voir <function>gzencode</function> pour la compression gzip. </para> </note> <para> - Voir aussi <function>gzdeflate</function>, + Voir aussi + <function>gzdeflate</function>, <function>gzinflate</function>, <function>gzcompress</function> et <function>gzencode</function>. @@ -663,15 +722,15 @@ <function>gzdeflate</function> retourne la version compressée de <parameter>data</parameter> en utilisant le format de données DEFLATE, ou &false; si une erreur est survenue. - Le paramètre optionnel <parameter>level</parameter> peut prendre des - valeurs de 0 (pas de compression) jusqu'à 9 (compression maximum, - vitesse minimum). + Le paramètre optionnel <parameter>level</parameter> peut prendre + des valeurs de 0 (pas de compression) jusqu'à 9 (compression + maximum, vitesse minimum). </para> <para> Pour plus de détails sur la compression ZLIB et son algorithme, - reportez vous au document de spécifications - <ulink url="&url.rfc1951;">DEFLATE Compressed Data Format Specification version 1.3</ulink> - (RFC 1951). + reportez-vous au document de spécifications + <ulink url="&url.rfc1951;">DEFLATE Compressed Data Format Specification + version 1.3</ulink> (RFC 1951). </para> <para> Voir aussi @@ -701,17 +760,19 @@ <para> <function>gzinflate</function> décompresse la chaîne <parameter>data</parameter>. <parameter>data</parameter> - doit avoir été compressée avec <function>gzdeflate</function>. + doit avoir été compressée avec + <function>gzdeflate</function>. <function>gzinflate</function> retourne les données originales décompressées, ou bien &false; si une erreur survient. <function>gzinflate</function> - retournera une erreur si les données décompressées sont plus - grandes que 256 fois la taille des données compressées - <parameter>data</parameter> ou que le paramètre + retournera une erreur si les données décompressées + sont plus grandes que 256 fois la taille des données + compressées <parameter>data</parameter> ou que le paramètre optionnel <parameter>length</parameter>. </para> <para> - Voir aussi <function>gzcompress</function>. + Voir aussi + <function>gzcompress</function>, <function>gzuncompress</function>, <function>gzdeflate</function> et <function>gzencode</function>. @@ -721,7 +782,9 @@ <refentry id="function.gzencode"> <refnamediv> <refname>gzencode</refname> - <refpurpose>Crée une chaîne compréssée avec gzip</refpurpose> + <refpurpose> + Crée une chaîne compressée avec gzip + </refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -745,9 +808,9 @@ 1. </para> <para> - La chaîne retournée contient les entêtes appropriés et la - structure de données demandées par gzip pour faire un - fichier .gz file, e.g.: + La chaîne retournée contient les en-têtes + appropriées et la structure de données demandées par + gzip pour faire un fichier .gz file, e.g.: <example> <title>Création d'un fichier .gz (gzip)</title> <programlisting role="php"> @@ -762,9 +825,9 @@ </example> </para> <para> - Pour plus de détails sur le format GZIP, reportez vous à : - <ulink url="&url.rfc1952">GZIP file format specification version 4.3</ulink> - (RFC 1952). + Pour plus de détails sur le format GZIP, reportez-vous à : + <ulink url="&url.rfc1952;">GZIP file format specification version + 4.3</ulink> (RFC 1952). </para> <para> Voir aussi