annotate src/zlib-1.2.8/contrib/iostream3/README @ 83:ae30d91d2ffe

Replace these with versions built using an older toolset (so as to avoid ABI compatibilities when linking on Ubuntu 14.04 for packaging purposes)
author Chris Cannam
date Fri, 07 Feb 2020 11:51:13 +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