FilteringInputStreambuf Class Template Reference

Delivers characters from an istream or streambuf from a source while filtering. More...

#include <openbabel/lineend.h>

List of all members.

Public Member Functions

 FilteringInputStreambuf (std::streambuf *source=NULL, bool deleteWhenFinished=false)
virtual ~FilteringInputStreambuf ()
virtual int overflow (int)
virtual int underflow ()
virtual int sync ()
virtual std::streampos seekoff (std::streamoff off, std::ios_base::seekdir way, std::ios_base::openmode which=std::ios_base::in|std::ios_base::out)
virtual std::streampos seekpos (std::streampos sp, std::ios_base::openmode which=std::ios_base::in|std::ios_base::out)
std::streambuf * GetSource () const
void SetSource (std::streambuf *newsource)


Detailed Description

template<class Extractor>
class OpenBabel::FilteringInputStreambuf< Extractor >

Delivers characters from an istream or streambuf from a source while filtering.

Based on an article by James Kanze, "Filtering Streambufs" http://kanze.james.neuf.fr/articles/fltrsbf1.html

A FilteringInputStreambuf delivers characters on request to an istream or a destination rdbuf(). It receives them from a source rdbuf. In doing the transfer it filters them in a way decided by the class specified in template parameter Extractor.

seekg and tellg requests from the stream are passed through to source rdbuf. This allows return to a position in the input data that was previously noted. This is adequate to allow OpenBabel's fastsearch indexing, but may not be good enough for some other applications that use random access.

A class LineEndingExtractor converts DOS and MAC line endings to the UNIX line ending.

This filtering process is potentially extendable, with a chain of FilteringInputStreambufs each carrying out its filtering task. For instance a decompression streambuf could feed a LineEnding filter, which in tern was read by an input stream.


Constructor & Destructor Documentation

FilteringInputStreambuf ( std::streambuf *  source = NULL,
bool  deleteWhenFinished = false 
) [inline]

virtual ~FilteringInputStreambuf (  )  [inline, virtual]


Member Function Documentation

virtual int overflow ( int   )  [inline, virtual]

int underflow (  )  [inline, virtual]

int sync (  )  [inline, virtual]

virtual std::streampos seekoff ( std::streamoff  off,
std::ios_base::seekdir  way,
std::ios_base::openmode  which = std::ios_base::in | std::ios_base::out 
) [inline, virtual]

virtual std::streampos seekpos ( std::streampos  sp,
std::ios_base::openmode  which = std::ios_base::in | std::ios_base::out 
) [inline, virtual]

std::streambuf* GetSource (  )  const [inline]

Returns current source.

void SetSource ( std::streambuf *  newsource  )  [inline]

Changes the source.


The documentation for this class was generated from the following file: