std::basic_fstream<CharT,Traits>::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) |
explicit basic_fstream( const std::string& filename,
std::ios_base::openmode mode
= std::ios_base::in | std::ios_base::out );
| (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.(начиная с C++17)
6) Конструктор перемещения. Сначала перемещением конструирует базовый класс из
other (это не влияет на указатель rdbuf()), затем перемещением конструирует член std::basic_filebuf, после чего вызывает this->set_rdbuf(), чтобы установить новый basic_filebuf в качестве указателя rdbuf() в базовом классе.
7) Конструктор копирования удалён: этот класс нельзя копировать.
Параметры
| filename | - | имя открываемого файла | ||||||||||||||||
| mode | - | задаёт режим открытия потока. Можно использовать следующие константы и их побитовое ИЛИ:
|
||||||||||||||||
| 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>) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/basic_fstream/basic_fstream
