/*
* Copyright (c) 1999
* Silicon Graphics Computer Systems, Inc.
*
* Copyright (c) 1999
* Boris Fomitchev
*
* This material is provided "as is", with absolutely no warranty expressed
* or implied. Any use is at your own risk.
*
* Permission to use or copy this software for any purpose is hereby granted
* without fee, provided the above notices are retained on all copies.
* Permission to modify the code and to distribute modified code is granted,
* provided the above notices are retained, and a notice that the code was
* modified is included with the above copyright notice.
*
*/
// This header defines classes basic_stringbuf, basic_istringstream,
// basic_ostringstream, and basic_stringstream. These classes
// represent streamsbufs and streams whose sources or destinations are
// C++ strings.
#ifndef _STLP_SSTREAM_H
#define _STLP_SSTREAM_H
#ifndef _STLP_INTERNAL_STREAMBUF
# include <stl/_streambuf.h>
#endif
#ifndef _STLP_INTERNAL_ISTREAM_H
# include <stl/_istream.h> // Includes <ostream>, <ios>, <iosfwd>
#endif
#ifndef _STLP_STRING_H
# include <stl/_string.h>
#endif
_STLP_BEGIN_NAMESPACE
//----------------------------------------------------------------------
// This version of basic_stringbuf relies on the internal details of
// basic_string. It relies on the fact that, in this implementation,
// basic_string's iterators are pointers. It also assumes (as allowed
// by the standard) that _CharT is a POD type.
// We have a very small buffer for the put area, just so that we don't
// have to use append() for every sputc. Conceptually, the buffer
// immediately follows the end of the underlying string. We use this
// buffer when appending to write-only streambufs, but we don't use it
// for read-write streambufs.
template <class _CharT, class _Traits, class _Alloc>
class basic_stringbuf : public basic_streambuf<_CharT, _Traits>
{
public: // Typedefs.
typedef _CharT char_type;
typedef typename _Traits::int_type int_type;
typedef typename _Traits::pos_type pos_type;
typedef typename _Traits::off_type off_type;
typedef _Traits traits_type;
typedef basic_streambuf<_CharT, _Traits> _Base;
typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Self;
typedef basic_string<_CharT, _Traits, _Alloc> _String;
public: // Constructors, destructor.
explicit basic_stringbuf(ios_base::openmode __mode
= ios_base::in | ios_base::out);
explicit basic_stringbuf(const _String& __s, ios_base::openmode __mode
= ios_base::in | ios_base::out);
virtual ~basic_stringbuf();
public: // Get or set the string.
_String str() const { _M_append_buffer(); return _M_str; }
void str(const _String& __s);
protected: // Overridden virtual member functions.
virtual int_type underflow();
virtual int_type uflow();
virtual int_type pbackfail(int_type __c);
virtual int_type overflow(int_type __c);
int_type pbackfail() {return pbackfail(_Traits::eof());}
int_type overflow() {return overflow(_Traits::eof());}
virtual streamsize xsputn(const char_type* __s, streamsize __n);
virtual streamsize _M_xsputnc(char_type __c, streamsize __n);
virtual _Base* setbuf(_CharT* __buf, streamsize __n);
virtual pos_type seekoff(off_type __off, ios_base::seekdir __dir,
ios_base::openmode __mode
= ios_base::in | ios_base::out);
virtual pos_type seekpos(pos_type __pos, ios_base::openmode __mode
= ios_base::in | ios_base::out);
private: // Helper functions.
// Append the internal buffer to the string if necessary.
void _M_append_buffer() const;
void _M_set_ptrs();
private:
ios_base::openmode _M_mode;
mutable basic_string<_CharT, _Traits, _Alloc> _M_str;
enum _JustName { _S_BufSiz = 8 };
_CharT _M_Buf[ 8 /* _S_BufSiz */];
};
# if defined (_STLP_USE_TEMPLATE_EXPORT)
_STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf<char, char_traits<char>, allocator<char> >;
# if !defined (_STLP_NO_WCHAR_T)
_STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
# endif
# endif /* _STLP_USE_TEMPLATE_EXPORT */
//----------------------------------------------------------------------
// Class basic_istringstream, an input stream that uses a stringbuf.
template <class _CharT, class _Traits, class _Alloc>
class basic_istringstream : public basic_istream<_CharT, _Traits>
{
public: // Typedefs
typedef typename _Traits::char_type char_type;
typedef typename _Traits::int_type int_type;
typedef typename _Traits::pos_type pos_type;
typedef typename _Traits::off_type off_type;
typedef _Traits traits_type;
typedef basic_ios<_CharT, _Traits> _Basic_ios;
typedef basic_istream<_CharT, _Traits> _Base;
typedef basic_string<_CharT, _Traits, _Alloc> _String;
typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Buf;
public: // Constructors, destructor.
basic_istringstream(ios_base::openmode __mode = ios_base::in);
basic_istringstream(const _String& __str,
ios_base::openmode __mode = ios_base::in);
~basic_istringstream();
public: // Member functions
basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
{ return __CONST_CAST(_Buf*,&_M_buf); }
_String str() const { return _M_buf.str(); }
void str(const _String& __s) { _M_buf.str(__s); }
private:
basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
};
//----------------------------------------------------------------------
// Class basic_ostringstream, an output stream that uses a stringbuf.
template <class _CharT, class _Traits, class _Alloc>
class basic_ostringstream : public basic_ostream<_CharT, _Traits>
{
public: // Typedefs
typedef typename _Traits::char_type char_type;
typedef typename _Traits::int_type int_type;
typedef typename _Traits::pos_type pos_type;
typedef typename _Traits::off_type off_type;
typedef _Traits traits_type;
typedef basic_ios<_CharT, _Traits> _Basic_ios;
typedef basic_ostream<_CharT, _Traits> _Base;
typedef basic_string<_CharT, _Traits, _Alloc> _String;
typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Buf;
public: // Constructors, destructor.
basic_ostringstream(ios_base::openmode __mode = ios_base::out);
basic_ostringstream(const _String& __str,
ios_base::openmode __mode = ios_base::out);
~basic_ostringstream();
public: // Member functions.
basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
{ return __CONST_CAST(_Buf*,&_M_buf); }
_String str() const { return _M_buf.str(); }
void str(const _String& __s) { _M_buf.str(__s); } // dwa 02/07/00 - BUG STOMPER DAVE
private:
basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
};
//----------------------------------------------------------------------
// Class basic_stringstream, a bidirectional stream that uses a stringbuf.
template <class _CharT, class _Traits, class _Alloc>
class basic_stringstream : public basic_iostream<_CharT, _Traits>
{
public: // Typedefs
typedef typename _Traits::char_type char_type;
typedef typename _Traits::int_type int_type;
typedef typename _Traits::pos_type pos_type;
typedef typename _Traits::off_type off_type;
typedef _Traits traits_type;
typedef basic_ios<_CharT, _Traits> _Basic_ios;
typedef basic_iostream<_CharT, _Traits> _Base;
typedef basic_string<_CharT, _Traits, _Alloc> _String;
typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Buf;
typedef ios_base::openmode openmode;
public: // Constructors, destructor.
basic_stringstream(openmode __mod = ios_base::in | ios_base::out);
basic_stringstream(const _String& __str,
openmode __mod = ios_base::in | ios_base::out);
~basic_stringstream();
public: // Member functions.
basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
{ return __CONST_CAST(_Buf*,&_M_buf); }
_String str() const { return _M_buf.str(); }
void str(const _String& __s) { _M_buf.str(__s); }
private:
basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
};
# if defined (_STLP_USE_TEMPLATE_EXPORT)
_STLP_EXPORT_TEMPLATE_CLASS basic_istringstream<char, char_traits<char>, allocator<char> >;
_STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream<char, char_traits<char>, allocator<char> >;
_STLP_EXPORT_TEMPLATE_CLASS basic_stringstream<char, char_traits<char>, allocator<char> >;
# if !defined (_STLP_NO_WCHAR_T)
_STLP_EXPORT_TEMPLATE_CLASS basic_istringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
_STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
_STLP_EXPORT_TEMPLATE_CLASS basic_stringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
# endif
# endif /* _STLP_USE_TEMPLATE_EXPORT */
_STLP_END_NAMESPACE
# if defined (_STLP_EXPOSE_STREAM_IMPLEMENTATION) && !defined (_STLP_LINK_TIME_INSTANTIATION)
# include <stl/_sstream.c>
# endif
#endif /* _STLP_SSTREAM_H */
// Local Variables:
// mode:C++
// End:
Submit an article or tip