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.