annotate src/zlib-1.2.7/contrib/iostream3/README @ 169:223a55898ab9 tip default

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