CKTIS / C++
std::ostream a std::basic_ostream — výstupní proudy
std::basic_ostream je šablona výstupního proudu a std::ostream je její alias pro char. Umožňují formátovat hodnoty pomocí operator<< a zapisovat znaky do přidruženého bufferu proudu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 rozhraní pro výstup do bufferu proudu. CharT určuje typ znaku, zatímco Traits poskytuje operace se znaky; výchozí hodnota je std::char_traits<CharT>. std::ostream je přesně alias pro std::basic_ostream<char>, nikoli samostatná šablona nebo výstupní objekt.
operator<< formátuje hodnoty, například čísla. Vkládací operace vracejí referenci na proud, takže lze volání řetězit. put(c) zapíše jeden znak, zatímco write(s, n) zapíše n znaků bez formátování, pokud výstup neselže. flush() požaduje synchronizaci přidruženého bufferu; nezaručuje trvalé uložení na disk.
Přijímejte std::ostream&, aby funkce mohla použít předaný proud bez jeho kopírování. V příkladu obdrží write_value proud std::cout a vrátí tentýž proud; poté put('\n') přidá znak nového řádku. Samotné \n nepožaduje vyprázdnění bufferu; příklad volá flush() výslovně.
Chyby výstupu se oznamují stavem proudu, mimo jiné pomocí failbit nebo badbit; maska výjimek může způsobit vyvolání výjimky. Nepředpokládejte, že absence výjimky znamená úspěch: kontrolujte stav, jak to dělá závěrečná podmínka příkladu. Tento záznam se vztahuje k C++23; uvedený standard kompilace nepotvrzuje produkční běhové prostředí. Zdroje představují vyvíjející se návrh standardu.
Pří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ýsledek
value=42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.