3 * Silicon Graphics Computer Systems, Inc.
8 * This material is provided "as is", with absolutely no warranty expressed
9 * or implied. Any use is at your own risk.
11 * Permission to use or copy this software for any purpose is hereby granted
12 * without fee, provided the above notices are retained on all copies.
13 * Permission to modify the code and to distribute modified code is granted,
14 * provided the above notices are retained, and a notice that the code was
15 * modified is included with the above copyright notice.
20 // This header defines classes basic_stringbuf, basic_istringstream,
21 // basic_ostringstream, and basic_stringstream. These classes
22 // represent streamsbufs and streams whose sources or destinations are
25 #ifndef _STLP_INTERNAL_SSTREAM
26 #define _STLP_INTERNAL_SSTREAM
28 #ifndef _STLP_INTERNAL_STREAMBUF
29 # include <stl/_streambuf.h>
32 #ifndef _STLP_INTERNAL_ISTREAM
33 # include <stl/_istream.h> // Includes <ostream>, <ios>, <iosfwd>
36 #ifndef _STLP_INTERNAL_STRING_H
37 # include <stl/_string.h>
42 //----------------------------------------------------------------------
43 // This version of basic_stringbuf relies on the internal details of
44 // basic_string. It relies on the fact that, in this implementation,
45 // basic_string's iterators are pointers. It also assumes (as allowed
46 // by the standard) that _CharT is a POD type.
48 // We have a very small buffer for the put area, just so that we don't
49 // have to use append() for every sputc. Conceptually, the buffer
50 // immediately follows the end of the underlying string. We use this
51 // buffer when appending to write-only streambufs, but we don't use it
52 // for read-write streambufs.
54 template <class _CharT, class _Traits, class _Alloc>
55 class basic_stringbuf : public basic_streambuf<_CharT, _Traits> {
57 typedef _CharT char_type;
58 typedef typename _Traits::int_type int_type;
59 typedef typename _Traits::pos_type pos_type;
60 typedef typename _Traits::off_type off_type;
61 typedef _Traits traits_type;
63 typedef basic_streambuf<_CharT, _Traits> _Base;
64 typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Self;
65 typedef basic_string<_CharT, _Traits, _Alloc> _String;
67 public: // Constructors, destructor.
68 explicit basic_stringbuf(ios_base::openmode __mode
69 = ios_base::in | ios_base::out);
70 explicit basic_stringbuf(const _String& __s, ios_base::openmode __mode
71 = ios_base::in | ios_base::out);
72 virtual ~basic_stringbuf();
74 public: // Get or set the string.
75 _String str() const { _M_append_buffer(); return _M_str; }
76 void str(const _String& __s);
78 protected: // Overridden virtual member functions.
79 virtual int_type underflow();
80 virtual int_type uflow();
81 virtual int_type pbackfail(int_type __c);
82 virtual int_type overflow(int_type __c);
83 int_type pbackfail() {return pbackfail(_Traits::eof());}
84 int_type overflow() {return overflow(_Traits::eof());}
86 virtual streamsize xsputn(const char_type* __s, streamsize __n);
87 virtual streamsize _M_xsputnc(char_type __c, streamsize __n);
89 virtual _Base* setbuf(_CharT* __buf, streamsize __n);
90 virtual pos_type seekoff(off_type __off, ios_base::seekdir __dir,
91 ios_base::openmode __mode
92 = ios_base::in | ios_base::out);
93 virtual pos_type seekpos(pos_type __pos, ios_base::openmode __mode
94 = ios_base::in | ios_base::out);
96 private: // Helper functions.
97 // Append the internal buffer to the string if necessary.
98 void _M_append_buffer() const;
102 ios_base::openmode _M_mode;
103 mutable basic_string<_CharT, _Traits, _Alloc> _M_str;
105 enum _JustName { _S_BufSiz = 8 };
106 _CharT _M_Buf[ 8 /* _S_BufSiz */];
109 #if defined (_STLP_USE_TEMPLATE_EXPORT)
110 _STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf<char, char_traits<char>, allocator<char> >;
111 # if !defined (_STLP_NO_WCHAR_T)
112 _STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
114 #endif /* _STLP_USE_TEMPLATE_EXPORT */
116 //----------------------------------------------------------------------
117 // Class basic_istringstream, an input stream that uses a stringbuf.
119 template <class _CharT, class _Traits, class _Alloc>
120 class basic_istringstream : public basic_istream<_CharT, _Traits> {
122 typedef typename _Traits::char_type char_type;
123 typedef typename _Traits::int_type int_type;
124 typedef typename _Traits::pos_type pos_type;
125 typedef typename _Traits::off_type off_type;
126 typedef _Traits traits_type;
128 typedef basic_ios<_CharT, _Traits> _Basic_ios;
129 typedef basic_istream<_CharT, _Traits> _Base;
130 typedef basic_string<_CharT, _Traits, _Alloc> _String;
131 typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Buf;
133 public: // Constructors, destructor.
134 basic_istringstream(ios_base::openmode __mode = ios_base::in);
135 basic_istringstream(const _String& __str,
136 ios_base::openmode __mode = ios_base::in);
137 ~basic_istringstream();
139 public: // Member functions
141 basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
142 { return __CONST_CAST(_Buf*,&_M_buf); }
144 _String str() const { return _M_buf.str(); }
145 void str(const _String& __s) { _M_buf.str(__s); }
148 basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
150 #if defined (_STLP_MSVC) && (_STLP_MSVC >= 1300 && _STLP_MSVC <= 1310)
151 typedef basic_istringstream<_CharT, _Traits> _Self;
152 //explicitely defined as private to avoid warnings:
153 basic_istringstream(_Self const&);
154 _Self& operator = (_Self const&);
159 //----------------------------------------------------------------------
160 // Class basic_ostringstream, an output stream that uses a stringbuf.
162 template <class _CharT, class _Traits, class _Alloc>
163 class basic_ostringstream : public basic_ostream<_CharT, _Traits> {
165 typedef typename _Traits::char_type char_type;
166 typedef typename _Traits::int_type int_type;
167 typedef typename _Traits::pos_type pos_type;
168 typedef typename _Traits::off_type off_type;
169 typedef _Traits traits_type;
171 typedef basic_ios<_CharT, _Traits> _Basic_ios;
172 typedef basic_ostream<_CharT, _Traits> _Base;
173 typedef basic_string<_CharT, _Traits, _Alloc> _String;
174 typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Buf;
176 public: // Constructors, destructor.
177 basic_ostringstream(ios_base::openmode __mode = ios_base::out);
178 basic_ostringstream(const _String& __str,
179 ios_base::openmode __mode = ios_base::out);
180 ~basic_ostringstream();
182 public: // Member functions.
184 basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
185 { return __CONST_CAST(_Buf*,&_M_buf); }
187 _String str() const { return _M_buf.str(); }
188 void str(const _String& __s) { _M_buf.str(__s); } // dwa 02/07/00 - BUG STOMPER DAVE
192 basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
194 #if defined (_STLP_MSVC) && (_STLP_MSVC >= 1300 && _STLP_MSVC <= 1310)
195 typedef basic_ostringstream<_CharT, _Traits> _Self;
196 //explicitely defined as private to avoid warnings:
197 basic_ostringstream(_Self const&);
198 _Self& operator = (_Self const&);
203 //----------------------------------------------------------------------
204 // Class basic_stringstream, a bidirectional stream that uses a stringbuf.
206 template <class _CharT, class _Traits, class _Alloc>
207 class basic_stringstream : public basic_iostream<_CharT, _Traits> {
209 typedef typename _Traits::char_type char_type;
210 typedef typename _Traits::int_type int_type;
211 typedef typename _Traits::pos_type pos_type;
212 typedef typename _Traits::off_type off_type;
213 typedef _Traits traits_type;
215 typedef basic_ios<_CharT, _Traits> _Basic_ios;
216 typedef basic_iostream<_CharT, _Traits> _Base;
217 typedef basic_string<_CharT, _Traits, _Alloc> _String;
218 typedef basic_stringbuf<_CharT, _Traits, _Alloc> _Buf;
220 typedef ios_base::openmode openmode;
222 public: // Constructors, destructor.
223 basic_stringstream(openmode __mod = ios_base::in | ios_base::out);
224 basic_stringstream(const _String& __str,
225 openmode __mod = ios_base::in | ios_base::out);
226 ~basic_stringstream();
228 public: // Member functions.
230 basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
231 { return __CONST_CAST(_Buf*,&_M_buf); }
233 _String str() const { return _M_buf.str(); }
234 void str(const _String& __s) { _M_buf.str(__s); }
237 basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
239 #if defined (_STLP_MSVC) && (_STLP_MSVC >= 1300 && _STLP_MSVC <= 1310)
240 typedef basic_stringstream<_CharT, _Traits> _Self;
241 //explicitely defined as private to avoid warnings:
242 basic_stringstream(_Self const&);
243 _Self& operator = (_Self const&);
248 #if defined (_STLP_USE_TEMPLATE_EXPORT)
249 _STLP_EXPORT_TEMPLATE_CLASS basic_istringstream<char, char_traits<char>, allocator<char> >;
250 _STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream<char, char_traits<char>, allocator<char> >;
251 _STLP_EXPORT_TEMPLATE_CLASS basic_stringstream<char, char_traits<char>, allocator<char> >;
252 # if !defined (_STLP_NO_WCHAR_T)
253 _STLP_EXPORT_TEMPLATE_CLASS basic_istringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
254 _STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
255 _STLP_EXPORT_TEMPLATE_CLASS basic_stringstream<wchar_t, char_traits<wchar_t>, allocator<wchar_t> >;
257 #endif /* _STLP_USE_TEMPLATE_EXPORT */
261 #if defined (_STLP_EXPOSE_STREAM_IMPLEMENTATION) && !defined (_STLP_LINK_TIME_INSTANTIATION)
262 # include <stl/_sstream.c>
265 #endif /* _STLP_INTERNAL_SSTREAM */