std::ios_base

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека ввода/вывода

Манипуляторы ввода/вывода

Функции print(C++23)

Ввод/вывод в стиле C

Буферы

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (устарело в C++98)

basic_syncbuf (C++20)

Потоки

Абстракции

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Файловый ввод/вывод

basic_ifstream

basic_ofstream

basic_fstream

Ввод/вывод строк

basic_istringstream

basic_ostringstream

basic_stringstream

Ввод/вывод массивов

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (устарело в C++98)

ostrstream (устарело в C++98)

strstream (устарело в C++98)

Синхронизированный вывод

basic_osyncstream (C++20)

Типы

streamoff

streamsize

fpos

Интерфейс категорий ошибок

iostream_category (C++11)

io_errc (C++11)

 

std::ios_base

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

ios_base::ios_base

ios_base::~ios_base

Форматирование Оригинал: Formatting Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

ios_base::flags

ios_base::setf

ios_base::unsetf

ios_base::precision

ios_base::width

Языки Оригинал: Locales Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

ios_base::imbue

ios_base::getloc

Внутренние расширяемый массив Оригинал: Internal extensible array Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

ios_base::xalloc

ios_base::iword

ios_base::pword

Разное Оригинал: Miscellaneous Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

ios_base::register_callback

ios_base::sync_with_stdio

Член классов Оригинал: Member classes Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

ios_base::failure

ios_base::Init

Член типов Оригинал: Member types Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

ios_base::openmode

ios_base::fmtflags

ios_base::iostate

ios_base::seekdir

ios_base::event

ios_base::event_callback

 

Определено в заголовочном файле <ios>
class ios_base;

Класс ios_base — это многофункциональный класс, который служит в качестве базового класса для всех классов потока ввода-вывода. Он содержит несколько видов данных:

1) информация о состоянии: флаги статуса потока;

2) информация об управлении: флаги, которые управляют форматированием входных и выходных последовательностей и используемом языковом стандарте;

3) частные хранилища: индексированные расширяемые структуры данных, которые позволяют хранить данные типов long и void* и могут быть реализованы в виде двух массивов произвольной длины, или одного массива структур из двух элементов, или другой контейнер;

4) функции обратного вызова: произвольное число определяемых пользователем функций, которые будут вызываться из imbue(), copyfmt() и ~ios_base().

Типичная реализация содержит константы, соответствующие всем значениям fmtflags, iostate, openmode и seekdir, которые указаны ниже, и переменные для хранения текущей точности, ширины и флагов форматирования, маски исключений, состояния ошибок буфера, контейнера переменного размера с функциями обратного вызова, используемого в настоящий момент языкового стандарта, частного хранилища и статической целочисленной переменной для xalloc().

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

(конструктор)	создает объект (protected функция-элемент)
(деструктор) [virtual]	уничтожает объект (virtual public функция-элемент)
Форматирование
flags	управляет флагами форматирования (public функция-элемент)
setf	устанавливает заданные флаги форматирования (public функция-элемент)
unsetf	сбрасывает заданные флаги форматирования (public функция-элемент)
precision	управляет десятичной точностью операций над числами с плавающей запятой (public функция-элемент)
width	управляет символьной шириной полей (public функция-элемент)
Языковой стандарт
imbue	устанавливает языковой стандарт (public функция-элемент)
getloc	возвращает текущий языковой стандарт (public функция-элемент)
Внутренний расширяемый массив
xalloc [static]	возвращает уникальное в масштабах программы целое число, которое является безопасным для использования в качестве индекса для pword() и iword() (public static функция-элемент)
iword	при необходимости изменяет размер закрытого хранилища и предоставляет доступ к элементу типа long по заданному индексу (public функция-элемент)
pword	при необходимости изменяет размер закрытого хранилища и предоставляет доступ к элементу типа void* по заданному индексу (public функция-элемент)
Прочее
register_callback	регистрирует функцию обратного вызова на событие (public функция-элемент)
sync_with_stdio [static]	устанавливает, являются ли библиотеки ввода-вывода C и C++ функционально совместимыми (public static функция-элемент)

Переменные-члены

failure	Поток исключение Оригинал: stream exception Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public элемент класса)
Init	инициализирует стандартные объекты потока Оригинал: initializes standard stream objects Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public элемент класса)

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

Тип	Описание
openmode	тип режим открытия потока Также определены следующие константы: Константа Описание app перемещаться к концу потока перед каждой записью binary открыть в двоичном режиме in открыть для чтения out открыть для записи trunc удалить содержимое потока при открытии ate переместиться к концу потока сразу после открытия noreplace(C++23) открыть в режиме исключающего доступа (определение типа)
fmtflags	тип флагов форматирования Также определены следующие константы: Константа Описание dec использовать десятичное основание для ввода/вывода целых чисел (см. std::dec) oct использовать восьмеричное основание для ввода/вывода целых чисел (см. std::oct) hex использовать шестнадцатеричное основание для ввода/вывода целых чисел (см. std::hex) basefield dec | oct | hex. Используется для операций маскирования left выравнивать по левому краю (добавлять заполняющие символы справа (см. std::right)) right выравнивать по правому краю (добавлять заполняющие символы слева (см. std::left)) 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) (определение типа)
iostate	тип состояния потока Также определены следующие константы: Константа Описание goodbit ошибок нет badbit неустранимая ошибка потока failbit операция ввода/вывода провалилась (ошибка форматирования или извлечения) eofbit связанный поток достиг конца файла (определение типа)
seekdir	тип направления поиска Также определены следующие константы: Константа Описание beg начало потока end конец потока cur текущее положение указателя позиции потока (определение типа)
event	тип события (перечисление)
event_callback	тип функции обратного вызова (определение типа)

Устаревшие типы-члены Тип Описание io_state(устарело) целочисленный тип, который может быть использован как iostate open_mode(устарело) целочисленный тип, который может быть использован как openmode seek_dir(устарело) целочисленный тип, который может быть использован как seekdir streamoff(устарело) неуточненный тип, который может быть использован как off_type, не обязательно std::streamoff streampos(устарело) неуточненный тип, который может быть использован как pos_type, не обязательно std::streampos

(до C++17)

Отчет об ошибках

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 1357	C++98	определенные в std::ios_base операторы operator~, operator& и operator| для типов openmode, fmtflags и iostate нарушают требования типа BitmaskType	определения удалены

См. также

basic_ios

управляет произвольным буфером потока (шаблон класса)