]> git.ipfire.org Git - thirdparty/gcc.git/blame - libstdc++-v3/include/std/sstream
Update copyright years.
[thirdparty/gcc.git] / libstdc++-v3 / include / std / sstream
CommitLineData
54c1bf78 1// String based streams -*- C++ -*-
de96ac46 2
85ec4feb 3// Copyright (C) 1997-2018 Free Software Foundation, Inc.
de96ac46
BK
4//
5// This file is part of the GNU ISO C++ Library. This library is free
6// software; you can redistribute it and/or modify it under the
7// terms of the GNU General Public License as published by the
748086b7 8// Free Software Foundation; either version 3, or (at your option)
de96ac46
BK
9// any later version.
10
11// This library is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14// GNU General Public License for more details.
15
748086b7
JJ
16// Under Section 7 of GPL version 3, you are granted additional
17// permissions described in the GCC Runtime Library Exception, version
18// 3.1, as published by the Free Software Foundation.
19
20// You should have received a copy of the GNU General Public License and
21// a copy of the GCC Runtime Library Exception along with this program;
22// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23// <http://www.gnu.org/licenses/>.
de96ac46 24
f910786b 25/** @file include/sstream
0aa06b18 26 * This is a Standard C++ Library header.
2f9d51b8
PE
27 */
28
143c27b0
BK
29//
30// ISO C++ 14882: 27.7 String-based streams
31//
32
1143680e
SE
33#ifndef _GLIBCXX_SSTREAM
34#define _GLIBCXX_SSTREAM 1
54c1bf78
BK
35
36#pragma GCC system_header
37
38#include <istream>
39#include <ostream>
40
12ffa228
BK
41namespace std _GLIBCXX_VISIBILITY(default)
42{
43_GLIBCXX_BEGIN_NAMESPACE_VERSION
34a2b755 44_GLIBCXX_BEGIN_NAMESPACE_CXX11
3cbc7af0 45
840ceb34
PE
46 // [27.7.1] template class basic_stringbuf
47 /**
48 * @brief The actual work of input and output (for std::string).
5b9daa7e 49 * @ingroup io
840ceb34 50 *
d632488a
BK
51 * @tparam _CharT Type of character stream.
52 * @tparam _Traits Traits for character type, defaults to
53 * char_traits<_CharT>.
54 * @tparam _Alloc Allocator type, defaults to allocator<_CharT>.
55 *
840ceb34
PE
56 * This class associates either or both of its input and output sequences
57 * with a sequence of characters, which can be initialized from, or made
58 * available as, a @c std::basic_string. (Paraphrased from [27.7.1]/1.)
59 *
60 * For this class, open modes (of type @c ios_base::openmode) have
61 * @c in set if the input sequence can be read, and @c out set if the
62 * output sequence can be written.
63 */
54c1bf78
BK
64 template<typename _CharT, typename _Traits, typename _Alloc>
65 class basic_stringbuf : public basic_streambuf<_CharT, _Traits>
66 {
34a2b755 67 struct __xfer_bufptrs;
54c1bf78
BK
68 public:
69 // Types:
70 typedef _CharT char_type;
71 typedef _Traits traits_type;
f5677b15
PC
72 // _GLIBCXX_RESOLVE_LIB_DEFECTS
73 // 251. basic_stringbuf missing allocator_type
54c1bf78 74 typedef _Alloc allocator_type;
54c1bf78
BK
75 typedef typename traits_type::int_type int_type;
76 typedef typename traits_type::pos_type pos_type;
77 typedef typename traits_type::off_type off_type;
78
54c1bf78
BK
79 typedef basic_streambuf<char_type, traits_type> __streambuf_type;
80 typedef basic_string<char_type, _Traits, _Alloc> __string_type;
81 typedef typename __string_type::size_type __size_type;
82
6f48900c 83 protected:
4312e020 84 /// Place to stash in || out || in | out settings for current stringbuf.
cd16e04b
PC
85 ios_base::openmode _M_mode;
86
54c1bf78
BK
87 // Data Members:
88 __string_type _M_string;
798355a2 89
54c1bf78
BK
90 public:
91 // Constructors:
840ceb34
PE
92 /**
93 * @brief Starts with an empty string buffer.
93c66bc6 94 * @param __mode Whether the buffer can read, or write, or both.
840ceb34
PE
95 *
96 * The default constructor initializes the parent class using its
97 * own default ctor.
98 */
798355a2 99 explicit
54c1bf78 100 basic_stringbuf(ios_base::openmode __mode = ios_base::in | ios_base::out)
983de0da
PC
101 : __streambuf_type(), _M_mode(__mode), _M_string()
102 { }
54c1bf78 103
840ceb34
PE
104 /**
105 * @brief Starts with an existing string buffer.
93c66bc6
BK
106 * @param __str A string to copy as a starting buffer.
107 * @param __mode Whether the buffer can read, or write, or both.
840ceb34
PE
108 *
109 * This constructor initializes the parent class using its
110 * own default ctor.
111 */
798355a2 112 explicit
54c1bf78
BK
113 basic_stringbuf(const __string_type& __str,
114 ios_base::openmode __mode = ios_base::in | ios_base::out)
387c17d3
JW
115 : __streambuf_type(), _M_mode(),
116 _M_string(__str.data(), __str.size(), __str.get_allocator())
54c1bf78
BK
117 { _M_stringbuf_init(__mode); }
118
9b817548
JW
119#if __cplusplus >= 201103L
120 basic_stringbuf(const basic_stringbuf&) = delete;
121
122 basic_stringbuf(basic_stringbuf&& __rhs)
34a2b755
JW
123 : basic_stringbuf(std::move(__rhs), __xfer_bufptrs(__rhs, this))
124 { __rhs._M_sync(const_cast<char_type*>(__rhs._M_string.data()), 0, 0); }
9b817548
JW
125
126 // 27.8.2.2 Assign and swap:
127
128 basic_stringbuf&
129 operator=(const basic_stringbuf&) = delete;
130
131 basic_stringbuf&
132 operator=(basic_stringbuf&& __rhs)
133 {
34a2b755 134 __xfer_bufptrs __st{__rhs, this};
9b817548
JW
135 const __streambuf_type& __base = __rhs;
136 __streambuf_type::operator=(__base);
137 this->pubimbue(__rhs.getloc());
138 _M_mode = __rhs._M_mode;
139 _M_string = std::move(__rhs._M_string);
34a2b755 140 __rhs._M_sync(const_cast<char_type*>(__rhs._M_string.data()), 0, 0);
9b817548
JW
141 return *this;
142 }
143
144 void
145 swap(basic_stringbuf& __rhs)
146 {
34a2b755
JW
147 __xfer_bufptrs __l_st{*this, std::__addressof(__rhs)};
148 __xfer_bufptrs __r_st{__rhs, this};
9b817548
JW
149 __streambuf_type& __base = __rhs;
150 __streambuf_type::swap(__base);
151 __rhs.pubimbue(this->pubimbue(__rhs.getloc()));
152 std::swap(_M_mode, __rhs._M_mode);
153 std::swap(_M_string, __rhs._M_string);
154 }
155#endif
156
54c1bf78 157 // Get and set:
840ceb34
PE
158 /**
159 * @brief Copying out the string buffer.
160 * @return A copy of one of the underlying sequences.
161 *
2a60a9f6 162 * <em>If the buffer is only created in input mode, the underlying
840ceb34 163 * character sequence is equal to the input sequence; otherwise, it
2a60a9f6 164 * is equal to the output sequence.</em> [27.7.1.2]/1
840ceb34 165 */
798355a2
PE
166 __string_type
167 str() const
54c1bf78 168 {
387c17d3 169 __string_type __ret(_M_string.get_allocator());
983de0da 170 if (this->pptr())
1b170b55
PC
171 {
172 // The current egptr() may not be the actual string end.
173 if (this->pptr() > this->egptr())
387c17d3 174 __ret.assign(this->pbase(), this->pptr());
1b170b55 175 else
387c17d3 176 __ret.assign(this->pbase(), this->egptr());
1b170b55
PC
177 }
178 else
fdeeef7f
BK
179 __ret = _M_string;
180 return __ret;
54c1bf78
BK
181 }
182
840ceb34
PE
183 /**
184 * @brief Setting a new buffer.
93c66bc6 185 * @param __s The string to use as a new sequence.
840ceb34
PE
186 *
187 * Deallocates any previous stored sequence, then copies @a s to
188 * use as a new one.
189 */
798355a2 190 void
54c1bf78
BK
191 str(const __string_type& __s)
192 {
34a2b755
JW
193 // Cannot use _M_string = __s, since v3 strings are COW
194 // (not always true now but assign() always works).
93d87ec6 195 _M_string.assign(__s.data(), __s.size());
fdeeef7f 196 _M_stringbuf_init(_M_mode);
54c1bf78
BK
197 }
198
199 protected:
983de0da 200 // Common initialization code goes here.
54c1bf78
BK
201 void
202 _M_stringbuf_init(ios_base::openmode __mode)
203 {
fdeeef7f 204 _M_mode = __mode;
23cac885 205 __size_type __len = 0;
fdeeef7f 206 if (_M_mode & (ios_base::ate | ios_base::app))
23cac885 207 __len = _M_string.size();
655d7821 208 _M_sync(const_cast<char_type*>(_M_string.data()), 0, __len);
54c1bf78
BK
209 }
210
fdeeef7f
BK
211 virtual streamsize
212 showmanyc()
33ac58d5 213 {
fdeeef7f
BK
214 streamsize __ret = -1;
215 if (_M_mode & ios_base::in)
216 {
217 _M_update_egptr();
218 __ret = this->egptr() - this->gptr();
219 }
220 return __ret;
221 }
222
1b170b55 223 virtual int_type
cd16e04b 224 underflow();
54c1bf78 225
798355a2 226 virtual int_type
54c1bf78
BK
227 pbackfail(int_type __c = traits_type::eof());
228
798355a2 229 virtual int_type
54c1bf78
BK
230 overflow(int_type __c = traits_type::eof());
231
840ceb34
PE
232 /**
233 * @brief Manipulates the buffer.
93c66bc6
BK
234 * @param __s Pointer to a buffer area.
235 * @param __n Size of @a __s.
840ceb34
PE
236 * @return @c this
237 *
93c66bc6
BK
238 * If no buffer has already been created, and both @a __s and @a __n are
239 * non-zero, then @c __s is used as a buffer; see
10d43d2f 240 * https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html#io.streambuf.buffering
840ceb34
PE
241 * for more.
242 */
798355a2 243 virtual __streambuf_type*
54c1bf78 244 setbuf(char_type* __s, streamsize __n)
798355a2 245 {
b82a33d2 246 if (__s && __n >= 0)
54c1bf78 247 {
23cac885 248 // This is implementation-defined behavior, and assumes
b82a33d2
PC
249 // that an external char_type array of length __n exists
250 // and has been pre-allocated. If this is not the case,
251 // things will quickly blow up.
33ac58d5 252
23cac885 253 // Step 1: Destroy the current internal array.
62448787 254 _M_string.clear();
33ac58d5 255
23cac885 256 // Step 2: Use the external array.
62448787 257 _M_sync(__s, __n, 0);
54c1bf78 258 }
798355a2
PE
259 return this;
260 }
54c1bf78 261
798355a2 262 virtual pos_type
54c1bf78
BK
263 seekoff(off_type __off, ios_base::seekdir __way,
264 ios_base::openmode __mode = ios_base::in | ios_base::out);
265
798355a2
PE
266 virtual pos_type
267 seekpos(pos_type __sp,
54c1bf78
BK
268 ios_base::openmode __mode = ios_base::in | ios_base::out);
269
270 // Internal function for correctly updating the internal buffer
10d9600d
PC
271 // for a particular _M_string, due to initialization or re-sizing
272 // of an existing _M_string.
50af15ec 273 void
10d9600d 274 _M_sync(char_type* __base, __size_type __i, __size_type __o);
1b170b55
PC
275
276 // Internal function for correctly updating egptr() to the actual
277 // string end.
278 void
279 _M_update_egptr()
280 {
fdeeef7f 281 const bool __testin = _M_mode & ios_base::in;
983de0da 282 if (this->pptr() && this->pptr() > this->egptr())
d9cdfe6a
BK
283 {
284 if (__testin)
285 this->setg(this->eback(), this->gptr(), this->pptr());
286 else
287 this->setg(this->pptr(), this->pptr(), this->pptr());
288 }
1b170b55 289 }
1139a735
PC
290
291 // Works around the issue with pbump, part of the protected
292 // interface of basic_streambuf, taking just an int.
293 void
294 _M_pbump(char_type* __pbeg, char_type* __pend, off_type __off);
34a2b755
JW
295
296 private:
297#if __cplusplus >= 201103L
298#if _GLIBCXX_USE_CXX11_ABI
299 // This type captures the state of the gptr / pptr pointers as offsets
300 // so they can be restored in another object after moving the string.
301 struct __xfer_bufptrs
302 {
303 __xfer_bufptrs(const basic_stringbuf& __from, basic_stringbuf* __to)
304 : _M_to{__to}, _M_goff{-1, -1, -1}, _M_poff{-1, -1, -1}
305 {
93ef155b
JW
306 const _CharT* const __str = __from._M_string.data();
307 const _CharT* __end = nullptr;
34a2b755
JW
308 if (__from.eback())
309 {
93ef155b
JW
310 _M_goff[0] = __from.eback() - __str;
311 _M_goff[1] = __from.gptr() - __str;
312 _M_goff[2] = __from.egptr() - __str;
313 __end = __from.egptr();
34a2b755
JW
314 }
315 if (__from.pbase())
316 {
317 _M_poff[0] = __from.pbase() - __str;
318 _M_poff[1] = __from.pptr() - __from.pbase();
319 _M_poff[2] = __from.epptr() - __str;
93ef155b
JW
320 if (__from.pptr() > __end)
321 __end = __from.pptr();
322 }
323
324 // Set _M_string length to the greater of the get and put areas.
325 if (__end)
326 {
327 // The const_cast avoids changing this constructor's signature,
328 // because it is exported from the dynamic library.
329 auto& __mut_from = const_cast<basic_stringbuf&>(__from);
330 __mut_from._M_string._M_length(__end - __str);
34a2b755
JW
331 }
332 }
333
334 ~__xfer_bufptrs()
335 {
336 char_type* __str = const_cast<char_type*>(_M_to->_M_string.data());
337 if (_M_goff[0] != -1)
338 _M_to->setg(__str+_M_goff[0], __str+_M_goff[1], __str+_M_goff[2]);
339 if (_M_poff[0] != -1)
340 _M_to->_M_pbump(__str+_M_poff[0], __str+_M_poff[2], _M_poff[1]);
341 }
342
343 basic_stringbuf* _M_to;
344 off_type _M_goff[3];
345 off_type _M_poff[3];
346 };
347#else
348 // This type does nothing when using Copy-On-Write strings.
349 struct __xfer_bufptrs
350 {
351 __xfer_bufptrs(const basic_stringbuf&, basic_stringbuf*) { }
352 };
353#endif
354
355 // The move constructor initializes an __xfer_bufptrs temporary then
356 // delegates to this constructor to performs moves during its lifetime.
357 basic_stringbuf(basic_stringbuf&& __rhs, __xfer_bufptrs&&)
358 : __streambuf_type(static_cast<const __streambuf_type&>(__rhs)),
359 _M_mode(__rhs._M_mode), _M_string(std::move(__rhs._M_string))
360 { }
361#endif
54c1bf78
BK
362 };
363
364
840ceb34
PE
365 // [27.7.2] Template class basic_istringstream
366 /**
367 * @brief Controlling input for std::string.
5b9daa7e 368 * @ingroup io
840ceb34 369 *
d632488a
BK
370 * @tparam _CharT Type of character stream.
371 * @tparam _Traits Traits for character type, defaults to
372 * char_traits<_CharT>.
373 * @tparam _Alloc Allocator type, defaults to allocator<_CharT>.
374 *
840ceb34
PE
375 * This class supports reading from objects of type std::basic_string,
376 * using the inherited functions from std::basic_istream. To control
377 * the associated sequence, an instance of std::basic_stringbuf is used,
378 * which this page refers to as @c sb.
379 */
54c1bf78
BK
380 template<typename _CharT, typename _Traits, typename _Alloc>
381 class basic_istringstream : public basic_istream<_CharT, _Traits>
382 {
383 public:
384 // Types:
385 typedef _CharT char_type;
386 typedef _Traits traits_type;
f5677b15
PC
387 // _GLIBCXX_RESOLVE_LIB_DEFECTS
388 // 251. basic_stringbuf missing allocator_type
54c1bf78 389 typedef _Alloc allocator_type;
54c1bf78
BK
390 typedef typename traits_type::int_type int_type;
391 typedef typename traits_type::pos_type pos_type;
392 typedef typename traits_type::off_type off_type;
393
394 // Non-standard types:
395 typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
396 typedef basic_stringbuf<_CharT, _Traits, _Alloc> __stringbuf_type;
397 typedef basic_istream<char_type, traits_type> __istream_type;
398
399 private:
400 __stringbuf_type _M_stringbuf;
401
402 public:
403 // Constructors:
840ceb34
PE
404 /**
405 * @brief Default constructor starts with an empty string buffer.
93c66bc6 406 * @param __mode Whether the buffer can read, or write, or both.
840ceb34 407 *
93c66bc6 408 * @c ios_base::in is automatically included in @a __mode.
840ceb34 409 *
93c66bc6 410 * Initializes @c sb using @c __mode|in, and passes @c &sb to the base
840ceb34
PE
411 * class initializer. Does not allocate any buffer.
412 *
840ceb34
PE
413 * That's a lie. We initialize the base class with NULL, because the
414 * string class does its own memory management.
840ceb34 415 */
798355a2 416 explicit
54c1bf78 417 basic_istringstream(ios_base::openmode __mode = ios_base::in)
d29cc32f 418 : __istream_type(), _M_stringbuf(__mode | ios_base::in)
54c1bf78
BK
419 { this->init(&_M_stringbuf); }
420
840ceb34
PE
421 /**
422 * @brief Starts with an existing string buffer.
93c66bc6
BK
423 * @param __str A string to copy as a starting buffer.
424 * @param __mode Whether the buffer can read, or write, or both.
840ceb34
PE
425 *
426 * @c ios_base::in is automatically included in @a mode.
427 *
428 * Initializes @c sb using @a str and @c mode|in, and passes @c &sb
429 * to the base class initializer.
430 *
840ceb34
PE
431 * That's a lie. We initialize the base class with NULL, because the
432 * string class does its own memory management.
840ceb34 433 */
798355a2 434 explicit
54c1bf78
BK
435 basic_istringstream(const __string_type& __str,
436 ios_base::openmode __mode = ios_base::in)
d29cc32f 437 : __istream_type(), _M_stringbuf(__str, __mode | ios_base::in)
54c1bf78
BK
438 { this->init(&_M_stringbuf); }
439
840ceb34
PE
440 /**
441 * @brief The destructor does nothing.
442 *
443 * The buffer is deallocated by the stringbuf object, not the
444 * formatting stream.
445 */
54c1bf78
BK
446 ~basic_istringstream()
447 { }
448
9b817548
JW
449#if __cplusplus >= 201103L
450 basic_istringstream(const basic_istringstream&) = delete;
451
452 basic_istringstream(basic_istringstream&& __rhs)
453 : __istream_type(std::move(__rhs)),
454 _M_stringbuf(std::move(__rhs._M_stringbuf))
455 { __istream_type::set_rdbuf(&_M_stringbuf); }
456
457 // 27.8.3.2 Assign and swap:
458
459 basic_istringstream&
460 operator=(const basic_istringstream&) = delete;
461
462 basic_istringstream&
463 operator=(basic_istringstream&& __rhs)
464 {
465 __istream_type::operator=(std::move(__rhs));
466 _M_stringbuf = std::move(__rhs._M_stringbuf);
467 return *this;
468 }
469
470 void
471 swap(basic_istringstream& __rhs)
472 {
473 __istream_type::swap(__rhs);
474 _M_stringbuf.swap(__rhs._M_stringbuf);
475 }
476#endif
477
54c1bf78 478 // Members:
840ceb34
PE
479 /**
480 * @brief Accessing the underlying buffer.
481 * @return The current basic_stringbuf buffer.
482 *
483 * This hides both signatures of std::basic_ios::rdbuf().
484 */
798355a2 485 __stringbuf_type*
54c1bf78
BK
486 rdbuf() const
487 { return const_cast<__stringbuf_type*>(&_M_stringbuf); }
488
840ceb34
PE
489 /**
490 * @brief Copying out the string buffer.
491 * @return @c rdbuf()->str()
492 */
54c1bf78
BK
493 __string_type
494 str() const
495 { return _M_stringbuf.str(); }
798355a2 496
840ceb34
PE
497 /**
498 * @brief Setting a new buffer.
93c66bc6 499 * @param __s The string to use as a new sequence.
840ceb34
PE
500 *
501 * Calls @c rdbuf()->str(s).
502 */
798355a2 503 void
54c1bf78
BK
504 str(const __string_type& __s)
505 { _M_stringbuf.str(__s); }
506 };
507
508
840ceb34
PE
509 // [27.7.3] Template class basic_ostringstream
510 /**
511 * @brief Controlling output for std::string.
5b9daa7e 512 * @ingroup io
840ceb34 513 *
d632488a
BK
514 * @tparam _CharT Type of character stream.
515 * @tparam _Traits Traits for character type, defaults to
516 * char_traits<_CharT>.
517 * @tparam _Alloc Allocator type, defaults to allocator<_CharT>.
518 *
840ceb34
PE
519 * This class supports writing to objects of type std::basic_string,
520 * using the inherited functions from std::basic_ostream. To control
521 * the associated sequence, an instance of std::basic_stringbuf is used,
522 * which this page refers to as @c sb.
523 */
54c1bf78
BK
524 template <typename _CharT, typename _Traits, typename _Alloc>
525 class basic_ostringstream : public basic_ostream<_CharT, _Traits>
526 {
527 public:
528 // Types:
529 typedef _CharT char_type;
530 typedef _Traits traits_type;
f5677b15
PC
531 // _GLIBCXX_RESOLVE_LIB_DEFECTS
532 // 251. basic_stringbuf missing allocator_type
54c1bf78 533 typedef _Alloc allocator_type;
54c1bf78
BK
534 typedef typename traits_type::int_type int_type;
535 typedef typename traits_type::pos_type pos_type;
536 typedef typename traits_type::off_type off_type;
537
538 // Non-standard types:
539 typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
540 typedef basic_stringbuf<_CharT, _Traits, _Alloc> __stringbuf_type;
541 typedef basic_ostream<char_type, traits_type> __ostream_type;
542
543 private:
544 __stringbuf_type _M_stringbuf;
545
546 public:
840ceb34
PE
547 // Constructors/destructor:
548 /**
549 * @brief Default constructor starts with an empty string buffer.
93c66bc6 550 * @param __mode Whether the buffer can read, or write, or both.
840ceb34
PE
551 *
552 * @c ios_base::out is automatically included in @a mode.
553 *
554 * Initializes @c sb using @c mode|out, and passes @c &sb to the base
555 * class initializer. Does not allocate any buffer.
556 *
840ceb34
PE
557 * That's a lie. We initialize the base class with NULL, because the
558 * string class does its own memory management.
840ceb34 559 */
798355a2 560 explicit
54c1bf78 561 basic_ostringstream(ios_base::openmode __mode = ios_base::out)
d29cc32f 562 : __ostream_type(), _M_stringbuf(__mode | ios_base::out)
54c1bf78
BK
563 { this->init(&_M_stringbuf); }
564
840ceb34
PE
565 /**
566 * @brief Starts with an existing string buffer.
93c66bc6
BK
567 * @param __str A string to copy as a starting buffer.
568 * @param __mode Whether the buffer can read, or write, or both.
840ceb34
PE
569 *
570 * @c ios_base::out is automatically included in @a mode.
571 *
572 * Initializes @c sb using @a str and @c mode|out, and passes @c &sb
573 * to the base class initializer.
574 *
840ceb34
PE
575 * That's a lie. We initialize the base class with NULL, because the
576 * string class does its own memory management.
840ceb34 577 */
798355a2 578 explicit
54c1bf78
BK
579 basic_ostringstream(const __string_type& __str,
580 ios_base::openmode __mode = ios_base::out)
d29cc32f 581 : __ostream_type(), _M_stringbuf(__str, __mode | ios_base::out)
54c1bf78
BK
582 { this->init(&_M_stringbuf); }
583
840ceb34
PE
584 /**
585 * @brief The destructor does nothing.
586 *
587 * The buffer is deallocated by the stringbuf object, not the
588 * formatting stream.
589 */
54c1bf78
BK
590 ~basic_ostringstream()
591 { }
592
9b817548
JW
593#if __cplusplus >= 201103L
594 basic_ostringstream(const basic_ostringstream&) = delete;
595
596 basic_ostringstream(basic_ostringstream&& __rhs)
597 : __ostream_type(std::move(__rhs)),
598 _M_stringbuf(std::move(__rhs._M_stringbuf))
599 { __ostream_type::set_rdbuf(&_M_stringbuf); }
600
601 // 27.8.3.2 Assign and swap:
602
603 basic_ostringstream&
604 operator=(const basic_ostringstream&) = delete;
605
606 basic_ostringstream&
607 operator=(basic_ostringstream&& __rhs)
608 {
609 __ostream_type::operator=(std::move(__rhs));
610 _M_stringbuf = std::move(__rhs._M_stringbuf);
611 return *this;
612 }
613
614 void
615 swap(basic_ostringstream& __rhs)
616 {
617 __ostream_type::swap(__rhs);
618 _M_stringbuf.swap(__rhs._M_stringbuf);
619 }
620#endif
621
54c1bf78 622 // Members:
840ceb34
PE
623 /**
624 * @brief Accessing the underlying buffer.
625 * @return The current basic_stringbuf buffer.
626 *
627 * This hides both signatures of std::basic_ios::rdbuf().
628 */
798355a2 629 __stringbuf_type*
54c1bf78
BK
630 rdbuf() const
631 { return const_cast<__stringbuf_type*>(&_M_stringbuf); }
632
840ceb34
PE
633 /**
634 * @brief Copying out the string buffer.
635 * @return @c rdbuf()->str()
636 */
54c1bf78
BK
637 __string_type
638 str() const
639 { return _M_stringbuf.str(); }
798355a2 640
840ceb34
PE
641 /**
642 * @brief Setting a new buffer.
93c66bc6 643 * @param __s The string to use as a new sequence.
840ceb34
PE
644 *
645 * Calls @c rdbuf()->str(s).
646 */
798355a2 647 void
54c1bf78
BK
648 str(const __string_type& __s)
649 { _M_stringbuf.str(__s); }
650 };
798355a2
PE
651
652
840ceb34
PE
653 // [27.7.4] Template class basic_stringstream
654 /**
655 * @brief Controlling input and output for std::string.
5b9daa7e 656 * @ingroup io
840ceb34 657 *
d632488a
BK
658 * @tparam _CharT Type of character stream.
659 * @tparam _Traits Traits for character type, defaults to
660 * char_traits<_CharT>.
661 * @tparam _Alloc Allocator type, defaults to allocator<_CharT>.
662 *
840ceb34
PE
663 * This class supports reading from and writing to objects of type
664 * std::basic_string, using the inherited functions from
665 * std::basic_iostream. To control the associated sequence, an instance
666 * of std::basic_stringbuf is used, which this page refers to as @c sb.
667 */
54c1bf78
BK
668 template <typename _CharT, typename _Traits, typename _Alloc>
669 class basic_stringstream : public basic_iostream<_CharT, _Traits>
670 {
671 public:
672 // Types:
673 typedef _CharT char_type;
674 typedef _Traits traits_type;
f5677b15
PC
675 // _GLIBCXX_RESOLVE_LIB_DEFECTS
676 // 251. basic_stringbuf missing allocator_type
54c1bf78 677 typedef _Alloc allocator_type;
54c1bf78
BK
678 typedef typename traits_type::int_type int_type;
679 typedef typename traits_type::pos_type pos_type;
680 typedef typename traits_type::off_type off_type;
681
682 // Non-standard Types:
683 typedef basic_string<_CharT, _Traits, _Alloc> __string_type;
684 typedef basic_stringbuf<_CharT, _Traits, _Alloc> __stringbuf_type;
685 typedef basic_iostream<char_type, traits_type> __iostream_type;
686
687 private:
688 __stringbuf_type _M_stringbuf;
689
690 public:
691 // Constructors/destructors
840ceb34
PE
692 /**
693 * @brief Default constructor starts with an empty string buffer.
93c66bc6 694 * @param __m Whether the buffer can read, or write, or both.
840ceb34 695 *
93c66bc6
BK
696 * Initializes @c sb using the mode from @c __m, and passes @c
697 * &sb to the base class initializer. Does not allocate any
698 * buffer.
840ceb34 699 *
840ceb34
PE
700 * That's a lie. We initialize the base class with NULL, because the
701 * string class does its own memory management.
840ceb34 702 */
798355a2 703 explicit
54c1bf78 704 basic_stringstream(ios_base::openmode __m = ios_base::out | ios_base::in)
d29cc32f 705 : __iostream_type(), _M_stringbuf(__m)
54c1bf78
BK
706 { this->init(&_M_stringbuf); }
707
840ceb34
PE
708 /**
709 * @brief Starts with an existing string buffer.
93c66bc6
BK
710 * @param __str A string to copy as a starting buffer.
711 * @param __m Whether the buffer can read, or write, or both.
840ceb34 712 *
93c66bc6 713 * Initializes @c sb using @a __str and @c __m, and passes @c &sb
840ceb34
PE
714 * to the base class initializer.
715 *
840ceb34
PE
716 * That's a lie. We initialize the base class with NULL, because the
717 * string class does its own memory management.
840ceb34 718 */
798355a2 719 explicit
54c1bf78
BK
720 basic_stringstream(const __string_type& __str,
721 ios_base::openmode __m = ios_base::out | ios_base::in)
d29cc32f 722 : __iostream_type(), _M_stringbuf(__str, __m)
54c1bf78
BK
723 { this->init(&_M_stringbuf); }
724
840ceb34
PE
725 /**
726 * @brief The destructor does nothing.
727 *
728 * The buffer is deallocated by the stringbuf object, not the
729 * formatting stream.
730 */
54c1bf78
BK
731 ~basic_stringstream()
732 { }
733
9b817548
JW
734#if __cplusplus >= 201103L
735 basic_stringstream(const basic_stringstream&) = delete;
736
737 basic_stringstream(basic_stringstream&& __rhs)
738 : __iostream_type(std::move(__rhs)),
739 _M_stringbuf(std::move(__rhs._M_stringbuf))
740 { __iostream_type::set_rdbuf(&_M_stringbuf); }
741
742 // 27.8.3.2 Assign and swap:
743
744 basic_stringstream&
745 operator=(const basic_stringstream&) = delete;
746
747 basic_stringstream&
748 operator=(basic_stringstream&& __rhs)
749 {
750 __iostream_type::operator=(std::move(__rhs));
751 _M_stringbuf = std::move(__rhs._M_stringbuf);
752 return *this;
753 }
754
755 void
756 swap(basic_stringstream& __rhs)
757 {
758 __iostream_type::swap(__rhs);
759 _M_stringbuf.swap(__rhs._M_stringbuf);
760 }
761#endif
762
54c1bf78 763 // Members:
840ceb34
PE
764 /**
765 * @brief Accessing the underlying buffer.
766 * @return The current basic_stringbuf buffer.
767 *
768 * This hides both signatures of std::basic_ios::rdbuf().
769 */
798355a2 770 __stringbuf_type*
54c1bf78
BK
771 rdbuf() const
772 { return const_cast<__stringbuf_type*>(&_M_stringbuf); }
773
840ceb34
PE
774 /**
775 * @brief Copying out the string buffer.
776 * @return @c rdbuf()->str()
777 */
54c1bf78
BK
778 __string_type
779 str() const
780 { return _M_stringbuf.str(); }
781
840ceb34
PE
782 /**
783 * @brief Setting a new buffer.
93c66bc6 784 * @param __s The string to use as a new sequence.
840ceb34
PE
785 *
786 * Calls @c rdbuf()->str(s).
787 */
798355a2 788 void
54c1bf78
BK
789 str(const __string_type& __s)
790 { _M_stringbuf.str(__s); }
791 };
3cbc7af0 792
9b817548
JW
793#if __cplusplus >= 201103L
794 /// Swap specialization for stringbufs.
795 template <class _CharT, class _Traits, class _Allocator>
796 inline void
797 swap(basic_stringbuf<_CharT, _Traits, _Allocator>& __x,
798 basic_stringbuf<_CharT, _Traits, _Allocator>& __y)
799 { __x.swap(__y); }
800
801 /// Swap specialization for istringstreams.
802 template <class _CharT, class _Traits, class _Allocator>
803 inline void
804 swap(basic_istringstream<_CharT, _Traits, _Allocator>& __x,
805 basic_istringstream<_CharT, _Traits, _Allocator>& __y)
806 { __x.swap(__y); }
807
808 /// Swap specialization for ostringstreams.
809 template <class _CharT, class _Traits, class _Allocator>
810 inline void
811 swap(basic_ostringstream<_CharT, _Traits, _Allocator>& __x,
812 basic_ostringstream<_CharT, _Traits, _Allocator>& __y)
813 { __x.swap(__y); }
814
815 /// Swap specialization for stringstreams.
816 template <class _CharT, class _Traits, class _Allocator>
817 inline void
818 swap(basic_stringstream<_CharT, _Traits, _Allocator>& __x,
819 basic_stringstream<_CharT, _Traits, _Allocator>& __y)
820 { __x.swap(__y); }
821#endif
822
34a2b755 823_GLIBCXX_END_NAMESPACE_CXX11
12ffa228
BK
824_GLIBCXX_END_NAMESPACE_VERSION
825} // namespace
54c1bf78 826
ee3ee948 827#include <bits/sstream.tcc>
54c1bf78 828
1143680e 829#endif /* _GLIBCXX_SSTREAM */