std::basic_filebuf<CharT,Traits>:: open

如果关联文件已经打开（ is_open ( ) ! = false ），则立即返回空指针。

否则，以给定文件名（ s , p. c_str ( ) (C++17 起) 或 str. c_str ( ) ，取决于重载）打开文件。 std::ios_base::openmode 值可写作，例如 std:: ios_base :: out | std:: ios_base :: app 。

文件打开方式如同调用 std::fopen 函数，其第二个参数（文件访问模式）由 mode & ~ std:: ios_base :: ate 的运算结果决定，若结果不是下表中所示的标志组合， open() 函数将执行失败：

/$标签内的内容（包括C++字符串字面量"w+b"）均保留原文未翻译，表格中的"+"和"-"符号作为技术符号也未进行本地化处理）$

如果打开操作成功且 ( openmode & std:: ios_base :: ate ) ! = 0 （设置了 ate 位），则将文件位置重定位至文件末尾，如同调用 std:: fseek ( file, 0 , SEEK_END ) 函数，其中 file 是通过调用 std::fopen 返回的指针。如果重定位失败，则调用 close() 并返回空指针以指示操作失败。

参数

返回值

this 成功时返回该指针，失败时返回空指针。

注释

open() 通常通过构造函数或 open() 成员函数调用，该函数属于 std::basic_fstream 。

示例

#include <fstream>
#include <iostream>
int main()
{
    std::string filename = "Test.b";
    std::filebuf fb;
    // 准备要读取的文件
    double d = 3.14;
    if (!fb.open(filename, std::ios::binary | std::ios::out))
    {
        std::cout << "打开文件 " << filename << " 用于写入失败\n";
        return 1;
    } 
    fb.sputn(reinterpret_cast<char*>(&d), sizeof d);
    fb.close();
    // 打开文件用于读取
    double d2 = 0.0;
    if (!fb.open(filename, std::ios::binary | std::ios::in))
    {
        std::cout << "打开文件 " << filename << " 用于读取失败\n";
        return 1;
    }
    auto got = fb.sgetn(reinterpret_cast<char*>(&d2), sizeof d2);
    if (sizeof(d2) != got)
        std::cout << "读取 " << filename << " 失败\n";
    else
        std::cout << "从文件读取回的数据: " << d2 << '\n';
}

从文件读取回的数据: 3.14

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

另请参阅