std::basic_ifstream<CharT,Traits>::basic_ifstream

basic_ifstream();	(1)
explicit basic_ifstream( const char* filename, std::ios_base::openmode mode = std::ios_base::in );	(2)
explicit basic_ifstream( const std::filesystem::path::value_type* filename, std::ios_base::openmode mode = std::ios_base::in );	(3)	(с C++17)
explicit basic_ifstream( const std::string& filename, std::ios_base::openmode mode = std::ios_base::in );	(4)	(с C++11)
template< class FsPath > explicit basic_ifstream( const FsPath& filename, std::ios_base::openmode mode = std::ios_base::in );	(5)	(с C++17)
basic_ifstream( basic_ifstream&& other );	(6)	(с C++11)
basic_ifstream( const basic_ifstream& rhs ) = delete;	(7)	(с C++11)

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

1) Конструктор по умолчанию: создаёт поток, не связанный с файлом: создаёт std::basic_filebuf по умолчанию и создаёт базовый класс с указателем на этот член std::basic_filebuf по умолчанию.

2,3) Сначала выполняет те же действия, что и конструктор по умолчанию, затем связывает поток с файлом, вызывая rdbuf()->open(filename, mode | std::ios_base::in) (см. std::basic_filebuf::open для подробностей о воздействии этого вызова). Если вызов open() возвращает нулевой указатель, устанавливает setstate(failbit). Перегрузка (3) предоставляется только если std::filesystem::path::value_type не char.(с C++17)

4,5) То же, что и basic_ifstream(filename.c_str(), mode). (5) участвует в разрешении перегрузки только если FsPath является std::filesystem::path.(с C++17)

6) Конструктор перемещения. Сначала перемещает базовый класс из other (что не влияет на указатель rdbuf()), затем перемещает член std::basic_filebuf, затем вызывает this->set_rdbuf() для установки нового basic_filebuf в качестве указателя rdbuf() в базовом классе.

7) Конструктор копирования удалён: этот класс не копируется.

Параметры

filename - имя файла для открытия

mode

определяет режим открытия потока. Можно использовать следующие константы и побитовое ИЛИ между ними:

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

other - другой поток файла, используемый в качестве источника

Пример

#include <fstream>
#include <string>
#include <utility>
 
int main()
{
    std::ifstream f0;
    std::ifstream f1("test.bin", std::ios::binary);
    std::string name = "example.txt";
    std::ifstream f2(name);
    std::ifstream f3(std::move(f1));
}

Отчёты об ошибках

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

DR	Применено к	Поведение, как опубликовано	Корректное поведение
LWG 3430	C++17	`std::filesystem::path` перегрузка приводила к нежелательным преобразованиям	избегается, сделав его шаблоном

См. также

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_ifstream/basic_ifstream