basic_ostringstream (Clase)

Describe un objeto que controla la inserción de elementos y objetos codificados en un búfer de flujo basic_stringbuf<Elem, Tr, Alloc>.

Sintaxis

template <class Elem, class Tr = char_traits<Elem>, class Alloc = allocator<Elem>>
class basic_ostringstream : public basic_ostream<Elem, Tr>

Parámetros

Alloc
Clase de asignador.

Elem
Tipo de elemento básico de la cadena.

Tr
Rasgos de caracteres especializados en el elemento básico de la cadena.

Comentarios

La clase describe un objeto que controla la inserción de elementos y objetos codificados en un búfer de flujo con elementos de tipoElem, cuyos rasgos de caracteres están determinados por la clase Tr y cuyos elementos están asignados por un asignador de clase Alloc. El objeto almacena un objeto de clase basic_stringbuf<Elem, Tr, Alloc>.

Constructores

Constructor	Descripción
basic_ostringstream	Construye un objeto de tipo basic_ostringstream.

Typedefs

Nombre de tipo	Descripción
allocator_type	El tipo es un sinónimo del parámetro de plantilla Alloc.

Funciones miembro

Función de miembro	Descripción
rdbuf	Devuelve la dirección del búfer de flujo almacenado de tipo pointer a basic_stringbuf<Elem, Tr, Alloc>.
str	Establece u obtiene el texto en un búfer de cadena sin cambiar la posición de escritura.

Requisitos

Encabezado:<sstream>

Espacio de nombres: std

basic_ostringstream::allocator_type

El tipo es un sinónimo del parámetro de plantilla Alloc.

typedef Alloc allocator_type;

basic_ostringstream::basic_ostringstream

Construye un objeto de tipo basic_ostringstream.

explicit basic_ostringstream(ios_base::openmode _Mode = ios_base::out);

explicit basic_ostringstream(const basic_string<Elem, Tr, Alloc>& str, ios_base::openmode _Mode = ios_base::out);

Parámetros

_Mode
Una de las enumeraciones de ios_base::openmode.

str
Objeto de tipo basic_string.

Comentarios

El primer constructor inicializa la clase base al llamar a basic_ostream( sb ), donde sb es el objeto almacenado de clase basic_stringbuf< Elem, Tr, Alloc>. También inicializa sb al llamar a basic_stringbuf< Elem, Tr, Alloc>( _Mode | ios_base::out ). Para obtener más información, vea basic_ostream y basic_stringbuf.

El segundo constructor inicializa la clase base al llamar a basic_ostream( sb ). También inicializa sb al llamar a basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::out ).

basic_ostringstream::rdbuf

Devuelve la dirección del búfer de flujo almacenado de tipo pointer a basic_stringbuf<Elem, Tr, Alloc>.

basic_stringbuf<Elem, Tr, Alloc> *rdbuf() const;

Valor devuelto

La dirección del búfer de flujo almacenado de tipo pointer a basic_stringbuf<Elem, Tr, Alloc>.

Comentarios

La función miembro devuelve la dirección del búfer de flujo almacenado de tipo pointer a basic_stringbuf<Elem, Tr, Alloc>.

Ejemplo

Vea basic_filebuf::close para obtener un ejemplo que usa rdbuf.

basic_ostringstream::str

Establece u obtiene el texto en un búfer de cadena sin cambiar la posición de escritura.

basic_string<Elem, Tr, Alloc> str() const;

void str(
    const basic_string<Elem, Tr, Alloc>& _Newstr);

Parámetros

_Newstr
La nueva cadena.

Valor devuelto

Devuelve un objeto de clase basic_string<Elem, Tr, Alloc>, cuya secuencia controlada es una copia de la secuencia que *this controla.

Comentarios

La primera función miembro devuelve rdbuf ->str. La segunda función miembro llama a rdbuf ->str( _Newstr).

Ejemplo

Vea basic_stringbuf::str para obtener un ejemplo en el que se usa str.

Consulte también

Seguridad para subprocesos en la biblioteca estándar de C++
Programación con iostream
Convenciones de iostreams