Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri