Classe basic_ostringstream

Descreve um objeto que controla a inserção de elementos e objetos codificados em um buffer de fluxo da classe basic_stringbuf<Elem, Tr, Alloc>.

Sintaxe

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

Parâmetros

Alloc
A classe do alocador.

Elem
O tipo do elemento básico da cadeia de caracteres.

Tr
As características de caractere especializadas no elemento básico da cadeia de caracteres.

Comentários

A classe descreve um objeto que controla a inserção de elementos e objetos codificados em um buffer de fluxo, com elementos do tipo Elem, cujos traços de caractere são determinados pela classe Tre cujos elementos são alocados por um alocador de classe Alloc. O objeto armazena um objeto da classe basic_stringbuf<Elem, Tr, Alloc>.

Construtores

Construtor Descrição
basic_ostringstream Constrói um objeto do tipo basic_ostringstream.

Typedefs

Nome do tipo Descrição
allocator_type O tipo é um sinônimo para o parâmetro de modelo Alloc.

Funções de membro

Função de membro Descrição
rdbuf Retorna o endereço do buffer de fluxo armazenado do tipo pointer para basic_stringbuf<Elem, Tr. Alloc>
str Define ou obtém o texto em um buffer de cadeia de caracteres sem alterar a posição de gravação.

Requisitos

Cabeçalho:< sstream>

Namespace: std

basic_ostringstream::allocator_type

O tipo é um sinônimo para o parâmetro de modelo Alloc.

typedef Alloc allocator_type;

basic_ostringstream::basic_ostringstream

Constrói um objeto do 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
Uma das enumerações em ios_base::openmode.

str
Um objeto do tipo basic_string.

Comentários

O primeiro construtor inicializa a classe base chamando basic_ostream( sb ), onde sb está o objeto armazenado da classe basic_stringbuf< Elem, Tr, Alloc>. Ele também inicializa sb chamando basic_stringbuf< Elem, Tr, Alloc>( _Mode | ios_base::out ). Para obter mais informações, consulte basic_ostream e basic_stringbuf.

O segundo construtor inicializa a classe base chamando basic_ostream( sb ). Ele também inicializa sb chamando basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::out ).

basic_ostringstream::rdbuf

Retorna o endereço do buffer de fluxo armazenado do tipo pointer para basic_stringbuf<Elem, Tr, Alloc>.

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

Valor Retornado

O endereço do buffer de fluxo armazenado, do tipo pointer para basic_stringbuf<Elem, Tr, Alloc>.

Comentários

A função membro retorna o endereço do buffer de fluxo armazenado do tipo pointer para basic_stringbuf<Elem, Tr, Alloc>.

Exemplo

Consulte basic_filebuf::close para ver um exemplo que usa rdbuf.

basic_ostringstream::str

Define ou obtém o texto em um buffer de cadeia de caracteres sem alterar a posição de gravação.

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

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

Parâmetros

_Newstr
A nova cadeia de caracteres.

Valor Retornado

Retorna um objeto da classe basic_string<Elem, Tr, Alloc>cuja sequência controlada é uma cópia da sequência controlada por *this.

Comentários

A primeira função membro retorna rdbuf ->str. A segunda função membro chama rdbuf ->str( _Newstr).

Exemplo

Consulte basic_stringbuf::str para obter um exemplo que usa str.

Confira também

Segurança de thread na Biblioteca Padrão do C++
Programação iostream
Convenções de iostreams