summaryrefslogtreecommitdiff
path: root/old/zlib.html
diff options
context:
space:
mode:
Diffstat (limited to 'old/zlib.html')
-rw-r--r--old/zlib.html34
1 files changed, 17 insertions, 17 deletions
diff --git a/old/zlib.html b/old/zlib.html
index c343703..8c1b190 100644
--- a/old/zlib.html
+++ b/old/zlib.html
@@ -45,7 +45,7 @@
45 </ol> 45 </ol>
46 46
47 <dl> 47 <dl>
48 <dt>Jean-loup Gailly 48 <dt>Jean-loup Gailly
49 <dd><a href="mailto:jloup@gzip.org">jloup@gzip.org</a> 49 <dd><a href="mailto:jloup@gzip.org">jloup@gzip.org</a>
50 <dt>Mark Adler 50 <dt>Mark Adler
51 <dd><a href="mailto:madler@alumni.caltech.edu">madler@alumni.caltech.edu</a> 51 <dd><a href="mailto:madler@alumni.caltech.edu">madler@alumni.caltech.edu</a>
@@ -55,19 +55,19 @@
55 Comments) 1950 to 1952 in the files 55 Comments) 1950 to 1952 in the files
56 <a href="ftp://ds.internic.net/rfc/rfc1950.txt"> 56 <a href="ftp://ds.internic.net/rfc/rfc1950.txt">
57 ftp://ds.internic.net/rfc/rfc1950.txt </a> 57 ftp://ds.internic.net/rfc/rfc1950.txt </a>
58 (zlib format), 58 (zlib format),
59 <a href="ftp://ds.internic.net/rfc/rfc1951.txt"> 59 <a href="ftp://ds.internic.net/rfc/rfc1951.txt">
60 rfc1951.txt </a> 60 rfc1951.txt </a>
61 (<a href="#deflate">deflate</a> format) and 61 (<a href="#deflate">deflate</a> format) and
62 <a href="ftp://ds.internic.net/rfc/rfc1952.txt"> 62 <a href="ftp://ds.internic.net/rfc/rfc1952.txt">
63 rfc1952.txt </a> 63 rfc1952.txt </a>
64 (gzip format). 64 (gzip format).
65 <p> 65 <p>
66 This manual is converted from zlib.h by 66 This manual is converted from zlib.h by
67 <a href="mailto:piaip@csie.ntu.edu.tw"> piaip </a> 67 <a href="mailto:piaip@csie.ntu.edu.tw"> piaip </a>
68 <p> 68 <p>
69 Visit <a href="http://ftp.cdrom.com/pub/infozip/zlib/"> 69 Visit <a href="http://ftp.cdrom.com/pub/infozip/zlib/">
70 http://ftp.cdrom.com/pub/infozip/zlib/</a> 70 http://ftp.cdrom.com/pub/infozip/zlib/</a>
71 for the official zlib web page. 71 for the official zlib web page.
72 <p> 72 <p>
73 73
@@ -99,7 +99,7 @@
99<hr> 99<hr>
100<a name="Utility functions"><h2> Utility functions </h2> 100<a name="Utility functions"><h2> Utility functions </h2>
101 The following utility functions are implemented on top of the 101 The following utility functions are implemented on top of the
102 <a href="#Basic functions">basic stream-oriented functions</a>. 102 <a href="#Basic functions">basic stream-oriented functions</a>.
103 To simplify the interface, some 103 To simplify the interface, some
104 default options are assumed (compression level and memory usage, 104 default options are assumed (compression level and memory usage,
105 standard memory allocation functions). The source code of these 105 standard memory allocation functions). The source code of these
@@ -406,7 +406,7 @@
406 enough room in the output buffer), <a href="#next_in">next_in</a> and <a href="#avail_in">avail_in</a> are updated and 406 enough room in the output buffer), <a href="#next_in">next_in</a> and <a href="#avail_in">avail_in</a> are updated and
407 processing will resume at this point for the next call of <a href="#deflate">deflate</a>(). 407 processing will resume at this point for the next call of <a href="#deflate">deflate</a>().
408 408
409 <li> 409 <li>
410 Provide more output starting at <a href="#next_out">next_out</a> and update <a href="#next_out">next_out</a> and <a href="#avail_out">avail_out</a> 410 Provide more output starting at <a href="#next_out">next_out</a> and update <a href="#next_out">next_out</a> and <a href="#avail_out">avail_out</a>
411 accordingly. This action is forced if the parameter flush is non zero. 411 accordingly. This action is forced if the parameter flush is non zero.
412 Forcing flush frequently degrades the compression ratio, so this parameter 412 Forcing flush frequently degrades the compression ratio, so this parameter
@@ -453,7 +453,7 @@
453 <a href="#deflate">deflate</a> has returned <a href="#Z_STREAM_END">Z_STREAM_END</a>, the only possible operations on the 453 <a href="#deflate">deflate</a> has returned <a href="#Z_STREAM_END">Z_STREAM_END</a>, the only possible operations on the
454 stream are <a href="#deflateReset">deflateReset</a> or <a href="#deflateEnd">deflateEnd</a>. 454 stream are <a href="#deflateReset">deflateReset</a> or <a href="#deflateEnd">deflateEnd</a>.
455 <p> 455 <p>
456 456
457 <a href="#Z_FINISH">Z_FINISH</a> can be used immediately after <a href="#deflateInit">deflateInit</a> if all the compression 457 <a href="#Z_FINISH">Z_FINISH</a> can be used immediately after <a href="#deflateInit">deflateInit</a> if all the compression
458 is to be done in a single step. In this case, <a href="#avail_out">avail_out</a> must be at least 458 is to be done in a single step. In this case, <a href="#avail_out">avail_out</a> must be at least
459 0.1% larger than <a href="#avail_in">avail_in</a> plus 12 bytes. If <a href="#deflate">deflate</a> does not return 459 0.1% larger than <a href="#avail_in">avail_in</a> plus 12 bytes. If <a href="#deflate">deflate</a> does not return
@@ -493,7 +493,7 @@
493 <p> 493 <p>
494 494
495<font color="Blue"><dt> int <a name="inflateInit">inflateInit</a> (<a href="#z_streamp">z_streamp</a> strm);</font> 495<font color="Blue"><dt> int <a name="inflateInit">inflateInit</a> (<a href="#z_streamp">z_streamp</a> strm);</font>
496<dd> 496<dd>
497 Initializes the internal stream <a href="#state">state</a> for decompression. The fields 497 Initializes the internal stream <a href="#state">state</a> for decompression. The fields
498 <a href="#next_in">next_in</a>, <a href="#avail_in">avail_in</a>, <a href="#zalloc">zalloc</a>, <a href="#zfree">zfree</a> and <a href="#opaque">opaque</a> must be initialized before by 498 <a href="#next_in">next_in</a>, <a href="#avail_in">avail_in</a>, <a href="#zalloc">zalloc</a>, <a href="#zfree">zfree</a> and <a href="#opaque">opaque</a> must be initialized before by
499 the caller. If <a href="#next_in">next_in</a> is not <a href="#Z_NULL">Z_NULL</a> and <a href="#avail_in">avail_in</a> is large enough (the exact 499 the caller. If <a href="#next_in">next_in</a> is not <a href="#Z_NULL">Z_NULL</a> and <a href="#avail_in">avail_in</a> is large enough (the exact
@@ -529,9 +529,9 @@
529 enough room in the output buffer), <a href="#next_in">next_in</a> is updated and processing 529 enough room in the output buffer), <a href="#next_in">next_in</a> is updated and processing
530 will resume at this point for the next call of <a href="#inflate">inflate</a>(). 530 will resume at this point for the next call of <a href="#inflate">inflate</a>().
531 531
532 <li> Provide more output starting at <a href="#next_out">next_out</a> and update <a href="#next_out">next_out</a> and 532 <li> Provide more output starting at <a href="#next_out">next_out</a> and update <a href="#next_out">next_out</a> and
533 <a href="#avail_out">avail_out</a> accordingly. <a href="#inflate">inflate</a>() provides as much output as possible, 533 <a href="#avail_out">avail_out</a> accordingly. <a href="#inflate">inflate</a>() provides as much output as possible,
534 until there is no more input data or no more space in the output buffer 534 until there is no more input data or no more space in the output buffer
535 (see below about the flush parameter). 535 (see below about the flush parameter).
536 </ul> <p> 536 </ul> <p>
537 537
@@ -566,7 +566,7 @@
566 566
567 If a preset dictionary is needed at this point (see <a href="#inflateSetDictionary">inflateSetDictionary</a> 567 If a preset dictionary is needed at this point (see <a href="#inflateSetDictionary">inflateSetDictionary</a>
568 below), <a href="#inflate">inflate</a> sets strm-<a href="#adler">adler</a> to the <a href="#adler32">adler32</a> checksum of the 568 below), <a href="#inflate">inflate</a> sets strm-<a href="#adler">adler</a> to the <a href="#adler32">adler32</a> checksum of the
569 dictionary chosen by the compressor and returns <a href="#Z_NEED_DICT">Z_NEED_DICT</a> ; otherwise 569 dictionary chosen by the compressor and returns <a href="#Z_NEED_DICT">Z_NEED_DICT</a> ; otherwise
570 it sets strm-&gt <a href="#adler">adler</a> to the <a href="#adler32">adler32</a> checksum of all output produced 570 it sets strm-&gt <a href="#adler">adler</a> to the <a href="#adler32">adler32</a> checksum of all output produced
571 so far (that is, <a href="#total_out">total_out</a> bytes) and returns <a href="#Z_OK">Z_OK</a>, <a href="#Z_STREAM_END">Z_STREAM_END</a> or 571 so far (that is, <a href="#total_out">total_out</a> bytes) and returns <a href="#Z_OK">Z_OK</a>, <a href="#Z_STREAM_END">Z_STREAM_END</a> or
572 an error code as described below. At the end of the stream, <a href="#inflate">inflate</a>() 572 an error code as described below. At the end of the stream, <a href="#inflate">inflate</a>()
@@ -652,7 +652,7 @@
652 memory, <a href="#Z_STREAM_ERROR">Z_STREAM_ERROR</a> if a parameter is invalid (such as an invalid 652 memory, <a href="#Z_STREAM_ERROR">Z_STREAM_ERROR</a> if a parameter is invalid (such as an invalid
653 method). <a href="#msg">msg</a> is set to null if there is no error message. <a href="#deflateInit2">deflateInit2</a> does 653 method). <a href="#msg">msg</a> is set to null if there is no error message. <a href="#deflateInit2">deflateInit2</a> does
654 not perform any compression: this will be done by <a href="#deflate">deflate</a>().<p> 654 not perform any compression: this will be done by <a href="#deflate">deflate</a>().<p>
655 655
656<font color="Blue"><dt> int <a name="deflateSetDictionary">deflateSetDictionary</a> (<a href="#z_streamp">z_streamp</a> strm, const Bytef *dictionary, uInt dictLength);</font> 656<font color="Blue"><dt> int <a name="deflateSetDictionary">deflateSetDictionary</a> (<a href="#z_streamp">z_streamp</a> strm, const Bytef *dictionary, uInt dictLength);</font>
657<dd> 657<dd>
658 Initializes the compression dictionary from the given byte sequence 658 Initializes the compression dictionary from the given byte sequence
@@ -723,7 +723,7 @@
723 723
724 Before the call of <a href="#deflateParams">deflateParams</a>, the stream <a href="#state">state</a> must be set as for 724 Before the call of <a href="#deflateParams">deflateParams</a>, the stream <a href="#state">state</a> must be set as for
725 a call of <a href="#deflate">deflate</a>(), since the currently available input may have to 725 a call of <a href="#deflate">deflate</a>(), since the currently available input may have to
726 be compressed and flushed. In particular, strm-&gt <a href="#avail_out">avail_out</a> must be 726 be compressed and flushed. In particular, strm-&gt <a href="#avail_out">avail_out</a> must be
727 non-zero.<p> 727 non-zero.<p>
728 728
729 <a href="#deflateParams">deflateParams</a> returns <a href="#Z_OK">Z_OK</a> if success, <a href="#Z_STREAM_ERROR">Z_STREAM_ERROR</a> if the source 729 <a href="#deflateParams">deflateParams</a> returns <a href="#Z_OK">Z_OK</a> if success, <a href="#Z_STREAM_ERROR">Z_STREAM_ERROR</a> if the source
@@ -865,7 +865,7 @@ typedef struct z_stream_s {
865 uLong <a name="reserved">reserved</a>; /* <a href="#reserved">reserved</a> for future use */ 865 uLong <a name="reserved">reserved</a>; /* <a href="#reserved">reserved</a> for future use */
866} <a href="#z_stream_s">z_stream</a> ; 866} <a href="#z_stream_s">z_stream</a> ;
867 867
868typedef <a href="#z_stream_s">z_stream</a> FAR * <a name="z_streamp">z_streamp</a>; ÿ 868typedef <a href="#z_stream_s">z_stream</a> FAR * <a name="z_streamp">z_streamp</a>; ÿ
869</pre> 869</pre>
870</font> 870</font>
871 The application must update <a href="#next_in">next_in</a> and <a href="#avail_in">avail_in</a> when <a href="#avail_in">avail_in</a> has 871 The application must update <a href="#next_in">next_in</a> and <a href="#avail_in">avail_in</a> when <a href="#avail_in">avail_in</a> has
@@ -904,7 +904,7 @@ typedef <a href="#z_stream_s">z_stream</a> FAR * <a name="z_streamp">z_streamp</
904<font color="Blue"> 904<font color="Blue">
905<pre> 905<pre>
906#define <a name="Z_NO_FLUSH">Z_NO_FLUSH</a> 0 906#define <a name="Z_NO_FLUSH">Z_NO_FLUSH</a> 0
907#define <a name="Z_PARTIAL_FLUSH">Z_PARTIAL_FLUSH</a> 1 907#define <a name="Z_PARTIAL_FLUSH">Z_PARTIAL_FLUSH</a> 1
908 /* will be removed, use <a href="#Z_SYNC_FLUSH">Z_SYNC_FLUSH</a> instead */ 908 /* will be removed, use <a href="#Z_SYNC_FLUSH">Z_SYNC_FLUSH</a> instead */
909#define <a name="Z_SYNC_FLUSH">Z_SYNC_FLUSH</a> 2 909#define <a name="Z_SYNC_FLUSH">Z_SYNC_FLUSH</a> 2
910#define <a name="Z_FULL_FLUSH">Z_FULL_FLUSH</a> 3 910#define <a name="Z_FULL_FLUSH">Z_FULL_FLUSH</a> 3