Namespaces
Variants

std::basic_fstream<CharT,Traits>:: basic_fstream

From cppreference.net

C++
Input/output library
std::basic_fstream
basic_fstream ( ) ;
(1)
explicit basic_fstream ( const char * filename,

std:: ios_base :: openmode mode

= std:: ios_base :: in | std:: ios_base :: out ) ;
(2)
explicit basic_fstream ( const std :: filesystem :: path :: value_type * filename,

std:: ios_base :: openmode mode

= std:: ios_base :: in | std:: ios_base :: out ) ;
(3) (начиная с C++17)
(4) (начиная с C++11)
template < class FsPath >

explicit basic_fstream ( const FsPath & filename,
std:: ios_base :: openmode mode

= std:: ios_base :: in | std:: ios_base :: out ) ;
(5) (начиная с C++17)
basic_fstream ( basic_fstream && other ) ;
(6) (начиная с C++11)
basic_fstream ( const basic_fstream & rhs ) = delete ;
(7) (начиная с C++11)

Создает новый файловый поток.

1) Конструктор по умолчанию: создаёт поток, не связанный с файлом: создаёт по умолчанию std::basic_filebuf и конструирует базовый класс с указателем на этот созданный по умолчанию std::basic_filebuf член.
2,3) Сначала выполняет те же шаги, что и конструктор по умолчанию, затем связывает поток с файлом, вызывая rdbuf ( ) - > open ( filename, mode ) (см. std::basic_filebuf::open для подробностей о последствиях этого вызова). Если вызов open() возвращает нулевой указатель, устанавливает setstate ( failbit ) . Перегрузка (3) предоставляется только если std :: filesystem :: path :: value_type не является char . (начиная с C++17)
4,5) То же, что basic_fstream ( filename. c_str ( ) , mode ) . (5) участвует в разрешении перегрузки только если FsPath является std::filesystem::path . (since C++17)
6) Конструктор перемещения. Сначала перемещающе конструирует базовый класс из other (что не влияет на указатель rdbuf() ), затем перемещающе конструирует член std::basic_filebuf , затем вызывает this - > set_rdbuf ( ) чтобы установить новый basic_filebuf в качестве указателя rdbuf() в базовом классе.
7) Конструктор копирования удален: этот класс не поддерживает копирование.

Содержание

Параметры

filename - имя файла для открытия
mode - определяет режим открытия потока. Могут использоваться следующие константы и их побитовое ИЛИ:
Constant Explanation
app переход в конец потока перед каждой записью
binary открытие в бинарном режиме
in открытие для чтения
out открытие для записи
trunc очистка содержимого потока при открытии
ate переход в конец потока сразу после открытия
noreplace (C++23) открытие в эксклюзивном режиме
other - другой файловый поток для использования в качестве источника

Пример

Запустить этот код 
#include <fstream>
#include <string>
#include <utility>
int main()
{
    std::fstream f0;
    std::fstream f1("test.bin", std::ios::binary);
    std::string name = "example.txt";
    std::fstream f2(name);
    std::fstream f3(std::move(f1));
}

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Применяется к Поведение в опубликованной версии Корректное поведение
LWG 460 C++98 аргумент по умолчанию для mode в перегрузке (2)
отсутствовал (присутствует в синопсисе ) 		добавлен
LWG 3430 C++17 std::filesystem::path перегрузка приводила к нежелательным преобразованиям устранено путём преобразования в шаблон

Смотрите также

открывает файл и связывает его с потоком
(публичная функция-член)
открывает файл и настраивает его как связанную символьную последовательность
(публичная функция-член std::basic_filebuf<CharT,Traits> )
заменяет rdbuf без очистки его состояния ошибки
(защищённая функция-член)
конструирует объект
(публичная функция-член std::basic_iostream<CharT,Traits> )