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 @@
+
+
Zlib (Compression)Zlib
@@ -10,7 +12,7 @@
Il faut utiliser la librairie zlib, de version >= 1.0.9.
- 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
système de fichier.
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 @@
Description
+ int gzcloseresource zp
+ gzclose ferme le pointeur zp.
@@ -72,7 +76,7 @@
&false;, suivant le succès ou l'échec.
- 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
gzopen.
@@ -86,8 +90,10 @@
Description
+ int gzeofresource zp
+ gzeof retourne &true; si le pointeur
@@ -95,7 +101,7 @@
est à la fin du fichier, sinon retourne &false;.
- 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
gzopen.
@@ -111,9 +117,12 @@
Description
+ array gzfilestring filename
- int use_include_path
+ int
+ use_include_path
+ gzfile est identique à
@@ -122,24 +131,31 @@
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
include_path.
- Voir aussi readgzfile, et gzopen.
+ Voir aussi
+ readgzfile et
+ gzopen.
gzgetc
- Lit un caractère d'un fichier compressé.
+
+ Lit un caractère d'un fichier compressé.
+ Description
+ string gzgetcresource zp
+ gzgetc retourne une chaîne
@@ -150,7 +166,7 @@
la fin du fichier (voir gzeof).
- 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 gzopen.
@@ -169,9 +185,11 @@
Description
+ string gzgetsresource zpint length
+ gzgets retourne une chaîne
@@ -179,21 +197,23 @@
à length - 1 octets, lue depuis de fichier
référencé par le pointeur de fichier
zp. La lecture s'interrompt lorsque
- length - 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.
+ length - 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.
Si une erreur survient, retourne &false;.
- 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 gzopen.
- Voir aussi gzopen,
- gzgetc, et fgets.
+ Voir aussi
+ gzopen,
+ gzgetc et
+ fgets.
@@ -207,10 +227,12 @@
Description
+ string gzgetssresource zpint lengthstring allowable_tags
+ gzgetss est identique à gzgets,
@@ -218,7 +240,8 @@
depuis zp.
- Vous pouvez utiliser le troisième argument optionnel pour indiquer
+ Vous pouvez utiliser le troisième argument optionnel
+ allowable_tags pour indiquer
les balises qui ne doivent pas être supprimées.
@@ -228,8 +251,10 @@
- Voir aussi gzgets,
- gzopen, et strip_tags.
+ Voir aussi
+ gzgets,
+ gzopen et
+ strip_tags.
@@ -241,20 +266,23 @@
Description
+ int gzopenstring filenamestring mode
- int use_include_path
+ int
+ use_include_path
+
- gzopen ouvre un fichier compressé avec gzip (.gz)
- pour le lire ou l'écrire. Le paramètre de mode est le même
- que dans fopen ("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).
+ gzopen ouvre un fichier compressé avec
+ gzip (.gz) pour le lire ou l'écrire. Le paramètre de mode est
+ le même que dans fopen ("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).
gzopen peut être utilisé pour
@@ -278,16 +306,17 @@
- Exemple gzopen
+ Exemple avecgzopen
<?php
-$fp = gzopen("/tmp/file.gz", "r");
+ $fp = gzopen("/tmp/file.gz", "r");
?>
- Voir aussi gzclose.
+ Voir aussi
+ gzclose.
@@ -301,20 +330,22 @@
Description
+ int gzpassthruresource zp
+ gzpassthru lit toutes les informations
d'un fichier compressé jusqu'à la fin du fichier
- zp, et écrit le résultat
+ zp et écrit le résultat
décompressé dans la sortie standard.
Si une erreur survient, retourne &false;.
- Le pointeur de fichier doit être valide, et avoir été
+ Le pointeur de fichier doit être valide et avoir été
ouvert par gzopen.
@@ -332,13 +363,15 @@
Description
+ int gzputsresource zpstring strint length
+
- gzputsest un alias de gzwrite, et
+ gzputsest un alias de gzwrite et
lui est identique en tous points.
@@ -351,9 +384,11 @@
Description
+ string gzreadresource zpint length
+ gzread lit jusqu'à length
@@ -367,11 +402,11 @@
<?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 );
?>
@@ -395,8 +430,10 @@
Description
+ int gzrewindresource zp
+ gzrewind positionne le pointeur interne du fichier
@@ -406,12 +443,14 @@
Si une erreur survient, retourne 0.
- Le pointeur de fichier doit être valide, et avoir
+ Le pointeur de fichier doit être valide et avoir
été retourné par la fonction
gzopen.
- Voir aussi gzseek et gztell.
+ Voir aussi
+ gzseek et
+ gztell.
@@ -425,30 +464,35 @@
Description
+ int gzseekresource zpint offset
+ gzseek positionne le pointeur interne du fichier
- compressé zp à la position donnée
- en offset. Equivalent à l'appel (en C) de
- gzseek(zp, offset, SEEK_SET).
+ compressé zp à la position
+ donnée en offset. Equivalent à l'appel
+ (en C) de gzseek(zp, offset, SEEK_SET).
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. gzseek compresse
+ alors une séquence de zéro jusqu'à la nouvelle
+ position.
- gzseek 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.
+ gzseek 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.
- Voir aussi gztell et gzrewind.
+ Voir aussi
+ gztell et
+ gzrewind.
@@ -460,8 +504,10 @@
Description
+ int gztellresource zp
+ gztell retourne la position du pointeur interne
@@ -472,7 +518,7 @@
Si une erreur survient, retourne &false;.
- 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
gzopen.
@@ -492,10 +538,12 @@
Description
+ int gzwriteresource zpstring stringint length
+ gzwrite écrit le contenu de la chaîne
@@ -507,10 +555,10 @@
la fin de la chaîne a été atteinte.
- Notez que si l'argument length est donnée,
+ Notez que si l'argument length est donné,
alors l'option
magic_quotes_runtime
- 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 string.
@@ -529,9 +577,12 @@
Description
+ int readgzfilestring filename
- int use_include_path
+ int
+ use_include_path
+ readgzfile lit un fichier, le décompresse et
@@ -540,17 +591,18 @@
readgzfile 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é.
- readgzfile 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
- <email protected>, l'erreur est affichée.
+ readgzfile 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.
Le fichier filename sera ouvert et son contenu
- sera écrit danas la sortie standard.
+ sera écrit dans la sortie standard.
Vous pouvez utiliser le paramètre optionnel en le mettant
@@ -568,7 +620,7 @@
gzcompress
- Compresse une chaˆne (ZLIB)
+ Compresse une chaîne (ZLIB)Description
@@ -583,19 +635,21 @@
gzcompress retourne la version compressé avec
- le format de données ZLIB de la chaîne data,
- ou &false; en cas d'erreur. Le paramètre
- level peut prendre des valeurs depuis 0
- (pas de compression) jusqu'à 9 (compression maximum).
+ le format de données ZLIB de la chaîne
+ data, ou &false; en cas d'erreur. Le
+ paramètre level peut prendre des valeurs
+ depuis 0 (pas de compression) jusqu'à
+ 9 (compression maximum).
Pour plus de détails sur la compression ZLIB et son algorithme,
- reportez vous au document de spécifications
- ZLIB Compressed Data Format Specification version 3.3
- (RFC 1950).
+ reportez-vous au document de spécifications
+ ZLIB Compressed Data Format Specification
+ version 3.3 (RFC 1950).
- Voir aussi gzdeflate,
+ Voir aussi
+ gzdeflate,
gzinflate,
gzuncompress et
gzencode.
@@ -605,7 +659,9 @@
gzuncompress
- Décompresse une chaîne gz-compressée
+
+ Décompresse une chaîne gz-compressée
+ Description
@@ -623,20 +679,23 @@
data en entrée (compressée par
gzcompress) et retourne la chaîne originale,
ou bien &false; en cas d'erreur. gzuncompress
- 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
data ou plus que le paramètre optionnel
length.
- Ceci n'est pas équivalent à une comrpession gzip,
- qui inclus en plus des données d'entête. Voir gzencode
+ Ceci n'est pas équivalent à
+ une compression gzip, qui inclus en plus des données
+ d'en-tête. Voir gzencode
pour la compression gzip.
- Voir aussi gzdeflate,
+ Voir aussi
+ gzdeflate,
gzinflate,
gzcompress et
gzencode.
@@ -663,15 +722,15 @@
gzdeflate retourne la version compressée
de data en utilisant le format de données
DEFLATE, ou &false; si une erreur est survenue.
- Le paramètre optionnel level peut prendre des
- valeurs de 0 (pas de compression) jusqu'à 9 (compression maximum,
- vitesse minimum).
+ Le paramètre optionnel level peut prendre
+ des valeurs de 0 (pas de compression) jusqu'à 9 (compression
+ maximum, vitesse minimum).
Pour plus de détails sur la compression ZLIB et son algorithme,
- reportez vous au document de spécifications
- DEFLATE Compressed Data Format Specification version 1.3
- (RFC 1951).
+ reportez-vous au document de spécifications
+ DEFLATE Compressed Data Format Specification
+ version 1.3 (RFC 1951).
Voir aussi
@@ -701,17 +760,19 @@
gzinflate décompresse la chaîne
data. data
- doit avoir été compressée avec gzdeflate.
+ doit avoir été compressée avec
+ gzdeflate.
gzinflate retourne les données
originales décompressées, ou bien &false;
si une erreur survient. gzinflate
- retournera une erreur si les données décompressées sont plus
- grandes que 256 fois la taille des données compressées
- data 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 data ou que le paramètre
optionnel length.
- Voir aussi gzcompress.
+ Voir aussi
+ gzcompress,
gzuncompress,
gzdeflate et
gzencode.
@@ -721,7 +782,9 @@
gzencode
- Crée une chaîne compréssée avec gzip
+
+ Crée une chaîne compressée avec gzip
+ Description
@@ -745,9 +808,9 @@
1.
- 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.:
Création d'un fichier .gz (gzip)
@@ -762,9 +825,9 @@
- Pour plus de détails sur le format GZIP, reportez vous à :
- GZIP file format specification version 4.3
- (RFC 1952).
+ Pour plus de détails sur le format GZIP, reportez-vous à :
+ GZIP file format specification version
+ 4.3 (RFC 1952).
Voir aussi