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

来自cppreference.com
< cpp‎ | io‎ | basic fstream

 
C++
 
输入/输出库
 
std::basic_fstream
成员函数
basic_fstream::basic_fstream
(C++11)
(C++11)
文件操作
非成员函数
(C++11)
 
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)。只有在 std::filesystem::path::value_type 不是 char 时才会提供重载 (3)。 (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 - 指定打开模式。可使用下列常量或它们之间的逐位或：
常量 解释
app 每次写入前寻位到流结尾
binary 以二进制模式打开
in 为读打开
out 为写打开
trunc 在打开时舍弃流的内容
ate 打开后立即寻位到流结尾
noreplace (C++23) 以独占模式打开
other - 用作源的另一文件流

示例

运行此代码
#include <fstream>
#include <utility>
#include <string>
 
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++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 460 C++98 重载 (2) 中缺失了 mode 的默认实参（它在概要中有出现） 已补充
LWG 3430 C++17 std::filesystem::path 重载导致了不想要的转换 使之为模板以避免

参阅

 打开文件，并将它与流关联
(公开成员函数)
打开文件并配置它为关联字符序列
(std::basic_filebuf<CharT,Traits> 的公开成员函数)
替换 rdbuf 而不清除其错误状态
(受保护成员函数)
构造对象
(std::basic_iostream<CharT,Traits> 的公开成员函数)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/io/basic_fstream/basic_fstream&oldid=47807”