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

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.

Fontes