NAME

FBB::IQuotedPrintableStream - Std::istream performing quoted-printable encoding and decoding

SYNOPSIS

#include <bobcat/iquotedprintablestream>
Linking option: -lbobcat

DESCRIPTION

FBB::IQuotedPrintableStream objects may be used to quoted-printable encode or decode information that is available on a separate std::istream.

The class IQuotedPrintableStream is a class template, using a FBB::CodeType template non-type parameter. Objects of the class FBB::IQuotedPrintableStream<FBB::ENCODE> encode the information they receive, objects of the class FBB::IQuotedPrintableStream<FBB::DECODE> decode the information they receive.

NAMESPACE

FBB
All constructors, members, operators and manipulators, mentioned in this man-page, are defined in the namespace FBB.

INHERITS FROM

FBB::IQuotedPrintableStreambuf (private),
std::istream

CONSTRUCTORS

o

IQuotedPrintableStream<CodeType>(std::istream &in, size_t bufSize = 1000):
This constructor initializes a std::istream providing it with an FBB::IQuotedPrintableStreambuf stream buffer. The IQuotedPrintableStreambuf’s constructor receives all arguments that are passed to this constructor.

- IQuotedPrintableStream<ENCODE> objects perform quoted printable encodi ng;
- IQuotedPrintableStream<DECODE> objects perform quoted printable decoding;
- IQuotedPrintableStream<CodeType> objects obtain the bytes to encode or decode from std::istream &in;
- The internally used IFilterStreambuf is initialized with a buffer of size bufSize, using a lower bound of 100.

The constructor uses a configurable buffer size for reading. Characters that were read into the buffer but are not part of the actual quoted printable encoded data are unavailable after completing the quoted printable decoding. If information beyond the quoted printable input block should remain available, then specify a buffer size of 1.

INHERITED MEMBERS

Since the class uses public derivation from std::istream, all members of this class can be used.

EXAMPLE

#include <iostream>
#include <bobcat/iquotedprintablestream>
using namespace std;
using namespace FBB;
int main()
{


    IQuotedPrintableStream<ENCODE> in(cin);


    cout << in.rdbuf();         // quoted printable encode the info on


                                // cin.
}

See also the example in the iquotedprintablestreambuf(3bobcat) man-page.

FILES

bobcat/iquoted printablestream - defines the class interface

SEE ALSO

bobcat(7), iquotedprintablestreambuf(3bobcat)

BUGS

None Reported.

DISTRIBUTION FILES

o

bobcat_4.08.06-x.dsc: detached signature;

o

bobcat_4.08.06-x.tar.gz: source archive;

o

bobcat_4.08.06-x_i386.changes: change log;

o

libbobcat1_4.08.06-x_*.deb: debian package holding the libraries;

o

libbobcat1-dev_4.08.06-x_*.deb: debian package holding the libraries, headers and manual pages;

o

http://sourceforge.net/projects/bobcat: public archive location;

BOBCAT

Bobcat is an acronym of `Brokken’s Own Base Classes And Templates’.

COPYRIGHT

This is free software, distributed under the terms of the GNU General Public License (GPL).

AUTHOR

Frank B. Brokken (f.b.brokken@rug.nl).