| 1 | These classes provide a C++ stream interface to the zlib library. It allows you
 | 
|---|
| 2 | to do things like:
 | 
|---|
| 3 | 
 | 
|---|
| 4 |   gzofstream outf("blah.gz");
 | 
|---|
| 5 |   outf << "These go into the gzip file " << 123 << endl;
 | 
|---|
| 6 | 
 | 
|---|
| 7 | It does this by deriving a specialized stream buffer for gzipped files, which is
 | 
|---|
| 8 | the way Stroustrup would have done it. :->
 | 
|---|
| 9 | 
 | 
|---|
| 10 | The gzifstream and gzofstream classes were originally written by Kevin Ruland
 | 
|---|
| 11 | and made available in the zlib contrib/iostream directory. The older version still
 | 
|---|
| 12 | compiles under gcc 2.xx, but not under gcc 3.xx, which sparked the development of
 | 
|---|
| 13 | this version.
 | 
|---|
| 14 | 
 | 
|---|
| 15 | The new classes are as standard-compliant as possible, closely following the
 | 
|---|
| 16 | approach of the standard library's fstream classes. It compiles under gcc versions
 | 
|---|
| 17 | 3.2 and 3.3, but not under gcc 2.xx. This is mainly due to changes in the standard
 | 
|---|
| 18 | library naming scheme. The new version of gzifstream/gzofstream/gzfilebuf differs
 | 
|---|
| 19 | from the previous one in the following respects:
 | 
|---|
| 20 | - added showmanyc
 | 
|---|
| 21 | - added setbuf, with support for unbuffered output via setbuf(0,0)
 | 
|---|
| 22 | - a few bug fixes of stream behavior
 | 
|---|
| 23 | - gzipped output file opened with default compression level instead of maximum level
 | 
|---|
| 24 | - setcompressionlevel()/strategy() members replaced by single setcompression()
 | 
|---|
| 25 | 
 | 
|---|
| 26 | The code is provided "as is", with the permission to use, copy, modify, distribute
 | 
|---|
| 27 | and sell it for any purpose without fee.
 | 
|---|
| 28 | 
 | 
|---|
| 29 | Ludwig Schwardt
 | 
|---|
| 30 | <schwardt@sun.ac.za>
 | 
|---|
| 31 | 
 | 
|---|
| 32 | DSP Lab
 | 
|---|
| 33 | Electrical & Electronic Engineering Department
 | 
|---|
| 34 | University of Stellenbosch
 | 
|---|
| 35 | South Africa
 | 
|---|