c++如何解析Subtitle字幕文件中的时间偏移参数【实战】

C++如何解析Subtitle字幕文件中的时间偏移参数【实战】

如何识别 SRT/ASS 字幕文件中的时间偏移字段

首先得澄清一个常见的误解：字幕文件本身并不定义什么“时间偏移参数”。它只老老实实地记录着每一行字幕出现的绝对时间点。所谓的“偏移”，其实是播放器或者后期工具在加载时，由外部施加的一个调整逻辑，文件里压根就没有一个叫 offset 的字段等着你去读。

看看例子就明白了。SRT 文件里，你看到的是 00:01:23,456 --> 00:01:25,789，这是起止的绝对时刻。ASS 文件里，Dialogue: 0,0:01:23.45,0:01:25.78,Default,,0,0,0,,{\an7}Hello 这一行，第二、三个字段同样是绝对时间（单位是秒，带小数）。所以，如果你发现字幕整体提前或延后了，那多半是播放器在背后偷偷加了个 Shift 操作，而不是文件里藏了什么秘密。

这样一来，我们的解析目标就清晰了：准确提取出每一行的时间字段，并准备好一套加减运算的机制，来模拟这个外部的偏移效果。

用 C++ 逐行解析 SRT 时间码（含毫秒）

SRT 的时间格式相当规整：HH:MM:SS,mmm，毫秒前面用逗号分隔，起止时间之间用 --> 连接。对付这种结构，用 std::getline 配合 std::sscanf 是最稳妥的选择，既避免了正则表达式可能带来的性能开销，代码也直观易懂。

• 解析时，先跳过空行和纯数字的序号行，直接定位到包含 --> 的那一行。
• 对于 "00:01:23,456 --> 00:01:25,789" 这样的字符串，直接上 sscanf(line.c_str(), "%d:%d:%d,%d --> %d:%d:%d,%d", &h1,&m1,&s1,&ms1, &h2,&m2,&s2,&ms2) 就能把各个部分抓出来。
• 接下来，统一转换成毫秒整数是个好习惯：total_ms = ((h * 3600 + m * 60 + s) * 1000 + ms)。这个整数形式对于后续做时间加减运算来说，简直不要太方便。
• 这里有个细节要注意：SRT 标准允许毫秒位数少于三位（比如 ,12 表示12毫秒）。sscanf 虽然能处理，但为了绝对精确，更推荐先用 find 定位到逗号，然后手动截取子字符串来转换整数。

ASS 文件中提取 Dialogue 行的时间字段（第 2、3 列）

ASS 格式就稍微“调皮”一点了。它的时间信息藏在 Dialogue: 行的第2和第3个由逗号分隔的字段里，格式是 0:01:23.45（注意，这里是点号分隔小数秒）。你不能像SRT那样直接从头开始 sscanf，因为字段位置可能因为行首的注释或空格而不固定，所以得先按逗号把整行“切开”。

立即学习“C++免费学习笔记（深入）”；

• 具体操作上，可以用 std::string::find_first_of(",") 依次找到第1、2个逗号的位置，然后用 substr 精准提取出第2和第3段内容。
• 对提取出的每一段时间字符串，调用 sscanf(segment.c_str(), "%d:%d:%lf", &h, &m, &s)。这里的 %lf 用来接收小数秒（比如 23.45 会被赋给 s）。
• 转换成毫秒时，公式是 static_cast(round((h*3600+m*60+s)*1000))。这里务必加上 round 进行四舍五入，否则浮点运算的微小误差（比如把0.001秒算成0秒）会让你在后续对齐时抓狂。
• 别忘了，ASS 里还有 Comment: 行，它的格式和 Dialogue: 很像，但只是注释，不应该参与时间计算。所以，一定要先检查行首是不是以 "Dialogue:" 开头。

应用偏移时务必区分「写回文件」和「内存修正」

说实话，解析时间字段本身并不算难，真正的“坑”往往出现在做完偏移之后，往文件里写回去的时候。两种格式的严格要求，一个都不能忘：

• SRT 输出：毫秒必须补足三位。你得用类似 printf("%02d:%02d:%02d,%03d", h,m,s,ms%1000) 的格式化方法。注意 ms%1000 是为了防止进位溢出（比如1005毫秒应该变成1秒5毫秒，而不是1秒005毫秒）。
• ASS 输出：小数秒最多保留两位，而且末尾的零最好去掉。通常的做法是，将毫秒转回秒级浮点数后，用 std::fixed 和 std::setprecision 控制位数，再手动清理像 23.40 这样的尾随零，输出 23.4。
• 这里有个黄金法则：别在解析阶段就急着去修改原始字符串。最好的做法是，解析时只读取和转换数值，完整保留原始的格式信息。等所有偏移计算都在内存中的数值上完成后，输出时再统一格式化成字符串。否则，多次处理同一文件时，精度丢失会像滚雪球一样累积起来。

最后，时间码的进位边界问题（比如59分59秒999毫秒再加1毫秒）必须自己显式处理，C++标准库可没有现成的时间类型来帮你自动搞定。最保险的流程就是：解析完先转成单一的毫秒整数，在这个整数上做完所有的偏移加减，最后再拆解回时、分、秒、毫秒。这套方法，可以说是最不容易翻车的实践了。