Partilhar via


strstream Classe

Descreve um objeto que controla a inserção e extração de elementos e objetos codificados usando um buffer de fluxo da classe strstreambuf.

Sintaxe

class strstream : public iostream

Observações

O objeto armazena um objeto de classe strstreambuf.

Observação

Esta classe foi preterida. Em vez disso, considere usar stringstream ou wstringstream .

Construtores

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

Funções de membro

Função de membro Descrição
congelar Faz com que um buffer de fluxo fique indisponível por meio de operações de buffer de fluxo.
Pcount Devolve uma contagem do número de elementos gravados na sequência controlada.
RDBUF Retorna um ponteiro para o objeto associado strstreambuf do fluxo.
STR As chamadas congelam e, em seguida, devolve um ponteiro para o início da sequência controlada.

Requerimentos

Cabeçalho:<Strstream>

Espaço de nomes: std

strstream::congelar

Faz com que um buffer de fluxo fique indisponível por meio de operações de buffer de fluxo.

void freeze(bool _Freezeit = true);

Parâmetros

_Freezeit
A bool indicando se você deseja que o fluxo seja congelado.

Observações

A função de membro chama rdbuf ->freeze(_ Freezeit).

Exemplo

Consulte strstreambuf::freeze para obter um exemplo que usa freeze.

strstream:contagem :p

Devolve uma contagem do número de elementos gravados na sequência controlada.

streamsize pcount() const;

Valor de retorno

O número de elementos gravados na sequência controlada.

Observações

A função member retorna rdbuf ->pcount.

Exemplo

Consulte strstreambuf::p count para obter uma amostra do uso de pcount.

strstream::rdbuf

Retorna um ponteiro para o objeto strstreambuf associado ao fluxo.

strstreambuf *rdbuf() const

Valor de retorno

Um ponteiro para o objeto strstreambuf associado ao fluxo.

Observações

A função member retorna o endereço do buffer de fluxo armazenado do tipo pointer para strstreambuf.

Exemplo

Consulte strstreambuf::p count para obter um exemplo que usa rdbuf.

strstream::str

As chamadas congelam e, em seguida, devolve um ponteiro para o início da sequência controlada.

char *str();

Valor de retorno

Um ponteiro para o início da sequência controlada.

Observações

A função de membro retorna rdbuf ->str.

Exemplo

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

strstream::strstream

Constrói um objeto do tipo strstream.

strstream();

strstream(char* ptr,
    streamsize count,
    ios_base::openmode _Mode = ios_base::in | ios_base::out);

Parâmetros

contagem
O tamanho do buffer.

_Mode
O modo de entrada e saída do buffer. Consulte ios_base::openmode para obter mais informações.

ptr
O buffer.

Observações

Ambos os construtores inicializam a classe base chamando streambuf( sb), onde sb é o objeto armazenado da classe strstreambuf. O primeiro construtor também inicializa sb chamando strstreambuf. O segundo construtor inicializa a classe base de uma de duas maneiras:

  • Se _Mode & ios_base::app== 0, então ptr deve designar o primeiro elemento de uma matriz de count elementos, e o construtor chama strstreambuf(ptr, countptr, ).

  • Caso contrário, ptr deve designar o primeiro elemento de uma matriz de elementos count que contém uma cadeia de caracteres C cujo primeiro elemento é designado por ptr, e o construtor chama strstreambuf(ptr, count,ptr + strlen (ptr)).

Ver também

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