CKTIS / C++
std::ostream a std::basic_ostream — výstupné prúdy
std::basic_ostream je šablóna výstupného prúdu a std::ostream je jej alias pre char. Umožňujú formátovať hodnoty pomocou operator<< a zapisovať znaky do priradenej vyrovnávacej pamäte prúdu.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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> z <ostream> poskytuje rozhranie na výstup do vyrovnávacej pamäte prúdu. CharT určuje typ znaku, zatiaľ čo Traits poskytuje operácie so znakmi; predvolenou hodnotou je std::char_traits<CharT>. std::ostream je presne alias pre std::basic_ostream<char>, nie samostatná šablóna ani výstupný objekt.
operator<< formátuje hodnoty, napríklad čísla. Vkladacie operácie vracajú referenciu na prúd, čo umožňuje reťaziť volania. put(c) zapíše jeden znak, zatiaľ čo write(s, n) zapíše n znakov bez formátovania, ak výstup nezlyhá. flush() žiada synchronizáciu priradenej vyrovnávacej pamäte; nezaručuje trvalé uloženie na disk.
Prijímajte std::ostream&, aby funkcia mohla použiť odovzdaný prúd bez jeho kopírovania. V príklade dostane write_value prúd std::cout a vráti ten istý prúd; potom put('\n') pridá znak nového riadka. Samotné \n nežiada vyprázdnenie vyrovnávacej pamäte; príklad výslovne volá flush().
Chyby výstupu sa oznamujú stavom prúdu, okrem iného pomocou failbit alebo badbit; maska výnimiek môže spôsobiť vyvolanie výnimky. Nepredpokladajte, že absencia výnimky znamená úspech: kontrolujte stav, ako to robí záverečná podmienka príkladu. Tento záznam sa týka C++23; uvedený štandard kompilácie nepotvrdzuje produkčné runtime prostredie. Zdroje predstavujú vyvíjajúci sa návrh štandardu.
Príklady
#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;
}
Výsledok
value=42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.