std::basic_ofstream - cppreference.com

来自cppreference.com


template< class CharT, class Traits = std::char_traits<CharT> > class basic_ofstream : public std::basic_ostream<CharT, Traits>

类模板 basic_ofstream 实现文件上基于流的高层输出操作。它将 std::basic_ostream 的高层接口赋予基于文件的流缓冲（std::basic_filebuf）。

std::basic_ofstream 的典型实现只保有一个非派生成员：一个 std::basic_filebuf<CharT, Traits> 的实例。

继承图

提供了几个针对常用字符类型的 typedef：


类型	定义
`std::ofstream`	`std::basic_ofstream<char>`
`std::wofstream`	`std::basic_ofstream<wchar_t>`

成员类型

成员类型	定义
`char_type`	`CharT`[编辑]
`traits_type`	`Traits`；`Traits::char_type` 不是 `CharT` 时程序非良构。[编辑]
`int_type`	`Traits::int_type`[编辑]
`pos_type`	`Traits::pos_type`[编辑]
`off_type`	`Traits::off_type`[编辑]

成员函数

(构造函数)	构造文件流 (公开成员函数) [编辑]
(析构函数) [虚] (隐式声明)	析构 `basic_ofstream` 和关联的缓冲区，并关闭文件 (虚公开成员函数) [编辑]
operator= (C++11)	移动文件流 (公开成员函数) [编辑]
swap (C++11)	交换两个文件流 (公开成员函数) [编辑]
rdbuf	返回底层未处理的文件设备对象 (公开成员函数) [编辑]
native_handle (C++26)	返回底层的由实现定义的句柄 (公开成员函数) [编辑]
文件操作
is_open	检查流是否有关联文件 (公开成员函数) [编辑]
open	打开文件，并将它与流关联 (公开成员函数) [编辑]
close	关闭关联文件 (公开成员函数) [编辑]

非成员函数

继承自 std::basic_ostream

成员函数

有格式输出
operator<<	插入带格式数据 (`std::basic_ostream<CharT,Traits>` 的公开成员函数) [编辑]
无格式输出
put	插入字符 (`std::basic_ostream<CharT,Traits>` 的公开成员函数) [编辑]
write	按区块插入字符 (`std::basic_ostream<CharT,Traits>` 的公开成员函数) [编辑]
寻位
tellp	返回输出位置指示器 (`std::basic_ostream<CharT,Traits>` 的公开成员函数) [编辑]
seekp	设置输出位置指示器 (`std::basic_ostream<CharT,Traits>` 的公开成员函数) [编辑]
杂项
flush	与底层存储设备同步 (`std::basic_ostream<CharT,Traits>` 的公开成员函数) [编辑]

成员类

为输出操作实现流准备的基本逻辑
(std::basic_ostream<CharT,Traits> 的公开成员类) [编辑]

继承自 std::basic_ios

成员类型

成员类型	定义
`char_type`	`CharT`
`traits_type`	`Traits`
`int_type`	`Traits::int_type`
`pos_type`	`Traits::pos_type`
`off_type`	`Traits::off_type`

成员函数

状态函数
good	检查是否没有发生错误，即是否可执行输入/输出操作 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
eof	检查是否到达了文件末尾 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
fail	检查是否发生了可恢复的错误 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
bad	检查是否已发生不可恢复的错误 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
operator!	检查是否有错误发生（`fail()` 的同义词） (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
operator bool	检查是否没有发生错误（`!`std::basic_ios::fail 的同义词） (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
rdstate	返回状态标志 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
setstate	设置状态标志 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
clear	修改状态标志 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
格式化
copyfmt	复制格式化信息 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
fill	管理填充字符 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
杂项
exceptions	管理异常掩码 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
imbue	设置本地环境 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
rdbuf	管理相关的流缓冲区 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
tie	管理绑定的流 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
narrow	窄化字符 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]
widen	拓宽字符 (`std::basic_ios<CharT,Traits>` 的公开成员函数) [编辑]

注解

功能特性测试宏	值	标准	功能特性
`__cpp_lib_fstream_native_handle`	`202306L`	(C++26)	原生句柄支持

示例

#include <fstream>
#include <iostream>
#include <string>

int main()
{
    std::string filename = "Test.b";
    {
        std::ofstream ostrm(filename, std::ios::binary);
        double d = 3.14;
        ostrm.write(reinterpret_cast<char*>(&d), sizeof d); // 二进制输出
        ostrm << 123 << "abc" << '\n';                      // 文本输出
    }
    
    // 回读
    std::ifstream istrm(filename, std::ios::binary);
    double d;
    istrm.read(reinterpret_cast<char*>(&d), sizeof d);
    int n;
    std::string s;
    istrm >> n >> s;
    std::cout << "回读：" << d << " " << n << " " << s << '\n';
}

输出：

std::basic_ofstream - cppreference.com

成员类型

成员函数

文件操作

非成员函数

继承自 std::basic_ostream

成员函数

有格式输出

无格式输出

寻位

杂项

成员类

继承自 std::basic_ios

成员类型

成员函数

状态函数

格式化

杂项

注解

示例