Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ostream i std::basic_ostream — strumienie wyjściowe

std::basic_ostream to szablon strumienia wyjściowego, a std::ostream jest jego aliasem dla char. Pozwalają formatować wartości przez operator<< oraz zapisywać znaki do powiązanego bufora strumienia.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#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 nagłówka <ostream> opisuje interfejs wyjścia do bufora strumienia. Parametr CharT określa typ znaku, a Traits — operacje na znakach; domyślnie jest to std::char_traits<CharT>. std::ostream to dokładnie alias std::basic_ostream<char>, a nie osobny szablon ani obiekt wyjścia.

operator<< formatuje wartości, na przykład liczby. Operacje wstawiania zwracają referencję do strumienia, umożliwiając łączenie wywołań. put(c) zapisuje jeden znak, a write(s, n) zapisuje n znaków bez formatowania, chyba że zapis się nie powiedzie. flush() żąda synchronizacji powiązanego bufora; nie jest gwarancją trwałego zapisu na dysku.

Przyjmuj std::ostream&, aby funkcja korzystała z przekazanego strumienia bez jego kopiowania. W przykładzie write_value otrzymuje std::cout i zwraca ten sam strumień, po czym put('\n') dopisuje znak nowego wiersza. Samo \n nie żąda opróżnienia bufora; przykład wywołuje flush() jawnie.

Błędy wyjścia są sygnalizowane stanem strumienia, między innymi przez failbit lub badbit; maska wyjątków może spowodować zgłoszenie wyjątku. Nie zakładaj, że brak wyjątku oznacza sukces: sprawdzaj stan, jak w końcowym warunku przykładu. Zakres wpisu to C++23; podany standard kompilacji nie potwierdza środowiska produkcyjnego. Źródła przedstawiają rozwijany szkic standardu.

Przykłady

#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;
}

Wynik

value=42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła