Version 5.0 The LEDA User Manual

9.23 Coder Pipes ( CoderPipe2 )
1. Definition
The type CoderPipe2< Coder1 , Coder2 > can be used to combine two coders of type
Coder1 and Coder2 into one single coder. This works in an analogous way as a pipe of
the operating system: In encoding mode the original input is processed by Coder1 . Its
output is fed into Coder2 . The output of Coder2 becomes the output of the pipe. In
decoding mode the situation is reversed: The data is sent through Coder2 first and then
through Coder1 .
We also provide pipes for combining more than two coders (up to six):
CoderPipe3, . . . , CoderPipe6. (Since these classes have a similar interface as CoderPipe2,
we do not include manual pages for them.)
#include < LEDA/coding/coder util.h >
2. Types
CoderPipe2< Coder1 , Coder2 >:: coder1
the type Coder1 .
CoderPipe2< Coder1 , Coder2 >:: coder2
3. Creation
the type Coder2 .
CoderPipe2< Coder1 , Coder2 > C(streambuf ∗ src stream = 0,
streambuf ∗ tgt stream = 0,
bool own streams = false);
creates an instance C which uses the given source and target
streams. If own streams is set, then C is responsible for the destruction
of the streams, otherwise the pointers src stream and tgt stream
must be valid during the life-time of C.
CoderPipe2< Coder1 , Coder2 > C(const char ∗ src file name,
const char ∗ tgt file name);
creates an instance C which uses file-streams for input and output.
4. Operations
Standard Operations
void C.encode( ) encodes the source stream and writes the output to
the target stream.
void C.decode( ) decodes the source stream and writes the output to
the target stream.