annotate src/zlib-1.2.8/contrib/iostream3/README @ 81:7029a4916348

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