Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::stringstream — ler e escrever texto em memória

std::stringstream de <sstream> formata valores como texto e lê valores a partir de texto guardado em memória. Combina os operadores << e >> com um buffer de cadeia de caracteres e o estado de erro do fluxo.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <sstream>
std::stringstream stream;
stream << value;
stream >> variable;
std::string text = stream.str();

std::stringstream de <sstream> é um alias de std::basic_stringstream<char>. Guarda texto em memória e, por predefinição, permite tanto a leitura como a escrita. std::istringstream destina-se à leitura, enquanto std::ostringstream se destina à escrita.

O operador << formata valores no buffer e >> lê valores para variáveis. A extração formatada ignora, por predefinição, os espaços em branco iniciais; a extração para um std::string termina antes do espaço em branco seguinte. A formatação de números depende das definições regionais do fluxo; o exemplo configura o fluxo com std::locale::classic().

Para um fluxo com nome, stream.str() devolve uma cópia do texto, incluindo as partes já lidas. As posições de leitura e escrita são independentes: escrever não avança a posição de leitura. No entanto, não suponha que cada escrita seguinte acrescenta texto ao fim; isso depende da posição de escrita e do modo de abertura.

Verifique o sucesso com if (stream >> value). Uma conversão falhada pode definir failbit, e chegar ao fim da entrada pode definir eofbit. Para reutilizar o fluxo com texto novo, chame stream.clear(); stream.str("new text");. clear() repõe os indicadores de estado, mas não remove o texto nem recua o fluxo; str(...) substitui o texto, mas não repõe os indicadores de erro.

Exemplos

#include <iostream>
#include <locale>
#include <sstream>
#include <string>

int main() {
    std::stringstream stream;
    stream.imbue(std::locale::classic());
    stream << "Ada " << 42;

    std::string name;
    int score = 0;
    if (stream >> name >> score) {
        std::cout << name << '\n';
        std::cout << stream.str() << '\n';
    } else {
        return 1;
    }
}

Resultado

Ada
Ada 42

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes