CKTIS / C++
std::ostream e std::basic_ostream — fluxos de saída
std::basic_ostream é um modelo de fluxo de saída e std::ostream é o seu alias para char. Permitem formatar valores com operator<< e escrever caracteres num buffer de fluxo associado.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <ostream>
std::basic_ostream<CharT, Traits>
std::ostream // std::basic_ostream<char, std::char_traits<char>>
std::ostream& write_value(std::ostream& out, int value);std::basic_ostream<CharT, Traits> de <ostream> fornece uma interface para escrever num buffer de fluxo. CharT determina o tipo de carácter, enquanto Traits fornece as operações sobre caracteres; o valor predefinido é std::char_traits<CharT>. std::ostream é exatamente um alias de std::basic_ostream<char>, não um modelo distinto nem um objeto de saída.
operator<< formata valores como números. As operações de inserção devolvem uma referência ao fluxo, permitindo encadear chamadas. put(c) escreve um carácter, enquanto write(s, n) escreve n caracteres sem formatação, salvo se a saída falhar. flush() pede a sincronização do buffer associado; não garante o armazenamento duradouro dos dados no disco.
Aceite std::ostream& para que uma função possa usar o fluxo fornecido sem o copiar. No exemplo, write_value recebe std::cout e devolve o mesmo fluxo; em seguida, put('\n') acrescenta um carácter de mudança de linha. Um simples \n não pede que o buffer seja esvaziado; o exemplo chama flush() explicitamente.
Os erros de saída são comunicados através do estado do fluxo, incluindo failbit ou badbit; a máscara de exceções pode fazer com que seja lançada uma exceção. Não suponha que a ausência de uma exceção significa que a operação foi bem-sucedida: verifique o estado, como faz a condição final do exemplo. Esta entrada abrange C++23; a norma de compilação indicada não atesta um ambiente de execução de produção. As fontes apresentam um projeto de norma em evolução.
Exemplos
#include <iostream>
#include <locale>
#include <ostream>
std::ostream& write_value(std::ostream& out, int value) {
return out << "value=" << value;
}
int main() {
std::cout.imbue(std::locale::classic());
write_value(std::cout, 42).put('\n');
std::cout.flush();
return std::cout ? 0 : 1;
}
Resultado
value=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.