zorba::transcode::streambuf

#include <zorba/util/transcode_stream.h>

A transcode::streambuf is-a std::streambuf for transcoding character encodings from/to UTF-8 on-the-fly. To use it, replace a stream's streambuf:

  istream is;
  // ...
  transcode::streambuf tbuf( "ISO-8859-1", is.rdbuf() );
  is.ios::rdbuf( &tbuf );

Note that the transcode::streambuf must exist for as long as it's being used by the stream. If you are replacing the streabuf for a stream you did not create, you should set it back to the original streambuf:

  void f( ostream &os ) {
    transcode::streambuf tbuf( "ISO-8859-1", os.rdbuf() );
    try {
      os.ios::rdbuf( &tbuf );
      // ...
    }
    catch ( ... ) {
      os.ios::rdbuf( tbuf.orig_streambuf() );
      throw;
    }
    os.ios::rdbuf( tbuf.orig_streambuf() );
  }

Alternatively, you may wish to use either , , or instead.While transcode::streambuf does support seeking, the positions are relative to the original byte stream.