/// File stream for reading UTF8-encoded files with automatic conversion to
/// UCS4.
-class idocfstream : public std::basic_ifstream<char_type> {
+class ifdocstream : public std::basic_ifstream<char_type> {
typedef std::basic_ifstream<char_type> base;
public:
- idocfstream();
- explicit idocfstream(const char* s,
- std::ios_base::openmode mode = std::ios_base::in);
- ~idocfstream() {}
+ ifdocstream();
+ explicit ifdocstream(const char* s,
+ std::ios_base::openmode mode = std::ios_base::in,
+ std::string const & encoding = "UTF-8");
+ ~ifdocstream() {}
};
/// File stream for writing files in 8bit encoding \p encoding with automatic
/// conversion from UCS4.
-class odocfstream : public std::basic_ofstream<char_type> {
+class ofdocstream : public std::basic_ofstream<char_type> {
typedef std::basic_ofstream<char_type> base;
public:
- odocfstream(std::string const & encoding = "UTF-8");
- explicit odocfstream(const char* s,
+ ofdocstream();
+ explicit ofdocstream(const char* s,
std::ios_base::openmode mode = std::ios_base::out|std::ios_base::trunc,
std::string const & encoding = "UTF-8");
- ~odocfstream() {}
+ ~ofdocstream() {}
+ ///
+ void reset(std::string const & encoding);
};
/// UCS4 input stringstream
/// UCS4 output stringstream
typedef std::basic_ostringstream<char_type> odocstringstream;
-inline
-odocstream & operator<<(odocstream & os, char c)
-{
- os.put(c);
- return os;
-}
+/// Helper struct for changing stream encoding
+struct SetEnc {
+ SetEnc(std::string const & e) : encoding(e) {}
+ std::string encoding;
+};
+
+/// Helper function for changing stream encoding
+SetEnc setEncoding(std::string const & encoding);
+
+/** Change the encoding of \p os to \p e.encoding.
+ \p e.encoding must be a valid iconv name of an 8bit encoding.
+ This does nothing if the stream is not a file stream, since only
+ file streams do have an associated 8bit encoding.
+ Usage: \code
+ os << setEncoding("ISO-8859-1");
+ \endcode
+ */
+odocstream & operator<<(odocstream & os, SetEnc e);
+idocstream & operator<<(idocstream & os, SetEnc e);
}