命名空间
变体
操作

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

出自 cppreference.cn
< cpp‎ | io‎ | basic filebuf
 
C++
 
输入/输出库
 
std::basic_filebuf
 
basic_filebuf* open( const char* s, std::ios_base::openmode mode );
 (1)
basic_filebuf* open( const std::string& str, std::ios_base::openmode mode );
 (2) (since C++11) (自 C++11 起)
basic_filebuf* open( const std::filesystem::path& p,
                     std::ios_base::openmode mode );
 (3) (since C++17) (自 C++17 起)
basic_filebuf* open( const std::filesystem::path::value_type* s,
                     std::ios_base::openmode mode );
 (4) (since C++17) (自 C++17 起)

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

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

仅当 std::filesystem::path::value_type 不是 char 时，才提供重载 (4)。

 (since C++17) (自 C++17 起)

文件以调用 std::fopen 的方式打开，第二个参数（文件访问模式）由 mode & ~std::ios_base::ate 的结果确定，如下所示，如果结果不是表中显示的标志的某种组合，则 open() 失败

mode & ~std::ios_base::ate  std::fopen 
访问
模式		 如果文件已存在，则执行的操作 如果文件不存在，则执行的操作
binary in out trunc app noreplace
(since C++23) (自 C++23 起)
- + - - - - "r" 从头开始读取 打开失败
+ + - - - - "rb"
- + + - - - "r+" 错误
+ + + - - - "r+b"
- - + - - - "w" 销毁内容 创建新文件
- - + + - -
+ - + - - - "wb"
+ - + + - -
- + + + - - "w+"
+ + + + - - "w+b"
- - + - - + "wx" 打开失败 创建新文件
- - + + - +
+ - + - - + "wbx"
+ - + + - +
- + + + - + "w+x"
+ + + + - + "w+bx"
- - + - + - "a" 写入末尾 创建新文件
- - - - + -
+ - + - + - "ab"
+ - - - + -
- + + - + - "a+"
- + - - + -
+ + + - + - "a+b"
+ + - - + -

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

目录

[edit] 参数

s, str, p - 要打开的文件名；s 必须指向一个空终止的字符串
openmode - 文件打开模式，是 std::ios_base::openmode 模式的二进制 OR

[edit] 返回值

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

[edit] 注解

open() 通常通过 std::basic_fstream 的构造函数或 open() 成员函数调用。

[edit] 示例

运行此代码
#include <fstream>
#include <iostream>
 
int main()
{
    std::string filename = "Test.b";
    std::filebuf fb;
 
    // prepare a file to read
    double d = 3.14;
    if (!fb.open(filename, std::ios::binary | std::ios::out))
    {
        std::cout << "Open file " << filename << " for write failed\n";
        return 1;
    } 
    fb.sputn(reinterpret_cast<char*>(&d), sizeof d);
    fb.close();
 
    // open file for reading
    double d2 = 0.0;
    if (!fb.open(filename, std::ios::binary | std::ios::in))
    {
        std::cout << "Open file " << filename << " for read failed\n";
        return 1;
    }
 
    auto got = fb.sgetn(reinterpret_cast<char*>(&d2), sizeof d2);
    if (sizeof(d2) != got)
        std::cout << "Read of " << filename << " failed\n";
    else
        std::cout << "Read back from file: " << d2 << '\n';
}

输出

Read back from file: 3.14

[edit] 缺陷报告

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

DR 应用于 已发布行为 正确行为
LWG 596 C++98 open() 无法在追加模式下打开文件 可以在追加模式下打开

[edit] 参见

 检查关联的文件是否已打开
(公共成员函数) [编辑]
 刷新放置区缓冲区并关闭关联的文件
(公共成员函数) [编辑]
Retrieved from "https://cppreference.cn/mwiki/index.php?title=cpp/io/basic_filebuf/open&oldid=155280"