c++如何实现文件的断点续传写入_tellp获取进度并追加数据【实战】

陌敏酱_2389

陌敏酱_2389

2026-03-26

228人浏览

原创

断点续传需用fstream以ios::in|ios::out|ios::binary打开,先seekg(0,ios::end)再tellg()获取长度,写前clear()并seekp(0,ios::end),验证tellp()与预期一致后write并flush(),进度存外部文件或原文件头,用uint64_t类型。

c++如何实现文件的断点续传写入_tellp获取进度并追加数据【实战】

用 fstream 的 seekp 和 tellp 实现续传写入

断点续传写入本质是「在已有文件末尾(或指定位置)继续写,不覆盖、不重头」。C++ 标准库里没有现成的「断点续传」接口,但靠 fstream 的定位能力完全可以手动实现。关键不是“怎么打开”,而是“打开后怎么安全定位到上次写到哪”。

常见错误是直接用 ios::app 模式——它强制所有写入都在末尾,但无法得知当前文件长度;或者用 ios::in | ios::out 却忘了清空流状态,导致 tellp() 返回 -1。

  • fstream 必须以 ios::in | ios::out | ios::binary 打开,缺一不可:读取旧内容需要 in,写入需要 out,二进制模式避免换行符干扰偏移计算
  • 打开后立刻调用 seekg(0, ios::end) 再 tellg() 获取当前长度,这就是续传起点;别依赖 tellp() 初始值——刚打开时它未定义
  • 写入前务必调用 clear() 清除可能存在的 failbit(比如文件为空时 seekg 可能失败)

tellp 返回 -1 是什么情况?

tellp() 返回 -1 不代表“出错了”,只说明流处于无效状态(failbit 或 badbit 被置位)。最常见于:文件为空、打开失败、上一次操作失败未清理状态、或用了只读模式却调用 tellp。

C++ Code Review Master
C++ Code Review Master

组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载
  • 检查 is_open() 和 good(),不要只看 fail()——good() 才表示一切就绪
  • 如果文件为空,seekg(0, ios::end) 会成功,但 tellg() 返回 0;此时 tellp() 仍可能为 -1,必须先 clear() 再 seekp(0, ios::end)
  • Windows 下用文本模式打开二进制文件,tellp 计算的字节数会因 CRLF 转换失真,务必坚持 ios::binary

追加数据时如何避免覆盖或错位

续传的核心动作是「把写位置挪到文件末尾」,但不能简单用 ios::app——它会屏蔽你对位置的控制。正确做法是每次写前显式定位,并确认当前位置与预期一致。

  • 写入前执行 seekp(0, ios::end),再用 tellp() 验证是否等于预期偏移(比如上次记录的进度);不等就说明文件被外部修改过,需告警而非强行续传
  • 批量写入时,不要依赖多次 write() 后的 tellp() 累加——系统缓冲或部分写入会导致偏差,应以单次 write() 后立刻 tellp() 为准
  • 写入完成后立即 flush(),否则 tellp() 返回的是缓冲区偏移,不是实际落盘位置;尤其在程序可能崩溃的场景下,这步不能省

进度记录该存哪?存什么?

断点续传的“断点”信息必须持久化到文件外,否则重启即丢失。但别存成独立配置文件——多进程并发时容易冲突。最稳妥的是复用原文件头部(如前 8 字节)存已写入字节数。

  • 用单独小文件存进度(如 xxx.progress)最简单,但要确保写入原子性:先写临时文件,再 rename() 覆盖,避免读到半截数据
  • 若存原文件头部,必须用 seekp(0) 写入,且写完立刻 flush();同时首次创建文件时,头部默认填 0,后续只更新这个值
  • 记录的值必须是 size_t 或 uint64_t,别用 int——大文件超过 2GB 就溢出;读取时也用同样类型,避免符号扩展问题

真正麻烦的从来不是定位和写入,而是“怎么确认此刻的位置就是该续的地方”。外部篡改、缓存延迟、跨平台换行处理……这些细节不盯紧,tellp 返回的数字只是个幻觉。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

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

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

下载

相关标签:

c++

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

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

5919

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

2925

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

3708

10

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.29

2605

10

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3108

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

4649

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3729

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

426

15

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

3159

3

热门下载

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

精品课程

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

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

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

共0课时 | 0人学习