1 // Backward-compat support -*- C++ -*-
3 // Copyright (C) 2001-2024 Free Software Foundation, Inc.
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
8 // Free Software Foundation; either version 3, or (at your option)
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.
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.
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/>.
27 * Silicon Graphics Computer Systems, Inc.
29 * Permission to use, copy, modify, distribute and sell this software
30 * and its documentation for any purpose is hereby granted without fee,
31 * provided that the above copyright notice appear in all copies and
32 * that both that copyright notice and this permission notice appear
33 * in supporting documentation. Silicon Graphics makes no
34 * representations about the suitability of this software for any
35 * purpose. It is provided "as is" without express or implied warranty.
38 // WARNING: The classes defined in this header are DEPRECATED. This
39 // header is defined in section D.7.1 of the C++ standard, and it
40 // MAY BE REMOVED in a future standard revision. One should use the
41 // header <sstream> instead.
44 * This is a Standard C++ Library header.
47 #ifndef _BACKWARD_STRSTREAM
48 #define _BACKWARD_STRSTREAM
50 #include <backward/backward_warning.h>
56 namespace std _GLIBCXX_VISIBILITY(default)
58 _GLIBCXX_BEGIN_NAMESPACE_VERSION
60 #if __glibcxx_spanstream
61 # define _GLIBCXX_STRSTREAM_DEPR(A, B) _GLIBCXX_DEPRECATED_SUGGEST(A "' or '" B)
63 # define _GLIBCXX_STRSTREAM_DEPR(A, B) _GLIBCXX_DEPRECATED_SUGGEST(A)
66 // Class strstreambuf, a streambuf class that manages an array of char.
67 // Note that this class is not a template.
68 class strstreambuf : public basic_streambuf<char, char_traits<char> >
72 typedef char_traits<char> _Traits;
73 typedef basic_streambuf<char, _Traits> _Base;
76 // Constructor, destructor
77 #if __cplusplus >= 201103L
78 strstreambuf() : strstreambuf(0) { }
79 explicit strstreambuf(streamsize __initial_capacity);
81 explicit strstreambuf(streamsize __initial_capacity = 0);
83 strstreambuf(void* (*__alloc)(size_t), void (*__free)(void*));
85 strstreambuf(char* __get, streamsize __n, char* __put = 0) throw ();
86 strstreambuf(signed char* __get, streamsize __n, signed char* __put = 0) throw ();
87 strstreambuf(unsigned char* __get, streamsize __n, unsigned char* __put=0) throw ();
89 strstreambuf(const char* __get, streamsize __n) throw ();
90 strstreambuf(const signed char* __get, streamsize __n) throw ();
91 strstreambuf(const unsigned char* __get, streamsize __n) throw ();
93 virtual ~strstreambuf();
95 #if __cplusplus >= 201103L
96 strstreambuf(strstreambuf&& __rhs) noexcept
97 : _Base(__rhs), _M_alloc_fun(__rhs._M_alloc_fun),
98 _M_free_fun(__rhs._M_free_fun), _M_dynamic(__rhs._M_dynamic),
99 _M_frozen(__rhs._M_frozen), _M_constant(__rhs._M_constant)
101 __rhs.setg(nullptr, nullptr, nullptr);
102 __rhs.setp(nullptr, nullptr);
106 operator=(strstreambuf&& __rhs) noexcept
108 if (_M_dynamic && !_M_frozen)
110 _Base::operator=(static_cast<const _Base&>(__rhs));
111 _M_alloc_fun = __rhs._M_alloc_fun;
112 _M_free_fun = __rhs._M_free_fun;
113 _M_dynamic = __rhs._M_dynamic;
114 _M_frozen = __rhs._M_frozen;
115 _M_constant = __rhs._M_constant;
116 __rhs.setg(nullptr, nullptr, nullptr);
117 __rhs.setp(nullptr, nullptr);
123 void freeze(bool = true) throw ();
124 char* str() throw ();
125 _GLIBCXX_PURE int pcount() const throw ();
128 virtual int_type overflow(int_type __c = _Traits::eof());
129 virtual int_type pbackfail(int_type __c = _Traits::eof());
130 virtual int_type underflow();
131 virtual _Base* setbuf(char* __buf, streamsize __n);
132 virtual pos_type seekoff(off_type __off, ios_base::seekdir __dir,
133 ios_base::openmode __mode
134 = ios_base::in | ios_base::out);
135 virtual pos_type seekpos(pos_type __pos, ios_base::openmode __mode
136 = ios_base::in | ios_base::out);
139 #if __cplusplus < 201103L
141 operator=(const strstreambuf&);
143 strstreambuf(const strstreambuf&);
146 // Dynamic allocation, possibly using _M_alloc_fun and _M_free_fun.
147 char* _M_alloc(size_t);
150 // Helper function used in constructors.
151 void _M_setup(char* __get, char* __put, streamsize __n) throw ();
154 void* (*_M_alloc_fun)(size_t);
155 void (*_M_free_fun)(void*);
159 bool _M_constant : 1;
160 } _GLIBCXX_STRSTREAM_DEPR("std::stringbuf", "std::spanbuf");
162 #pragma GCC diagnostic push
163 #pragma GCC diagnostic ignored "-Wdeprecated-declarations"
165 // Class istrstream, an istream that manages a strstreambuf.
166 class istrstream : public basic_istream<char>
169 explicit istrstream(char*);
170 explicit istrstream(const char*);
171 istrstream(char* , streamsize);
172 istrstream(const char*, streamsize);
173 virtual ~istrstream();
175 #if __cplusplus >= 201103L
176 istrstream(istrstream&& __rhs)
177 : istream(std::move(__rhs)), _M_buf(std::move(__rhs._M_buf))
178 { set_rdbuf(&_M_buf); }
180 istrstream& operator=(istrstream&&) = default;
183 _GLIBCXX_CONST strstreambuf* rdbuf() const throw ();
184 char* str() throw ();
188 } _GLIBCXX_STRSTREAM_DEPR("std::istringstream", "std::ispanstream");
191 class ostrstream : public basic_ostream<char>
195 ostrstream(char*, int, ios_base::openmode = ios_base::out);
196 virtual ~ostrstream();
198 #if __cplusplus >= 201103L
199 ostrstream(ostrstream&& __rhs)
200 : ostream(std::move(__rhs)), _M_buf(std::move(__rhs._M_buf))
201 { set_rdbuf(&_M_buf); }
203 ostrstream& operator=(ostrstream&&) = default;
206 _GLIBCXX_CONST strstreambuf* rdbuf() const throw ();
207 void freeze(bool = true) throw();
208 char* str() throw ();
209 _GLIBCXX_PURE int pcount() const throw ();
213 } _GLIBCXX_STRSTREAM_DEPR("std::ostringstream", "std::ospanstream");
216 class strstream : public basic_iostream<char>
219 typedef char char_type;
220 typedef char_traits<char>::int_type int_type;
221 typedef char_traits<char>::pos_type pos_type;
222 typedef char_traits<char>::off_type off_type;
225 strstream(char*, int, ios_base::openmode = ios_base::in | ios_base::out);
226 virtual ~strstream();
228 #if __cplusplus >= 201103L
229 strstream(strstream&& __rhs)
230 : iostream(std::move(__rhs)), _M_buf(std::move(__rhs._M_buf))
231 { set_rdbuf(&_M_buf); }
233 strstream& operator=(strstream&&) = default;
236 _GLIBCXX_CONST strstreambuf* rdbuf() const throw ();
237 void freeze(bool = true) throw ();
238 _GLIBCXX_PURE int pcount() const throw ();
239 char* str() throw ();
243 } _GLIBCXX_STRSTREAM_DEPR("std::stringstream", "std::spanstream");
245 #undef _GLIBCXX_STRSTREAM_DEPR
246 #pragma GCC diagnostic pop
248 _GLIBCXX_END_NAMESPACE_VERSION