CKTIS / C++
std::ostream i std::basic_ostream — izlazni tokovi
std::basic_ostream predložak je izlaznog toka, a std::ostream njegov je alias za char. Omogućuju formatiranje vrijednosti pomoću operator<< i zapisivanje znakova u pridruženi međuspremnik toka.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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> iz <ostream> pruža sučelje za izlaz u međuspremnik toka. CharT određuje vrstu znaka, dok Traits pruža operacije nad znakovima; zadana je vrijednost std::char_traits<CharT>. std::ostream točno je alias za std::basic_ostream<char>, a ne zaseban predložak ili izlazni objekt.
operator<< formatira vrijednosti, primjerice brojeve. Operacije umetanja vraćaju referencu na tok, što omogućuje ulančavanje poziva. put(c) zapisuje jedan znak, dok write(s, n) zapisuje n znakova bez formatiranja, osim ako izlaz ne uspije. flush() traži sinkronizaciju pridruženog međuspremnika; ne jamči trajno pohranjivanje na disk.
Prihvatite std::ostream& kako bi funkcija mogla upotrijebiti proslijeđeni tok bez njegova kopiranja. U primjeru write_value prima std::cout i vraća isti tok, nakon čega put('\n') dodaje znak za novi redak. Sam \n ne traži pražnjenje međuspremnika; primjer izričito poziva flush().
Pogreške izlaza prijavljuju se stanjem toka, među ostalim putem failbit ili badbit; maska iznimaka može uzrokovati bacanje iznimke. Nemojte pretpostaviti da izostanak iznimke znači uspjeh: provjerite stanje, kao što to čini završni uvjet primjera. Ovaj se unos odnosi na C++23; navedeni standard kompilacije ne potvrđuje produkcijsko okruženje izvođenja. Izvori prikazuju nacrt standarda koji se razvija.
Primjeri
#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;
}
Rezultat
value=42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.