CKTIS / C++
std::ostream и std::basic_ostream — изходни потоци
std::basic_ostream е шаблон за изходен поток, а std::ostream е неговият псевдоним за char. Те позволяват форматиране на стойности с operator<< и записване на знаци в свързан буфер на поток.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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> от <ostream> предоставя интерфейс за извеждане към буфер на поток. CharT определя типа на знака, а Traits предоставя операциите със знаци; стойността по подразбиране е std::char_traits<CharT>. std::ostream е точно псевдоним на std::basic_ostream<char>, а не отделен шаблон или изходен обект.
operator<< форматира стойности, например числа. Операциите за вмъкване връщат препратка към потока и така позволяват свързване на извикванията. put(c) записва един знак, а write(s, n) записва n знака без форматиране, освен ако извеждането не се провали. flush() заявява синхронизиране на свързания буфер; това не гарантира трайно съхранение на диска.
Приемайте std::ostream&, за да може функцията да използва подадения поток, без да го копира. В примера write_value получава std::cout и връща същия поток, след което put('\n') добавя знак за нов ред. Самостоятелното \n не заявява изпразване на буфера; примерът извиква flush() изрично.
Грешките при извеждане се сигнализират чрез състоянието на потока, включително с failbit или badbit; маската на изключенията може да доведе до хвърляне на изключение. Не приемайте, че липсата на изключение означава успех: проверявайте състоянието, както прави последното условие в примера. Тази статия е за C++23; посоченият стандарт за компилация не удостоверява производствена среда за изпълнение. Източниците представят развиващ се проект на стандарт.
Примери
#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;
}
Резултат
value=42
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.