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 { 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.
98 static _CharT
* _S_start(const _String
& __str
) { return __CONST_CAST(_CharT
*, __str
.data()); }
99 static _CharT
* _S_finish(const _String
& __str
) { return __CONST_CAST(_CharT
*, __str
.data()) + __str
.size(); }
102 ios_base::openmode _M_mode
;
106 #if defined (_STLP_USE_TEMPLATE_EXPORT)
107 _STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf
<char, char_traits
<char>, allocator
<char> >;
108 # if !defined (_STLP_NO_WCHAR_T)
109 _STLP_EXPORT_TEMPLATE_CLASS basic_stringbuf
<wchar_t, char_traits
<wchar_t>, allocator
<wchar_t> >;
111 #endif /* _STLP_USE_TEMPLATE_EXPORT */
113 //----------------------------------------------------------------------
114 // Class basic_istringstream, an input stream that uses a stringbuf.
116 template <class _CharT
, class _Traits
, class _Alloc
>
117 class basic_istringstream
: public basic_istream
<_CharT
, _Traits
> {
119 typedef typename
_Traits::char_type char_type
;
120 typedef typename
_Traits::int_type int_type
;
121 typedef typename
_Traits::pos_type pos_type
;
122 typedef typename
_Traits::off_type off_type
;
123 typedef _Traits traits_type
;
125 typedef basic_ios
<_CharT
, _Traits
> _Basic_ios
;
126 typedef basic_istream
<_CharT
, _Traits
> _Base
;
127 typedef basic_string
<_CharT
, _Traits
, _Alloc
> _String
;
128 typedef basic_stringbuf
<_CharT
, _Traits
, _Alloc
> _Buf
;
130 public: // Constructors, destructor.
131 basic_istringstream(ios_base::openmode __mode
= ios_base::in
);
132 basic_istringstream(const _String
& __str
,
133 ios_base::openmode __mode
= ios_base::in
);
134 ~basic_istringstream();
136 public: // Member functions
138 basic_stringbuf
<_CharT
, _Traits
, _Alloc
>* rdbuf() const
139 { return __CONST_CAST(_Buf
*,&_M_buf
); }
141 _String
str() const { return _M_buf
.str(); }
142 void str(const _String
& __s
) { _M_buf
.str(__s
); }
145 basic_stringbuf
<_CharT
, _Traits
, _Alloc
> _M_buf
;
147 #if defined (_STLP_MSVC) && (_STLP_MSVC >= 1300 && _STLP_MSVC <= 1310)
148 typedef basic_istringstream
<_CharT
, _Traits
> _Self
;
149 //explicitely defined as private to avoid warnings:
150 basic_istringstream(_Self
const&);
151 _Self
& operator = (_Self
const&);
156 //----------------------------------------------------------------------
157 // Class basic_ostringstream, an output stream that uses a stringbuf.
159 template <class _CharT
, class _Traits
, class _Alloc
>
160 class basic_ostringstream
: public basic_ostream
<_CharT
, _Traits
> {
162 typedef typename
_Traits::char_type char_type
;
163 typedef typename
_Traits::int_type int_type
;
164 typedef typename
_Traits::pos_type pos_type
;
165 typedef typename
_Traits::off_type off_type
;
166 typedef _Traits traits_type
;
168 typedef basic_ios
<_CharT
, _Traits
> _Basic_ios
;
169 typedef basic_ostream
<_CharT
, _Traits
> _Base
;
170 typedef basic_string
<_CharT
, _Traits
, _Alloc
> _String
;
171 typedef basic_stringbuf
<_CharT
, _Traits
, _Alloc
> _Buf
;
173 public: // Constructors, destructor.
174 basic_ostringstream(ios_base::openmode __mode
= ios_base::out
);
175 basic_ostringstream(const _String
& __str
,
176 ios_base::openmode __mode
= ios_base::out
);
177 ~basic_ostringstream();
179 public: // Member functions.
181 basic_stringbuf
<_CharT
, _Traits
, _Alloc
>* rdbuf() const
182 { return __CONST_CAST(_Buf
*,&_M_buf
); }
184 _String
str() const { return _M_buf
.str(); }
185 void str(const _String
& __s
) { _M_buf
.str(__s
); } // dwa 02/07/00 - BUG STOMPER DAVE
189 basic_stringbuf
<_CharT
, _Traits
, _Alloc
> _M_buf
;
191 #if defined (_STLP_MSVC) && (_STLP_MSVC >= 1300 && _STLP_MSVC <= 1310)
192 typedef basic_ostringstream
<_CharT
, _Traits
> _Self
;
193 //explicitely defined as private to avoid warnings:
194 basic_ostringstream(_Self
const&);
195 _Self
& operator = (_Self
const&);
200 //----------------------------------------------------------------------
201 // Class basic_stringstream, a bidirectional stream that uses a stringbuf.
203 template <class _CharT
, class _Traits
, class _Alloc
>
204 class basic_stringstream
: public basic_iostream
<_CharT
, _Traits
> {
206 typedef typename
_Traits::char_type char_type
;
207 typedef typename
_Traits::int_type int_type
;
208 typedef typename
_Traits::pos_type pos_type
;
209 typedef typename
_Traits::off_type off_type
;
210 typedef _Traits traits_type
;
212 typedef basic_ios
<_CharT
, _Traits
> _Basic_ios
;
213 typedef basic_iostream
<_CharT
, _Traits
> _Base
;
214 typedef basic_string
<_CharT
, _Traits
, _Alloc
> _String
;
215 typedef basic_stringbuf
<_CharT
, _Traits
, _Alloc
> _Buf
;
217 typedef ios_base::openmode openmode
;
219 public: // Constructors, destructor.
220 basic_stringstream(openmode __mod
= ios_base::in
| ios_base::out
);
221 basic_stringstream(const _String
& __str
,
222 openmode __mod
= ios_base::in
| ios_base::out
);
223 ~basic_stringstream();
225 public: // Member functions.
227 basic_stringbuf
<_CharT
, _Traits
, _Alloc
>* rdbuf() const
228 { return __CONST_CAST(_Buf
*,&_M_buf
); }
230 _String
str() const { return _M_buf
.str(); }
231 void str(const _String
& __s
) { _M_buf
.str(__s
); }
234 basic_stringbuf
<_CharT
, _Traits
, _Alloc
> _M_buf
;
236 #if defined (_STLP_MSVC) && (_STLP_MSVC >= 1300 && _STLP_MSVC <= 1310)
237 typedef basic_stringstream
<_CharT
, _Traits
> _Self
;
238 //explicitely defined as private to avoid warnings:
239 basic_stringstream(_Self
const&);
240 _Self
& operator = (_Self
const&);
245 #if defined (_STLP_USE_TEMPLATE_EXPORT)
246 _STLP_EXPORT_TEMPLATE_CLASS basic_istringstream
<char, char_traits
<char>, allocator
<char> >;
247 _STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream
<char, char_traits
<char>, allocator
<char> >;
248 _STLP_EXPORT_TEMPLATE_CLASS basic_stringstream
<char, char_traits
<char>, allocator
<char> >;
249 # if !defined (_STLP_NO_WCHAR_T)
250 _STLP_EXPORT_TEMPLATE_CLASS basic_istringstream
<wchar_t, char_traits
<wchar_t>, allocator
<wchar_t> >;
251 _STLP_EXPORT_TEMPLATE_CLASS basic_ostringstream
<wchar_t, char_traits
<wchar_t>, allocator
<wchar_t> >;
252 _STLP_EXPORT_TEMPLATE_CLASS basic_stringstream
<wchar_t, char_traits
<wchar_t>, allocator
<wchar_t> >;
254 #endif /* _STLP_USE_TEMPLATE_EXPORT */
258 #if defined (_STLP_EXPOSE_STREAM_IMPLEMENTATION) && !defined (_STLP_LINK_TIME_INSTANTIATION)
259 # include <stl/_sstream.c>
262 #endif /* _STLP_INTERNAL_SSTREAM */