diff options
Diffstat (limited to 'src/lib/istream-chain.h')
| -rw-r--r-- | src/lib/istream-chain.h | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/src/lib/istream-chain.h b/src/lib/istream-chain.h new file mode 100644 index 0000000..e5ba68b --- /dev/null +++ b/src/lib/istream-chain.h @@ -0,0 +1,21 @@ +#ifndef ISTREAM_CHAIN_H +#define ISTREAM_CHAIN_H + +struct istream_chain; + +/* Flexibly couple input streams into a single chain stream. Input streams can + be added after creation of the chain stream, and the chain stream will not + signal EOF until all streams are read to EOF and the last stream added was + NULL. Streams that were finished to EOF are unreferenced. The chain stream + is obviously not seekable and it has no determinable size. The chain_r + argument returns a pointer to the chain object. */ +struct istream *i_stream_create_chain(struct istream_chain **chain_r, + size_t max_buffer_size); + +/* Append an input stream to the chain. */ +void i_stream_chain_append(struct istream_chain *chain, struct istream *stream); +/* Mark the end of the chain. Only then reads from the chain stream can + return EOF. */ +void i_stream_chain_append_eof(struct istream_chain *chain); + +#endif |