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

CKTIS / C++

std::ostringstream — criar texto com um fluxo

std::ostringstream, declarado em <sstream>, formata valores em texto armazenado na memória. Usa o operador << como um fluxo de saída, enquanto str() obtém o resultado como std::string.

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

Sintaxe

#include <sstream>

std::ostringstream out;
out << value;
std::string text = out.str();

std::ostringstream é um alias de std::basic_ostringstream<char>, declarado em <sstream>. É um fluxo de saída que escreve num buffer interno de cadeia de caracteres, em vez de escrever diretamente num terminal ou ficheiro. É útil para compor mensagens com cadeias de caracteres e números. std::istringstream lê texto, enquanto std::stringstream suporta ambos os sentidos.

Insira valores com <<. Manipuladores como std::fixed e std::setprecision(2) controlam a formatação; em conjunto, pedem dois algarismos depois do separador decimal. A formatação numérica depende da localidade do fluxo. O exemplo define explicitamente std::locale::classic() para obter um ponto decimal.

A chamada out.str() num fluxo com nome devolve uma cópia do texto acumulado como std::string; não esvazia o buffer. Para reutilizar o fluxo, substitua o conteúdo com out.str(std::string{});. Separadamente, out.clear(); repõe as flags de erro, não o texto. Nenhuma destas operações repõe as definições de formatação predefinidas.

O exemplo usa interfaces disponíveis em C++23. O documento fornecido é um projeto de norma em evolução e pode também conter adições posteriores. A opção do compilador do repositório não atesta o ambiente de execução de produção.

Exemplos

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

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());
    out << "items=" << 3 << "; price="
        << std::fixed << std::setprecision(2) << 12.5;

    const std::string text = out.str();
    std::cout << text << '\n';
}

Resultado

items=3; price=12.50

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