std::basic_ostringstream< _CharT, _Traits, _Alloc > Class Template Reference

Public Types
typedef basic_ostream< char_type, traits_type >	__ostream_type
typedef basic_string< _CharT, _Traits, _Alloc >	__string_type
typedef basic_stringbuf< _CharT, _Traits, _Alloc >	__stringbuf_type
typedef _Alloc	allocator_type
typedef _CharT	char_type
typedef traits_type::int_type	int_type
typedef traits_type::off_type	off_type
typedef traits_type::pos_type	pos_type
typedef _Traits	traits_type

Public Member Functions
	basic_ostringstream ()
	basic_ostringstream (basic_ostringstream &&__rhs)
	basic_ostringstream (const __string_type &__str, ios_base::openmode __mode=ios_base::out)
	basic_ostringstream (const basic_ostringstream &)=delete
	basic_ostringstream (ios_base::openmode __mode)
	~basic_ostringstream ()
basic_ostringstream &	operator= (basic_ostringstream &&__rhs)
basic_ostringstream &	operator= (const basic_ostringstream &)=delete
__stringbuf_type *	rdbuf () const
__string_type	str () const
void	str (const __string_type &__s)
void	swap (basic_ostringstream &__rhs)
basic_string_view< char_type, traits_type >	view () const noexcept

Detailed Description

template<typename _CharT, typename _Traits, typename _Alloc>
class std::basic_ostringstream< _CharT, _Traits, _Alloc >

Controlling output for std::string.

Template Parameters

_CharT	Type of character stream.
_Traits	Traits for character type, defaults to char_traits<_CharT>.
_Alloc	Allocator type, defaults to allocator<_CharT>.

This class supports writing to objects of type std::basic_string, using the inherited functions from std::basic_ostream. To control the associated sequence, an instance of std::basic_stringbuf is used, which this page refers to as sb.

Definition at line 108 of file iosfwd.

Constructor & Destructor Documentation

basic_ostringstream() [1/3]

template<typename _CharT , typename _Traits , typename _Alloc >

std::basic_ostringstream< _CharT, _Traits, _Alloc >::basic_ostringstream ( )

inline

Default constructor starts with an empty string buffer.

Initializes sb using mode|out, and passes &sb to the base class initializer. Does not allocate any buffer.

That's a lie. We initialize the base class with NULL, because the string class does its own memory management.

Definition at line 907 of file sstream.

References std::__addressof().

basic_ostringstream() [2/3]

template<typename _CharT , typename _Traits , typename _Alloc >

std::basic_ostringstream< _CharT, _Traits, _Alloc >::basic_ostringstream ( ios_base::openmode  __mode )

inlineexplicit

Starts with an empty string buffer.

Parameters

__mode

Whether the buffer can read, or write, or both.

ios_base::out is automatically included in mode.

Initializes sb using mode|out, and passes &sb to the base class initializer. Does not allocate any buffer.

That's a lie. We initialize the base class with NULL, because the string class does its own memory management.

Definition at line 924 of file sstream.

References std::__addressof().

basic_ostringstream() [3/3]

template<typename _CharT , typename _Traits , typename _Alloc >

std::basic_ostringstream< _CharT, _Traits, _Alloc >::basic_ostringstream ( const __string_type &  __str, ios_base::openmode  __mode = ios_base::out  )

inlineexplicit

Starts with an existing string buffer.

Parameters

__str	A string to copy as a starting buffer.
__mode	Whether the buffer can read, or write, or both.

ios_base::out is automatically included in mode.

Initializes sb using str and mode|out, and passes &sb to the base class initializer.

That's a lie. We initialize the base class with NULL, because the string class does its own memory management.

Definition at line 942 of file sstream.

References std::__addressof().

~basic_ostringstream()

template<typename _CharT , typename _Traits , typename _Alloc >

std::basic_ostringstream< _CharT, _Traits, _Alloc >::~basic_ostringstream ( )

inline

The destructor does nothing.

The buffer is deallocated by the stringbuf object, not the formatting stream.

Definition at line 953 of file sstream.

Member Function Documentation

rdbuf()

template<typename _CharT , typename _Traits , typename _Alloc >

__stringbuf_type* std::basic_ostringstream< _CharT, _Traits, _Alloc >::rdbuf ( ) const

inline

Accessing the underlying buffer.

Returns

The current basic_stringbuf buffer.

This hides both signatures of std::basic_ios::rdbuf().

Definition at line 1053 of file sstream.

References std::__addressof().

str() [1/2]

template<typename _CharT , typename _Traits , typename _Alloc >

__string_type std::basic_ostringstream< _CharT, _Traits, _Alloc >::str ( ) const

inline

Copying out the string buffer.

Returns

rdbuf()->str()

Definition at line 1062 of file sstream.

Referenced by std::__detail::operator<<(), and std::operator<<().

str() [2/2]

template<typename _CharT , typename _Traits , typename _Alloc >

void std::basic_ostringstream< _CharT, _Traits, _Alloc >::str ( const __string_type &  __s )

inline

Setting a new buffer.

Parameters

__s	The string to use as a new sequence.

Calls rdbuf()->str(s).

Definition at line 1095 of file sstream.

---

The documentation for this class was generated from the following files:

• iosfwd
• sstream