База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници