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