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 gzclose resource 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 gzeof resource 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 gzfile string 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 gzgetc resource 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 gzgets resource zp int 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 gzgetss resource zp int length string 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 gzopen string filename string 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 <function>gzopen</function> + Exemple avec<function>gzopen</function> <?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 gzpassthru resource 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 gzputs resource zp string str int 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 gzread resource zp int 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 gzrewind resource 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 gzseek resource zp int 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 gztell resource 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 gzwrite resource zp string string int 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 readgzfile string 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