diff options
author | Mark Adler <madler@alumni.caltech.edu> | 2011-09-09 23:22:37 -0700 |
---|---|---|
committer | Mark Adler <madler@alumni.caltech.edu> | 2011-09-09 23:22:37 -0700 |
commit | 4b5a43a219d51066c01ff2ab86af18b967f2d0dd (patch) | |
tree | 4dcaf0cd18751d04cf638a9a6ec521990d4f2e90 /old/zlib.html | |
parent | 086e982175da84b3db958191031380794315f95f (diff) | |
download | zlib-1.2.0.5.tar.gz zlib-1.2.0.5.tar.bz2 zlib-1.2.0.5.zip |
zlib 1.2.0.5v1.2.0.5
Diffstat (limited to 'old/zlib.html')
-rw-r--r-- | old/zlib.html | 34 |
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-> <a href="#adler">adler</a> to the <a href="#adler32">adler32</a> checksum of all output produced | 570 | it sets strm-> <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-> <a href="#avail_out">avail_out</a> must be | 726 | be compressed and flushed. In particular, strm-> <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 | ||
868 | typedef <a href="#z_stream_s">z_stream</a> FAR * <a name="z_streamp">z_streamp</a>; ÿ | 868 | typedef <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 |