| I/O manipulators | ||||
| Print functions(C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
(C++23) | ||||
strstreambuf (C++98/26*) | ||||
(C++20) | ||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
| Synchronized Output | ||||
(C++20) | ||||
| Types | ||||
| Error category interface | ||||
(C++11) | ||||
(C++11) |
Defined in header <strstream> | ||
class strstreambuf:publicstd::basic_streambuf<char> | (deprecated in C++98) (removed in C++26) | |
std::strstreambuf is astd::basic_streambuf whose associated character sequence is a character array, which may be constant (e.g. a string literal), modifiable but not dynamic (e.g. a stack-allocated array), or dynamic, in which case thestd::strstreambuf may be allowed to reallocate the array as necessary to accommodate output (e.g. by callingdelete[] andnew[] or user-provided functions).
Typical implementation of astd::strstreambuf holds four private data members:
Contents |
After any call tostr() on a stream with a dynamic buffer, a call tofreeze(false) is required to allow thestrstreambuf destructor to deallocate the buffer when necessary.
strstreambuf has been deprecated since C++98 and removed since C++26. The recommended replacement isstd::spanbuf(since C++23).
Public member functions | |
constructs astrstreambuf object(public member function)[edit] | |
[virtual] | destructs astrstreambuf object, optionally deallocating the character array(virtual public member function)[edit] |
| sets/clears the frozen state of the buffer (public member function)[edit] | |
| marks the buffer frozen and returns the beginning pointer of the input sequence (public member function)[edit] | |
| returns the next pointer minus the beginning pointer in the output sequence: the number of characters written (public member function)[edit] | |
Protected member functions | |
[virtual] | reads a character from the input sequence without advancing the next pointer (virtual protected member function)[edit] |
[virtual] | backs out the input sequence to unget a character (virtual protected member function)[edit] |
[virtual] | appends a character to the output sequence, may reallocate or initially allocate the buffer if dynamic and not frozen (virtual protected member function)[edit] |
[virtual] | attempts to replace the controlled character sequence with an array (virtual protected member function)[edit] |
[virtual] | repositions the next pointer in the input sequence, output sequence, or both, using relative addressing (virtual protected member function)[edit] |
[virtual] | repositions the next pointer in the input sequence, output sequence, or both using absolute addressing (virtual protected member function)[edit] |
| Member type | Definition |
char_type | CharT[edit] |
traits_type | Traits; the program is ill-formed ifTraits::char_type is notCharT.[edit] |
int_type | Traits::int_type[edit] |
pos_type | Traits::pos_type[edit] |
off_type | Traits::off_type[edit] |
[virtual] | destructs thebasic_streambuf object(virtual public member function of std::basic_streambuf<CharT,Traits>)[edit] |
Locales | |
| changes the associated locale and invokesimbue() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| obtains a copy of the associated locale (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
Positioning | |
| invokessetbuf() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| invokesseekoff() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| invokesseekpos() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| invokessync() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
Get area | |
| obtains the number of characters immediately available in the get area (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| advances the input sequence, then reads one character without advancing again (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
(removed in C++17) | reads one character from the input sequence and advances the sequence (public member function of std::basic_streambuf<CharT,Traits>)[edit] |
| reads one character from the input sequence without advancing the sequence (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| invokesxsgetn() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
Put area | |
| writes one character to the put area and advances the next pointer (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| invokesxsputn() (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
Putback | |
| puts one character back in the input sequence (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
| moves the next pointer in the input sequence back by one (public member function of std::basic_streambuf<CharT,Traits>)[edit] | |
constructs abasic_streambuf object(protected member function)[edit] | |
(C++11) | replaces abasic_streambuf object(protected member function)[edit] |
(C++11) | swaps twobasic_streambuf objects(protected member function)[edit] |
Locales | |
[virtual] | reacts to a change of the associated locale (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
Positioning | |
[virtual] | replaces the buffer with user-defined array, if permitted (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | repositions the next pointer in the input sequence, output sequence, or both, using relative addressing (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | repositions the next pointer in the input sequence, output sequence, or both using absolute addressing (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | synchronizes the buffers with the associated character sequence (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
Get area | |
[virtual] | obtains the number of characters available for input in the associated input sequence, if known (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | reads characters from the associated input sequence to the get area (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | reads characters from the associated input sequence to the get area and advances the next pointer (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | reads multiple characters from the input sequence (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
| returns a pointer to the beginning, current character and the end of the get area (protected member function)[edit] | |
| advances the next pointer in the input sequence (protected member function)[edit] | |
| repositions the beginning, next, and end pointers of the input sequence (protected member function)[edit] | |
Put area | |
[virtual] | writes multiple characters to the output sequence (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
[virtual] | writes characters to the associated output sequence from the put area (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
| returns a pointer to the beginning, current character and the end of the put area (protected member function)[edit] | |
| advances the next pointer of the output sequence (protected member function)[edit] | |
| repositions the beginning, next, and end pointers of the output sequence (protected member function)[edit] | |
Putback | |
[virtual] | puts a character back into the input sequence, possibly modifying the input sequence (virtual protected member function of std::basic_streambuf<CharT,Traits>)[edit] |
