Partilhar via


basic_stringstream Classe

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

Sintaxe

template <class Elem, class Tr = char_traits<Elem>, class Alloc = allocator<Elem>>
class basic_stringstream : public basic_iostream<Elem, Tr>

Parâmetros

Alloc
A classe alocator.

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

Tr
Os traços de caráter especializaram-se no elemento básico da cadeia de caracteres.

Observações

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

Construtores

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

Typedefs (definições de tipos)

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.

Requerimentos

Cabeçalho:<Sstream>

Espaço de nomes: std

basic_stringstream::allocator_type

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

typedef Alloc allocator_type;

basic_stringstream::basic_stringstream

Constrói um objeto do tipo basic_stringstream.

explicit basic_stringstream(ios_base::openmode _Mode = ios_base::in | ios_base::out);

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

Parâmetros

_Mode
Uma das enumerações em ios_base::openmode.

STR
Um objeto do tipo basic_string.

Observações

O primeiro construtor inicializa a classe base chamando basic_iostream( sb), onde sb é o objeto armazenado da classe basic_stringbuf<Elem, Tr, Alloc>. Ele também inicializa sb chamando basic_stringbuf<Elem, Tr, Alloc>(_Mode).

O segundo construtor inicializa a classe base chamando basic_iostream( sb). Ele também inicializa sb chamando basic_stringbuf<Elem, Tr, Alloc>(_ Str, _Mode).

basic_stringstream::rdbuf

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

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

Valor de retorno

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

Exemplo

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

basic_stringstream::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 de retorno

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

Observações

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

Exemplo

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

Ver também

segurança de threads na biblioteca padrão C++
Programação iostream
iostreams Convenções