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) | меняет местами объекты потока, за исключением связанного буфера (защищенная функция-член) |
Члены-классы
| реализует основную логику подготовки потока к операциям вывода (публичный член-класс) |
Функции вне класса
| вставляет символьные данные или вставляет в поток ссылочного значения (шаблон функции) |
|
|
(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) |
|
Внутренний расширяемый массив |
|
|
[static] | возвращает уникальный целочисленный идентификатор, пригодный для использования в качестве индекса для pword() и iword() (общедоступная статическая функция-член std::ios_base) |
| при необходимости увеличивает размер частного хранилища и предоставляет доступ к элементу типа long по указанному индексу (общедоступная функция-член std::ios_base) |
|
| при необходимости увеличивает размер частного хранилища и предоставляет доступ к элементу типа void* по указанному индексу (общедоступная функция-член std::ios_base) |
|
Разное |
|
| регистрирует функцию обратного вызова события (общедоступная функция-член std::ios_base) |
|
|
[static] | устанавливает, будут ли C++ и C библиотеки ввода/вывода взаимодействовать (общедоступная статическая функция-член std::ios_base) |
Вложенные классы |
|
| исключение потока (общедоступный вложенный класс std::ios_base) |
|
| инициализирует стандартные объекты потоков (общедоступный вложенный класс std::ios_base) |
|
Типы и константы членов |
|||||||||||||||||||||||||||||||||||||||
| Тип | Объяснение | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| тип режима открытия потока Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| тип флагов форматирования Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| тип состояния потока Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| тип направления поиска Также определены следующие константы:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
| указывает тип события (enum) |
|||||||||||||||||||||||||||||||||||||||
| тип обратного вызова функции (typedef) |
|||||||||||||||||||||||||||||||||||||||
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_ostream
