CKTIS / C++
std::ostream y std::basic_ostream — flujos de salida
std::basic_ostream es una plantilla de flujo de salida, y std::ostream es su alias para char. Permiten dar formato a valores con operator<< y escribir caracteres en un búfer de flujo asociado.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#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> proporciona una interfaz para escribir en un búfer de flujo. CharT determina el tipo de carácter, mientras que Traits proporciona las operaciones sobre caracteres; su valor predeterminado es std::char_traits<CharT>. std::ostream es exactamente un alias de std::basic_ostream<char>, no una plantilla distinta ni un objeto de salida.
operator<< da formato a valores como los números. Las operaciones de inserción devuelven una referencia al flujo, lo que permite encadenar llamadas. put(c) escribe un carácter, mientras que write(s, n) escribe n caracteres sin darles formato, salvo que falle la salida. flush() solicita la sincronización del búfer asociado; no garantiza que los datos se almacenen de forma duradera en el disco.
Acepta std::ostream& para que una función pueda usar el flujo proporcionado sin copiarlo. En el ejemplo, write_value recibe std::cout y devuelve el mismo flujo; después, put('\n') añade un carácter de nueva línea. Un \n por sí solo no solicita vaciar el búfer; el ejemplo llama explícitamente a flush().
Los errores de salida se notifican mediante el estado del flujo, por ejemplo con failbit o badbit; la máscara de excepciones puede hacer que se lance una excepción. No des por hecho que la ausencia de una excepción significa que todo ha salido bien: comprueba el estado, como hace la condición final del ejemplo. Esta entrada se refiere a C++23; el estándar de compilación indicado no certifica un entorno de ejecución de producción. Las fuentes presentan un borrador de estándar en evolución.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.