Namespaces
Variants

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

From cppreference.net

C++
Input/output library
std::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 . (since 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 - определяет режим открытия потока. Могут использоваться следующие константы и их побитовое ИЛИ:
Constant Explanation
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 Applied to Behavior as published Correct behavior
LWG 3430 C++17 std::filesystem::path overload led to unwanted conversions avoided by making it a template

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

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