1/*
2 * Copyright (c) 1999
3 * Silicon Graphics Computer Systems, Inc.
4 *
5 * Copyright (c) 1999
6 * Boris Fomitchev
7 *
8 * This material is provided "as is", with absolutely no warranty expressed
9 * or implied. Any use is at your own risk.
10 *
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.
16 *
17 */
18
19
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
23// C++ strings.
24
25#ifndef _STLP_INTERNAL_SSTREAM
26#define _STLP_INTERNAL_SSTREAM
27
28#ifndef _STLP_INTERNAL_STREAMBUF
29#  include <stl/_streambuf.h>
30#endif
31
32#ifndef _STLP_INTERNAL_ISTREAM
33#  include <stl/_istream.h> // Includes <ostream>, <ios>, <iosfwd>
34#endif
35
36#ifndef _STLP_INTERNAL_STRING_H
37#  include <stl/_string.h>
38#endif
39
40_STLP_BEGIN_NAMESPACE
41
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.
47
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.
53
54template <class _CharT, class _Traits, class _Alloc>
55class basic_stringbuf : public basic_streambuf<_CharT, _Traits> {
56public:                         // Typedefs.
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;
62
63  typedef basic_streambuf<_CharT, _Traits>          _Base;
64  typedef basic_stringbuf<_CharT, _Traits, _Alloc>  _Self;
65  typedef basic_string<_CharT, _Traits, _Alloc>     _String;
66
67public:                         // 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();
73
74public:                         // Get or set the string.
75  _String str() const { return _M_str; }
76  void str(const _String& __s);
77
78protected:                      // 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());}
85
86  virtual streamsize xsputn(const char_type* __s, streamsize __n);
87  virtual streamsize _M_xsputnc(char_type __c, streamsize __n);
88
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);
95
96private:                        // Helper functions.
97  void _M_set_ptrs();
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(); }
100
101private:
102  ios_base::openmode _M_mode;
103  _String _M_str;
104};
105
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>  >;
110#  endif
111#endif /* _STLP_USE_TEMPLATE_EXPORT */
112
113//----------------------------------------------------------------------
114// Class basic_istringstream, an input stream that uses a stringbuf.
115
116template <class _CharT, class _Traits, class _Alloc>
117class basic_istringstream : public basic_istream<_CharT, _Traits> {
118public:                         // Typedefs
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;
124
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;
129
130public:                         // 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();
135
136public:                         // Member functions
137
138  basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
139    { return __CONST_CAST(_Buf*,&_M_buf); }
140
141  _String str() const { return _M_buf.str(); }
142  void str(const _String& __s) { _M_buf.str(__s); }
143
144private:
145  basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
146
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&);
152#endif
153};
154
155
156//----------------------------------------------------------------------
157// Class basic_ostringstream, an output stream that uses a stringbuf.
158
159template <class _CharT, class _Traits, class _Alloc>
160class basic_ostringstream : public basic_ostream<_CharT, _Traits> {
161public:                         // Typedefs
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;
167
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;
172
173public:                         // 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();
178
179public:                         // Member functions.
180
181  basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
182    { return __CONST_CAST(_Buf*,&_M_buf); }
183
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
186
187
188private:
189  basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
190
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&);
196#endif
197};
198
199
200//----------------------------------------------------------------------
201// Class basic_stringstream, a bidirectional stream that uses a stringbuf.
202
203template <class _CharT, class _Traits, class _Alloc>
204class basic_stringstream : public basic_iostream<_CharT, _Traits> {
205public:                         // Typedefs
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;
211
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;
216
217  typedef ios_base::openmode openmode;
218
219public:                         // 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();
224
225public:                         // Member functions.
226
227  basic_stringbuf<_CharT, _Traits, _Alloc>* rdbuf() const
228    { return __CONST_CAST(_Buf*,&_M_buf); }
229
230  _String str() const { return _M_buf.str(); }
231    void str(const _String& __s) { _M_buf.str(__s); }
232
233private:
234  basic_stringbuf<_CharT, _Traits, _Alloc> _M_buf;
235
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&);
241#endif
242};
243
244
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>  >;
253#  endif
254#endif /* _STLP_USE_TEMPLATE_EXPORT */
255
256_STLP_END_NAMESPACE
257
258#if defined (_STLP_EXPOSE_STREAM_IMPLEMENTATION) && !defined (_STLP_LINK_TIME_INSTANTIATION)
259#  include <stl/_sstream.c>
260#endif
261
262#endif /* _STLP_INTERNAL_SSTREAM */
263
264// Local Variables:
265// mode:C++
266// End:
267