Standard library header <ostream>
From cppreference.net
Этот заголовок является частью библиотеки Ввода/вывода .
Классы |
||
|
оборачивает заданное абстрактное устройство (
std::basic_streambuf
)
и предоставляет высокоуровневый интерфейс вывода (шаблон класса) |
||
| std::ostream |
std::
basic_ostream
<
char
>
(typedef) |
|
| std::wostream |
std::
basic_ostream
<
wchar_t
>
(typedef) |
|
Функции |
||
|
вставляет символьные данные или вставляет в rvalue-поток
(шаблон функции) |
||
|
(C++23)
|
выводит
форматированное
представление аргументов
(шаблон функции) |
|
|
(C++23)
|
выводит
форматированное
представление аргументов с добавленным
'
\n
'
(шаблон функции) |
|
|
(C++23)
|
выполняет вывод с поддержкой Unicode, используя
type-erased
представление аргументов
(функция) |
|
|
(C++23)
|
выводит символьные данные, используя
type-erased
представление аргументов
(функция) |
|
Манипуляторы |
||
|
выводит
'
\n
'
и сбрасывает буфер выходного потока
(шаблон функции) |
||
|
выводит
'
\0
'
(шаблон функции) |
||
|
сбрасывает буфер выходного потока
(шаблон функции) |
||
|
(C++20)
|
управляет тем, будет ли
basic_syncbuf
потока отправлять данные при сбросе буфера
(шаблон функции) |
|
|
(C++20)
|
сбрасывает буфер потока и отправляет содержимое, если используется
basic_syncbuf
(шаблон функции) |
|
Синопсис
namespace std { template<class CharT, class Traits = char_traits<CharT>> class basic_ostream; using ostream = basic_ostream<char>; using wostream = basic_ostream<wchar_t>; template<class CharT, class Traits> basic_ostream<CharT, Traits>& endl(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& ends(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& flush(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& emit_on_flush(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& noemit_on_flush(basic_ostream<CharT, Traits>& os); template<class CharT, class Traits> basic_ostream<CharT, Traits>& flush_emit(basic_ostream<CharT, Traits>& os); template<class Ostream, class T> Ostream&& operator<<(Ostream&& os, const T& x); // функции вывода template<class... Args> void print(ostream& os, format_string<Args...> fmt, Args&&... args); template<class... Args> void println(ostream& os, format_string<Args...> fmt, Args&&... args); void println(ostream& os); void vprint_unicode(ostream& os, string_view fmt, format_args args); void vprint_nonunicode(ostream& os, string_view fmt, format_args args); }
Шаблон класса std::basic_ostream
namespace std { template<class CharT, class Traits = char_traits<CharT>> class basic_ostream : virtual public basic_ios<CharT, Traits> { public: // типы (унаследованные от basic_ios) using char_type = CharT; using int_type = typename Traits::int_type; using pos_type = typename Traits::pos_type; using off_type = typename Traits::off_type; using traits_type = Traits; // конструктор/деструктор explicit basic_ostream(basic_streambuf<char_type, Traits>* sb); virtual ~basic_ostream(); // префикс/суффикс class sentry; // форматированный вывод basic_ostream& operator<<(basic_ostream& (*pf)(basic_ostream&)); basic_ostream& operator<<(basic_ios<CharT, Traits>& (*pf)(basic_ios<CharT, Traits>&)); basic_ostream& operator<<(ios_base& (*pf)(ios_base&)); basic_ostream& operator<<(bool n); basic_ostream& operator<<(short n); basic_ostream& operator<<(unsigned short n); basic_ostream& operator<<(int n); basic_ostream& operator<<(unsigned int n); basic_ostream& operator<<(long n); basic_ostream& operator<<(unsigned long n); basic_ostream& operator<<(long long n); basic_ostream& operator<<(unsigned long long n); basic_ostream& operator<<(float f); basic_ostream& operator<<(double f); basic_ostream& operator<<(long double f); basic_ostream& operator<<(/*расширенный тип с плавающей точкой*/ f); basic_ostream& operator<<(const void* p); basic_ostream& operator<<(const volatile void* p); basic_ostream& operator<<(nullptr_t); basic_ostream& operator<<(basic_streambuf<char_type, Traits>* sb); // неформатированный вывод basic_ostream& put(char_type c); basic_ostream& write(const char_type* s, streamsize n); basic_ostream& flush(); // поиск pos_type tellp(); basic_ostream& seekp(pos_type); basic_ostream& seekp(off_type, ios_base::seekdir); protected: // copy/move constructor basic_ostream(const basic_ostream&) = delete; basic_ostream(basic_ostream&& rhs); // присваивание и обмен basic_ostream& operator=(const basic_ostream&) = delete; basic_ostream& operator=(basic_ostream&& rhs); void swap(basic_ostream& rhs); }; // вставщики символов template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, CharT); template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, signed char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, unsigned char); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, wchar_t) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char8_t) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char16_t) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, char32_t) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, char8_t) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, char16_t) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, char32_t) = delete; template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, const CharT*); template<class CharT, class Traits> basic_ostream<CharT, Traits>& operator<<(basic_ostream<CharT, Traits>&, const char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const signed char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const unsigned char*); template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const wchar_t*) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char8_t*) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char16_t*) = delete; template<class Traits> basic_ostream<char, Traits>& operator<<(basic_ostream<char, Traits>&, const char32_t*) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, const char8_t*) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, const char16_t*) = delete; template<class Traits> basic_ostream<wchar_t, Traits>& operator<<(basic_ostream<wchar_t, Traits>&, const char32_t*) = delete; }
Класс std::basic_ostream::sentry
namespace std { template<class CharT, class Traits> class basic_ostream<CharT, Traits>::sentry { bool ok_; // только для демонстрации public: explicit sentry(basic_ostream& os); ~sentry(); explicit operator bool() const { return ok_; } sentry(const sentry&) = delete; sentry& operator=(const sentry&) = delete; }; }