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.