Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje