std::basic_fstream

 

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::basic_fstream

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

basic_fstream::basic_fstream

basic_fstream::operator= (C++11)

basic_fstream::swap (C++11)

basic_fstream::rdbuf

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

basic_fstream::is_open

basic_fstream::open

basic_fstream::close

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

basic_fstream::swap(std::basic_fstream) (C++11)

 

<tbody> </tbody>

Определено в заголовочном файле <fstream>
template< class CharT, class Traits = std::char_traits<CharT> > class basic_fstream : public std::basic_iostream<CharT, Traits>

Шаблон класса basic_fstream реализует высокоуровневые операции ввода/вывода над файловыми потоками. Он обеспечивает взаимодействие буфера файлового потока (std::basic_filebuf) с высокоуровневым интерфейсом потока ввода-вывода (std::basic_iostream).

Типичная реализация std::basic_fstream содержит только одну непроизводную переменную-член: экземпляр класса std::basic_filebuf<CharT, Traits>.

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

Также определяются две специализации для распространенных типов символов:

Определены в заголовочном файле <fstream>
Тип	Определение
fstream	basic_fstream<char>
wfstream	basic_fstream<wchar_t>

Типы-члены

Тип	Определение
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

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

(конструктор)	создает файловый поток Оригинал: constructs the file stream Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
(деструктор) [virtual] (объявлено неявно)	уничтожает basic_fstream и связанный с ним буфер, закрывает файл (virtual public функция-элемент)
operator= (C++11)	перемещает файловый поток Оригинал: moves the file stream Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
swap (C++11)	меняет местами два файловых потока (public функция-элемент)
rdbuf	Возвращает файл устройства в бинарном (raw) формате Оригинал: returns the underlying raw file device object Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
Файловые операции
is_open	проверяет, владеет ли поток связанным файлом (public функция-элемент)
open	открывает файл и связывает его с потоком Оригинал: opens a file and associates it with the stream Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
close	закрывает связанный с потоком файл (public функция-элемент)

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

std::swap(std::basic_fstream) (C++11)

специализирует алгоритм std::swap (шаблон функции)

Унаследован от std::basic_istream

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

Форматированный ввод
operator>>	извлекает форматированные данные из потока ввода std::basic_istream (public функция-элемент std::basic_istream)
get	извлекает символы (public функция-элемент std::basic_istream)
peek	читает следующий символ без его извлечения (public функция-элемент std::basic_istream)
unget	помещает символ назад Оригинал: unextracts a character Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)
putback	ставит символ во входной поток Оригинал: puts character into input stream Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)
getline	извлекает символы, пока не будет найден заданный символ Оригинал: extracts characters until the given character is found Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)
ignore	извлекает и отбрасывает символы, пока заданный символ не будет найден Оригинал: extracts and discards characters until the given character is found Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)
read	извлекает блоки символов Оригинал: extracts blocks of characters Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)
readsome	извлекает готовые для обработки блоки символов (public функция-элемент std::basic_istream)
gcount	возвращает число символов, извлеченных при последней операции неформатированного ввода Оригинал: returns number of characters extracted by last unformatted input operation Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)
Управление позицией ввода
tellg	возвращает указатель позиции ввода (public функция-элемент std::basic_istream)
seekg	устанавливает указатель позиции ввода (public функция-элемент std::basic_istream)
Прочее
sync	синхронизируется с основным устройством хранения Оригинал: synchronizes with the underlying storage device Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_istream)

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

sentry

реализует основную логику для подготовки потока к операциям ввода (public элемент класса std::basic_istream)

Унаследован от std::basic_ostream

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

Форматированный вывод
operator<<	вставляет форматированные данные в поток вывода std::basic_ostream (public функция-элемент std::basic_ostream)
Неформатированный вывод
put	вставляет символ Оригинал: inserts a character Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_ostream)
write	вставляет блок символов (public функция-элемент std::basic_ostream)
Управление позицией вывода
tellp	возвращает указатель позиции вывода (public функция-элемент std::basic_ostream)
seekp	устанавливает указатель позиции вывода (public функция-элемент std::basic_ostream)
Прочее
flush	синхронизируется с основным устройством хранения Оригинал: synchronizes with the underlying storage device Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_ostream)

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

sentry

реализует основную логику для подготовки потока к операциям вывода (public элемент класса std::basic_ostream)

Унаследован от std::basic_ios

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

Тип	Определение
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

Функции состояния
good	проверяет отсутствие ошибок, т.е. доступны ли операции ввода/вывода (public функция-элемент std::basic_ios)
eof	проверяет, достигнут ли конец файла (public функция-элемент std::basic_ios)
fail	проверяет, произошла ли устранимая ошибка (public функция-элемент std::basic_ios)
bad	проверяет, произошла ли неустранимая ошибка Оригинал: checks if a non-recoverable error has occurred Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент std::basic_ios)
operator!	проверяет, произошла ли ошибка (синоним std::basic_ios::fail) (public функция-элемент std::basic_ios)
operator void*operator bool (до C++11)(начиная с C++11)	проверяет отсутствие ошибок (синоним !fail()) (public функция-элемент std::basic_ios)
rdstate	возвращает флаги состояния (public функция-элемент std::basic_ios)
setstate	устанавливает флаги состояния (public функция-элемент std::basic_ios)
clear	очищает флаги ошибок и конца файла (public функция-элемент std::basic_ios)
Форматирование
copyfmt	копирует информацию о форматировании (public функция-элемент std::basic_ios)
fill	управляет символом заполнения (public функция-элемент std::basic_ios)
Прочее
exceptions	управляет маской исключений (public функция-элемент std::basic_ios)
imbue	устанавливает языковой стандарт (public функция-элемент std::basic_ios)
rdbuf	управляет буфером связанного потока (public функция-элемент std::basic_ios)
tie	управляет связанными потоком (public функция-элемент std::basic_ios)
narrow	конвертирует символ в символ меньшей ширины (public функция-элемент std::basic_ios)
widen	конвертирует символ в символ большей ширины (public функция-элемент std::basic_ios)

Унаследован от std::ios_base

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

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

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

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

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

Тип	Описание
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	тип функции обратного вызова (определение типа)