Main Page | Modules | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages | Search for 

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

Controlling input for std::string. More...

Inheritance diagram for std::basic_istringstream< _CharT, _Traits, _Alloc >:

std::basic_istream< _CharT, _Traits > std::basic_ios< _CharT, _Traits > std::ios_base List of all members.

Public Types

typedef _CharT char_type
typedef _Traits traits_type
typedef _Alloc allocator_type
typedef traits_type::int_type int_type
typedef traits_type::pos_type pos_type
typedef traits_type::off_type off_type
typedef basic_string< _CharT,
_Traits, _Alloc > 		__string_type
typedef basic_stringbuf< _CharT,
_Traits, _Alloc > 		__stringbuf_type
typedef basic_istream< char_type,
traits_type > 		__istream_type

Public Member Functions

 basic_istringstream (ios_base::openmode __mode=ios_base::in)
 Default constructor starts with an empty string buffer.

 basic_istringstream (const __string_type &__str, ios_base::openmode __mode=ios_base::in)
 Starts with an existing string buffer.

 ~basic_istringstream ()
 The destructor does nothing.

__stringbuf_type * rdbuf () const
 Accessing the underlying buffer.

__string_type str () const
 Copying out the string buffer.

void str (const __string_type &__s)
 Setting a new buffer.


Private Attributes

__stringbuf_type _M_stringbuf

Detailed Description

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

Controlling input for std::string.

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

Definition at line 311 of file sstream.

Member Typedef Documentation

template<typename _CharT, typename _Traits, typename _Alloc>
typedef basic_istream<char_type, traits_type> std::basic_istringstream< _CharT, _Traits, _Alloc >::__istream_type
 

Reimplemented from std::basic_istream< _CharT, _Traits >.

Definition at line 327 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef basic_string<_CharT, _Traits, _Alloc> std::basic_istringstream< _CharT, _Traits, _Alloc >::__string_type
 

Definition at line 325 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef basic_stringbuf<_CharT, _Traits, _Alloc> std::basic_istringstream< _CharT, _Traits, _Alloc >::__stringbuf_type
 

Definition at line 326 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef _Alloc std::basic_istringstream< _CharT, _Traits, _Alloc >::allocator_type
 

Definition at line 319 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef _CharT std::basic_istringstream< _CharT, _Traits, _Alloc >::char_type
 

These are standard types. They permit a standardized way of referring to names of (or names dependant on) the template parameters, which are specific to the implementation.

Reimplemented from std::basic_istream< _CharT, _Traits >.

Definition at line 315 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef traits_type::int_type std::basic_istringstream< _CharT, _Traits, _Alloc >::int_type
 

Reimplemented from std::basic_istream< _CharT, _Traits >.

Definition at line 320 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef traits_type::off_type std::basic_istringstream< _CharT, _Traits, _Alloc >::off_type
 

Reimplemented from std::basic_istream< _CharT, _Traits >.

Definition at line 322 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef traits_type::pos_type std::basic_istringstream< _CharT, _Traits, _Alloc >::pos_type
 

Reimplemented from std::basic_istream< _CharT, _Traits >.

Definition at line 321 of file sstream.

template<typename _CharT, typename _Traits, typename _Alloc>
typedef _Traits std::basic_istringstream< _CharT, _Traits, _Alloc >::traits_type
 

Reimplemented from std::basic_istream< _CharT, _Traits >.

Definition at line 316 of file sstream.

Constructor & Destructor Documentation

template<typename _CharT, typename _Traits, typename _Alloc>
std::basic_istringstream< _CharT, _Traits, _Alloc >::basic_istringstream (  ios_base::openmode  __mode = ios_base::in  )  [inline, explicit]
 

Default constructor starts with an empty string buffer.

Parameters:
mode Whether the buffer can read, or write, or both.
ios_base::in is automatically included in mode.

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

Definition at line 354 of file sstream.

References std::basic_istringstream< _CharT, _Traits, _Alloc >::_M_stringbuf, std::basic_ios< _CharT, _Traits >::init(), and std::ios_base::openmode.

template<typename _CharT, typename _Traits, typename _Alloc>
std::basic_istringstream< _CharT, _Traits, _Alloc >::basic_istringstream (  const __string_type &  __str,
ios_base::openmode  __mode = ios_base::in
)  [inline, explicit]
 

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::in is automatically included in mode.

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

Definition at line 374 of file sstream.

References std::basic_istringstream< _CharT, _Traits, _Alloc >::_M_stringbuf, std::basic_ios< _CharT, _Traits >::init(), and std::ios_base::openmode.

template<typename _CharT, typename _Traits, typename _Alloc>
std::basic_istringstream< _CharT, _Traits, _Alloc >::~basic_istringstream (   )  [inline]
 

The destructor does nothing.

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

Definition at line 385 of file sstream.

Member Function Documentation

template<typename _CharT, typename _Traits, typename _Alloc>
__stringbuf_type* std::basic_istringstream< _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().

Reimplemented from std::basic_ios< _CharT, _Traits >.

Definition at line 396 of file sstream.

References std::basic_istringstream< _CharT, _Traits, _Alloc >::_M_stringbuf.

template<typename _CharT, typename _Traits, typename _Alloc>
void std::basic_istringstream< _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 414 of file sstream.

References std::basic_istringstream< _CharT, _Traits, _Alloc >::_M_stringbuf, and std::basic_stringbuf< _CharT, _Traits, _Alloc >::str().

template<typename _CharT, typename _Traits, typename _Alloc>
__string_type std::basic_istringstream< _CharT, _Traits, _Alloc >::str (   )  const [inline]
 

Copying out the string buffer.

Returns:
rdbuf()->str()

Definition at line 404 of file sstream.

References std::basic_istringstream< _CharT, _Traits, _Alloc >::_M_stringbuf, and std::basic_stringbuf< _CharT, _Traits, _Alloc >::str().

Member Data Documentation

template<typename _CharT, typename _Traits, typename _Alloc>
__stringbuf_type std::basic_istringstream< _CharT, _Traits, _Alloc >::_M_stringbuf [private]
 

Definition at line 335 of file sstream.

Referenced by std::basic_istringstream< _CharT, _Traits, _Alloc >::basic_istringstream(), std::basic_istringstream< _CharT, _Traits, _Alloc >::rdbuf(), and std::basic_istringstream< _CharT, _Traits, _Alloc >::str().

The documentation for this class was generated from the following file:
Generated on Tue Jan 30 17:32:18 2007 for GNU C++ STL by doxygen 1.3.6