讲师中心 微信公众号
AI工具推荐 视频效率加速

c++如何利用Modern C++实现一个带异常安全机制的文件流包装类【详解】

梦磊君_9056

梦磊君_9056

发布时间:2026-04-02 15:47:06

|

942人浏览过

|

来源于php中文网

原创

必须显式启用异常掩码并预检路径,否则构造失败会导致半初始化对象和未定义行为;移动后需置空源流以确保RAII安全。

c++如何利用modern c++实现一个带异常安全机制的文件流包装类【详解】

为什么不能直接用 std::ifstream / std::ofstream 做异常安全封装

因为默认情况下,std::basic_ios::exceptions() 是关闭的 —— 即使底层系统调用失败(如文件不存在、权限不足、磁盘满),std::ifstream 也不会抛异常,只会置位 failbit 或 badbit,而你得手动检查 .good() 或 operator bool()。不显式开启异常掩码,所谓“异常安全”就是空谈。

更关键的是:构造函数里打开文件失败时,若没开启异常、又没做检查,对象就处于半初始化状态;析构时若再尝试关闭一个未成功打开的流,可能触发未定义行为。

  • 必须在构造函数中调用 stream.exceptions(std::ios_base::failbit | std::ios_base::badbit)
  • 若打开失败(比如 open() 内部调用 fopen 失败),会立即抛 std::ios_base::failure,确保构造不成功则对象不存活
  • 不要在构造函数里只调 open() 就返回——必须同步设置异常掩码,且顺序不能错:先设掩码,再 open

FileInputStream 和 FileOutputStream 的最小可行实现要点

不需要继承 std::ifstream / std::ofstream,用组合 + 移动语义更安全、更可控。重点不是“看起来像标准流”,而是“打开即有效、析构即释放、异常不泄漏资源”。

  • 内部持有 std::ifstream 或 std::ofstream 成员,声明为 mutable 仅当需支持 const 成员函数中调用 .read() 等(但通常不建议)
  • 构造函数参数应包含 std::ios_base::openmode,并透传给底层流的 open()
  • 移动构造/赋值必须显式定义:把源对象的流成员 std::move() 过来,并将源流置为 std::ifstream{}(C++11 起支持空流)
  • 析构函数无需显式 .close() —— std::ifstream 析构时自动关闭,只要它被正确构造过

示例片段:

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

立即学习“C++免费学习笔记(深入)”;

class FileInputStream {
    std::ifstream stream_;
public:
    explicit FileInputStream(const std::string& path)
        : stream_(path, std::ios_base::in | std::ios_base::binary) {
        stream_.exceptions(std::ios_base::failbit | std::ios_base::badbit);
        if (!stream_.is_open()) {
            throw std::runtime_error("Failed to open input file: " + path);
        }
    }

    FileInputStream(FileInputStream&& other) noexcept
        : stream_(std::move(other.stream_)) {}

    FileInputStream& operator=(FileInputStream&& other) noexcept {
        if (this != &other) {
            stream_.close(); // 安全起见,先关旧的(即使已关也无害)
            stream_ = std::move(other.stream_);
        }
        return *this;
    }
};

如何处理 std::ios_base::failure 异常的层级与信息丢失问题

std::ios_base::failure 只带一条字符串消息(通常是 "basic_ios::clear" 或 "iostream::seekoff"),不包含 errno 或系统错误码。这意味着你无法区分“文件不存在”和“拒绝访问”,对调试和用户提示很不友好。

  • 在构造或打开前,可用 std::filesystem::status() 预检路径是否存在、是否为常规文件、是否有读/写权限(C++17)
  • 若预检失败,抛出自定义异常(如 FileOpenError),附带 std::filesystem::file_status 和 errno(通过 std::system_category().message(errno))
  • 若预检通过但 open() 仍失败,说明是竞态条件(如文件被其他进程瞬间删除),此时捕获 std::ios_base::failure 并重新包装,至少保留原始 what() 和当前路径
  • 不要全局 catch(...) —— std::ios_base::failure 是派生自 std::system_error 的,可精准捕获

移动后原对象的状态与 RAII 边界容易被忽略的点

移动后原对象是否还“拥有”资源?答案是:不拥有,但它的 std::ifstream 成员可能仍处于 opened 状态(如果没正确 move 或没置空),导致双重 close 或析构时静默失败。

  • C++ 标准规定 std::ifstream 移动后进入“valid but unspecified state”,不保证已关闭;必须显式 .close() 或赋值为空流(std::ifstream{})
  • 移动赋值操作符里,不能只写 stream_ = std::move(other.stream_),必须先确保当前 stream_ 已关闭(或已析构)
  • 析构函数里不要假设 “只有我负责关” —— 如果类支持复制(不推荐),或有人绕过接口直接访问成员,就得更保守:加个 if (stream_.is_open()) stream_.close();
  • 最稳妥做法:所有资源管理逻辑只集中在构造、移动、析构三处,且移动后立即将源对象的流置为 std::ifstream{}

异常安全的核心不在“多抛几个异常”,而在“每个对象生命周期的起点和终点都明确、可验证”。一旦移动发生,原对象就该退化为“空壳”,不能再参与任何 I/O。

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2178

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1718

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2644

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6044

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5589

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7254

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

10494

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

5359

2025.07.29

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn