CKTIS / C++
std::ostream in std::basic_ostream — izhodni tokovi
std::basic_ostream je predloga izhodnega toka, std::ostream pa njen vzdevek za char. Omogočata oblikovanje vrednosti z operator<< in zapisovanje znakov v povezani medpomnilnik toka.
Različica: 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> ponuja vmesnik za izhod v medpomnilnik toka. CharT določa vrsto znaka, Traits pa zagotavlja operacije z znaki; privzeta vrednost je std::char_traits<CharT>. std::ostream je natančno vzdevek za std::basic_ostream<char>, ne ločena predloga ali izhodni objekt.
operator<< oblikuje vrednosti, na primer števila. Operacije vstavljanja vrnejo sklic na tok, zato jih je mogoče verižno povezovati. put(c) zapiše en znak, write(s, n) pa zapiše n znakov brez oblikovanja, razen če izhod ne uspe. flush() zahteva sinhronizacijo povezanega medpomnilnika; ne zagotavlja trajnega shranjevanja na disk.
Sprejmite std::ostream&, da lahko funkcija uporabi podani tok, ne da bi ga kopirala. V primeru write_value prejme std::cout in vrne isti tok, nato pa put('\n') doda znak za novo vrstico. Sam \n ne zahteva praznjenja medpomnilnika; primer izrecno pokliče flush().
Napake pri izhodu se sporočajo s stanjem toka, med drugim z failbit ali badbit; maska izjem lahko povzroči sprožitev izjeme. Ne predpostavljajte, da odsotnost izjeme pomeni uspeh: preverite stanje, kot to stori končni pogoj primera. Ta vnos obravnava C++23; navedeni standard za prevajanje ne potrjuje produkcijskega izvajalnega okolja. Viri predstavljajo razvijajoči se osnutek standarda.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.