Classe basic_istringstream

Descreve um objeto que controla a extração de elementos e objetos codificados de 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_istringstream : public basic_istream<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

O modelo de classe descreve um objeto que controla a extração de elementos e objetos codificados de um buffer de fluxo da classe basic_stringbuf<Elem, Tr, Alloc>, com elementos do tipo Elem, cujas características de caractere são determinadas pela classe Tr e 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_istringstream	Constrói um objeto do tipo basic_istringstream.

Typedefs

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

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.
troca	Troca os valores nesse objeto basic_istringstream pelos do objeto fornecido.

Operadores

Operador	Descrição
operator=	Atribui os valores a esse objeto basic_istringstream do parâmetro de objeto.

Requisitos

Cabeçalho:<sstream>

Namespace: std

basic_istringstream::allocator_type

O tipo é um sinônimo do parâmetro de modeloAlloc.

typedef Alloc allocator_type;

basic_istringstream::basic_istringstream

Constrói um objeto do tipo basic_istringstream.

explicit basic_istringstream(
    ios_base::openmode _Mode = ios_base::in);

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

basic_istringstream(
    basic_istringstream&& right);

Parâmetros

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

str
Um objeto do tipo basic_string.

direita
Uma referência rvalue de um objeto basic_istringstream.

Comentários

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

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

O terceiro construtor inicializa o objeto com o conteúdo de right tratado como uma referência rvalue.

basic_istringstream::operator=

Atribui os valores a esse objeto basic_istringstream do parâmetro de objeto.

basic_istringstream& operator=(basic_istringstream&& right);

Parâmetros

direita
Uma referência rvalue a um objeto basic_istringstream.

Comentários

O operador de membro substitui o conteúdo do objeto pelo conteúdo de right tratado como uma atribuição de movimentação de referência rvalue.

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

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_istringstream::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.

Comentários

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

Exemplo

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

basic_istringstream::swap

Troca os valores de dois objetos basic_istringstream.

void swap(basic_istringstream& right);

Parâmetros

direita
Uma referência lvalue a um objeto basic_istringstream.

Comentários

A função membro troca os valores desse objeto e os valores de right.

Confira também

Acesso Thread-Safe na Biblioteca Padrão C++
Programação de iostream
Convenções de iostreams