std::basic_ostream
Определён в заголовочном файле <ostream> | ||
|---|---|---|
template<
class CharT,
class Traits = std::char_traits<CharT>
> class basic_ostream : virtual public std::basic_ios<CharT, Traits>
|
Шаблон класса basic_ostream обеспечивает поддержку высокоуровневых операций вывода в символьные потоки. Поддерживаемые операции включают форматированный вывод (например, целочисленных значений) и неформатированный вывод (например, необработанных символов и массивов символов). Эта функциональность реализована на основе интерфейса, предоставляемого классом basic_streambuf, доступ к которому осуществляется через базовый класс basic_ios. В типичных реализациях basic_ostream не имеет невнаследованных членов-данных.
Диаграмма наследования
Предоставляется несколько псевдонимов типов для распространённых символьных типов:
Определён в заголовочном файле <ostream> |
|
|---|---|
| Тип | Определение |
std::ostream | std::basic_ostream<char> |
std::wostream | std::basic_ostream<wchar_t> |
Глобальные объекты
Стандартная библиотека предоставляет шесть глобальных объектов basic_ostream:
Определён в заголовочном файле <iostream> |
|
|---|---|
выполняет запись в стандартный поток вывода C stdout(глобальный объект) |
|
выполняет запись в стандартный поток ошибок C stderr без буферизации(глобальный объект) |
|
выполняет запись в стандартный поток ошибок C stderr(глобальный объект) |
|
Типы-члены
| Тип-член | Определение |
|---|---|
char_type |
CharT |
traits_type |
Traits; программа некорректна, если Traits::char_type не является CharT. |
int_type |
Traits::int_type |
pos_type |
Traits::pos_type |
off_type |
Traits::off_type |
Функции-члены
| создаёт объект (открытая функция-член) |
|
|
[виртуальный] | уничтожает объект (виртуальная открытая функция-член) |
|
(C++11) | перемещающим образом присваивает значение из другого basic_ostream (защищённая функция-член) |
Форматированный вывод |
|
| вставляет форматированные данные (открытая функция-член) |
|
Неформатированный вывод |
|
| вставляет символ (открытая функция-член) |
|
| вставляет блоки символов (открытая функция-член) |
|
Позиционирование |
|
| возвращает указатель позиции вывода (открытая функция-член) |
|
| устанавливает указатель позиции вывода (открытая функция-член) |
|
Прочее |
|
| синхронизирует поток с базовым устройством хранения данных (открытая функция-член) |
|
|
(C++11) | обменивает объекты потоков, кроме связанного буфера (защищённая функция-член) |
Классы-члены
| реализует базовую логику подготовки потока к операциям вывода (открытый класс-член) |
Функции, не являющиеся членами
| вставляет символьные данные или выполняет вставку в поток-значение rvalue (шаблон функции) |
|
|
(C++23) | выводит форматированное представление аргументов (шаблон функции) |
|
(C++23) | выводит форматированное представление аргументов с добавлением '\n' (шаблон функции) |
|
(C++23) | выполняет вывод с поддержкой Unicode, используя представление аргументов с удалённой информацией о типах (функция) |
|
(C++23) | выводит символьные данные, используя представление аргументов с удалённой информацией о типах (функция) |
Унаследовано от std::basic_ios
Типы-члены
| Тип-член | Определение |
|---|---|
char_type |
CharT |
traits_type |
Traits |
int_type |
Traits::int_type |
pos_type |
Traits::pos_type |
off_type |
Traits::off_type |
Функции-члены
Функции состояния |
|
| проверяет, не произошла ли ошибка, то есть доступны ли операции ввода-вывода (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| проверяет, достигнут ли конец файла (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| проверяет, произошла ли ошибка (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| проверяет, произошла ли неисправимая ошибка (открытая функция-член std::basic_ios<CharT,Traits>) |
|
проверяет, произошла ли ошибка (синоним fail()) (открытая функция-член std::basic_ios<CharT,Traits>) |
|
проверяет, не произошла ли ошибка (синоним !fail()) (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| возвращает флаги состояния (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| устанавливает флаги состояния (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| изменяет флаги состояния (открытая функция-член std::basic_ios<CharT,Traits>) |
|
Форматирование |
|
| копирует информацию о форматировании (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| управляет символом заполнения (открытая функция-член std::basic_ios<CharT,Traits>) |
|
Прочее |
|
| управляет маской исключений (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| устанавливает локаль (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| управляет связанным буфером потока (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| управляет связанным потоком (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| преобразует символы в узкие символы (открытая функция-член std::basic_ios<CharT,Traits>) |
|
| преобразует символы в широкие символы (открытая функция-член std::basic_ios<CharT,Traits>) |
|
Унаследовано от std::ios_base
Функции-члены
Форматирование |
|
| управляет флагами формата (открытая функция-член std::ios_base) |
|
| устанавливает определённый флаг формата (открытая функция-член std::ios_base) |
|
| сбрасывает определённый флаг формата (открытая функция-член std::ios_base) |
|
| управляет точностью десятичного представления операций с числами с плавающей точкой (открытая функция-член std::ios_base) |
|
| управляет шириной поля (открытая функция-член std::ios_base) |
|
Локали |
|
| устанавливает локаль (открытая функция-член std::ios_base) |
|
| возвращает текущую локаль (открытая функция-член std::ios_base) |
|
Внутренний расширяемый массив |
|
|
[статическая] | возвращает уникальное в пределах программы целое число, которое можно безопасно использовать в качестве индекса для pword() и iword() (открытая статическая функция-член std::ios_base) |
| при необходимости изменяет размер закрытого хранилища и предоставляет доступ к элементу типа long по заданному индексу (открытая функция-член std::ios_base) |
|
| при необходимости изменяет размер закрытого хранилища и предоставляет доступ к элементу типа void* по заданному индексу (открытая функция-член std::ios_base) |
|
Прочее |
|
| регистрирует функцию обратного вызова события (открытая функция-член std::ios_base) |
|
|
[статическая] | задаёт возможность взаимодействия библиотек ввода-вывода C++ и C (открытая статическая функция-член std::ios_base) |
Классы-члены |
|
| исключение потока (открытый класс-член std::ios_base) |
|
| инициализирует стандартные объекты потоков (открытый класс-член std::ios_base) |
|
Типы-члены и константы |
|||||||||||||||||||||||||||||||||||||||
| Тип | Описание | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| тип режима открытия потока Также определены следующие константы:
(псевдоним типа) |
|||||||||||||||||||||||||||||||||||||||
| тип флагов форматирования Также определены следующие константы:
(псевдоним типа) |
|||||||||||||||||||||||||||||||||||||||
| тип состояния потока Также определены следующие константы:
(псевдоним типа) |
|||||||||||||||||||||||||||||||||||||||
| тип направления перемещения Также определены следующие константы:
(псевдоним типа) |
|||||||||||||||||||||||||||||||||||||||
| задаёт тип события (перечисление) |
|||||||||||||||||||||||||||||||||||||||
| тип функции обратного вызова (псевдоним типа) |
|||||||||||||||||||||||||||||||||||||||
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/basic_ostream
