Namespaces
Variants

std:: basic_ostream

From cppreference.net
< cpp ‎ | io
Определено в заголовочном файле <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 не имеет собственных (неунаследованных) членов данных.

cpp/io/ios base cpp/io/basic ios std-basic ostream-inheritance.svg

Диаграмма наследования

Предоставлены несколько typedef для распространённых символьных типов:

Определено в заголовочном файле <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

Функции-члены

конструирует объект
(public member function)
[virtual]
уничтожает объект
(virtual public member function)
(C++11)
перемещающее присваивание из другого basic_ostream
(protected member function)
Форматированный вывод
вставляет форматированные данные
(public member function)
Неформатированный вывод
вставляет символ
(public member function)
вставляет блоки символов
(public member function)
Позиционирование
возвращает индикатор позиции вывода
(public member function)
устанавливает индикатор позиции вывода
(public member function)
Прочие функции
синхронизирует с базовым устройством хранения
(public member function)
(C++11)
обменивает объекты потоков, кроме связанного буфера
(protected member function)

Классы-члены

реализует базовую логику подготовки потока к операциям вывода
(публичный класс-член)

Функции, не являющиеся членами класса

вставляет символьные данные или вставляет в rvalue поток
(шаблон функции)
выводит форматированное представление аргументов
(шаблон функции)
выводит форматированное представление аргументов с добавленным ' \n '
(шаблон функции)
выполняет вывод с поддержкой Unicode используя type-erased представление аргументов
(функция)
выводит символьные данные используя type-erased представление аргументов
(функция)

Унаследовано от 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 )
устанавливает, являются ли библиотеки ввода-вывода C++ и C взаимосовместимыми
(публичная статическая функция-член std::ios_base )
Классы-члены
исключение потока
(публичный класс-член std::ios_base )
инициализирует объекты стандартных потоков
(публичный класс-член std::ios_base )

Типы членов и константы

Тип Объяснение
тип режима открытия потока

Также определены следующие константы:

Константа Объяснение
app переход в конец потока перед каждой записью
binary открытие в бинарном режиме
in открытие для чтения
out открытие для записи
trunc удаление содержимого потока при открытии
ate переход в конец потока сразу после открытия
noreplace (C++23) открытие в эксклюзивном режиме

(typedef)
тип флагов форматирования

Также определены следующие константы:

Константа Объяснение
dec использование десятичной системы счисления для целочисленного ввода/вывода: см. std::dec
oct использование восьмеричной системы счисления для целочисленного ввода/вывода: см. std::oct
hex использование шестнадцатеричной системы счисления для целочисленного ввода/вывода: см. std::hex
basefield dec | oct | hex . Полезно для операций маскирования
left выравнивание по левому краю (добавляет символы заполнения справа): см. std::left
right выравнивание по правому краю (добавляет символы заполнения слева): см. std::right
internal внутреннее выравнивание (добавляет символы заполнения в указанную внутреннюю точку): см. std::internal
adjustfield left | right | internal . Полезно для операций маскирования
scientific генерация чисел с плавающей точкой в научной нотации, или шестнадцатеричной нотации при комбинации с fixed : см. std::scientific
fixed генерация чисел с плавающей точкой в фиксированной нотации, или шестнадцатеричной нотации при комбинации с scientific : см. std::fixed
floatfield scientific | fixed . Полезно для операций маскирования
boolalpha вставка и извлечение типа bool в буквенно-цифровом формате: см. std::boolalpha
showbase генерация префикса, указывающего систему счисления для целочисленного вывода, требование индикатора валюты в денежном вводе/выводе: см. std::showbase
showpoint безусловная генерация символа десятичной точки для вывода чисел с плавающей точкой: см. std::showpoint
showpos генерация символа + для неотрицательного числового вывода: см. std::showpos
skipws пропуск начальных пробельных символов перед определенными операциями ввода: см. std::skipws
unitbuf сброс буфера вывода после каждой операции вывода: см. std::unitbuf
uppercase замена определенных строчных букв их эквивалентами в верхнем регистре в определенных операциях вывода: см. std::uppercase

(typedef)
тип состояния потока

Также определены следующие константы:

Константа Объяснение
goodbit нет ошибки
badbit неустранимая ошибка потока
failbit ошибка операции ввода/вывода (ошибка форматирования или извлечения)
eofbit связанная входная последовательность достигла конца файла

(typedef)
тип направления позиционирования

Также определены следующие константы:

Константа Объяснение
beg начало потока
end конец потока
cur текущая позиция индикатора позиции потока

(typedef)
определяет тип события
(enum)
тип функции обратного вызова
(typedef)