📚 课程目录第2章二进制基础

二进制基础：字节序、整型与浮点数的二进制表示、文件指针操作

好，我们直接进入正题。解析XTC文件，本质上就是跟二进制数据打交道。你想想看，文件里存的不是你能直接读懂的字符串，而是一串串01序列。怎么把这些01序列还原成有意义的数字、结构体，甚至是大块的模型数据？

这里有几个绕不开的基础概念。我当年刚接触二进制协议时，就在字节序上栽过跟头，解析出来的坐标全是反的，模型整个扭曲了。所以这一章，我们把这些硬骨头啃干净。

1. 字节序：大端与小端

说白了，字节序就是多字节数据在内存里的排列顺序。一个int32占4个字节，这4个字节是高位在前，还是低位在前？这就是大端（Big-Endian）和小端（Little-Endian）的区别。

大端（Big-Endian）：高位字节存储在低地址。看起来符合人类的阅读习惯，从左往右读就行。网络协议、某些RISC架构喜欢用这个。
小端（Little-Endian）：低位字节存储在低地址。这更符合CPU的计算习惯，x86、x64架构都是小端。绝大多数PC和服务器都跑在小端上。

我记得XTC文件本身是小端序的，因为你大概率会在x86平台上生成和解析它。但保险起见，

推荐做法：在解析头部字段时，写个检测函数，主动判断一次，不要死记硬背。万一哪天跨平台传输了呢？

怎么在代码里判断当前系统是什么字节序？很简单，拿一个整型1的低地址字节看看就行。

#include <stdio.h>

int main() {
    int x = 1;
    unsigned char *p = (unsigned char*)&x;
    if (p[0] == 1) {
        printf("Little-Endian\n");
    } else {
        printf("Big-Endian\n");
    }
    return 0;
}

输出结果，在你的PC上几乎肯定是 Little-Endian。

2. 整型与浮点数的二进制表示

字节序搞定之后，我们来看看具体的数字怎么表示。

整型（整数）

XTC里常见的整型有 int32、uint32、int64。它们都是用补码表示的。正数的补码就是它本身的二进制，负数的补码是绝对值取反再加1。这一点比较基础，但我还是提一下，因为补码保证了加减法可以用同一套硬件电路实现。

举个例子，-1 在32位补码里是 0xFFFFFFFF。你在文件中看到一串 FF FF FF FF，要能立刻反应过来，这是个 -1，而不是一个很大的无符号数。

  关键点：解析时明确是有符号还是无符号。用错符号，数据量一大，错误会累积得非常离谱。

浮点数（IEEE 754）

这是很多人的噩梦，其实没那么复杂。一个单精度浮点数（float）占4个字节，它按照以下方式拼接：

位域	位数	说明
符号位	1 bit	0为正，1为负
指数位	8 bits	偏移量为127，即真实指数 = 存储值 - 127
尾数位	23 bits	隐含了整数部分的1（规范化情况下）

举个例子，你解析出来4个字节 0x40490FDB（小端序下可能看着不一样，注意字节序！），它代表的单精度浮点数是多少？我教你一个快速验证的方法：用C语言读出来，然后printf打印。不要用手算，容易错。

#include <stdio.h>
#include <stdint.h>

int main() {
    uint32_t raw = 0x40490FDB;  // 假设这是大端读进来的
    float value;
    // 做一次memcpy，避免类型双关（type punning）的歧义
    memcpy(&value, &raw, sizeof(value));
    printf("The float is: %f\n", value);  // 应该是3.141592...
    return 0;
}

输出：

The float is: 3.141592

看到了吧？0x40490FDB 就是圆周率 π 的单精度表示。在XTC文件里，顶点坐标、法向量、变换矩阵，这些几乎全是单精度浮点数。你只要能正确读出字节序，然后把四个字节memcpy到一个float变量里，就算完成了浮点数的解析。不用自己实现乘2的多少次方。

避坑指南：千万不要用 *(float*)&raw 这种强制转换来读。在某些编译器和严格别名规则下，这是未定义行为。编译器可能会优化掉它，导致程序行为诡异。我之前在优化解析性能时就这么干过，结果触发了一个极其难找的bug。老老实实用 memcpy 或 union。

3. 文件指针操作

解析二进制文件，说白了就是在一个大数组（文件内容）里来回移动指针，然后按固定大小读取数据块。

我们用C语言的标准库stdio.h来操作。核心工具就三个：

fread：从文件读取指定字节数到缓冲区。
fseek：移动文件指针到指定偏移。
ftell：获取当前文件指针位置（相对于文件开头）。

举个例子，假设我们想从文件偏移100字节处，读取一个32位整数。

FILE *fp = fopen("ir_test.xtc", "rb");
if (!fp) {
    perror("Failed to open file");
    return -1;
}

// 定位到偏移100
fseek(fp, 100, SEEK_SET);

uint32_t value = 0;
// 读取4个字节
fread(&value, sizeof(value), 1, fp);

// 现在value里存的是4个字节，但顺序是文件里的原始顺序（小端）
// 注意：fread直接按字节填充，不关心字节序
// 后续我们可能需要做字节序转换
printf("Raw value: 0x%08X\n", value);

fclose(fp);

这里有个细节很多人会忽略：文件指针的偏移量。XTC文件有很复杂的嵌套结构，常常需要你算出某个子数据块的实际偏移。我建议搞一个小结构体来管理解析上下文：

typedef struct {
    FILE *fp;
    long current_offset;  // 缓存一下当前偏移，避免频繁用ftell
} XtcParser;

// 初始化
XtcParser parser;
parser.fp = fopen("data.xtc", "rb");
parser.current_offset = 0;

另外，别忘了做错误检查。fread的返回值是实际读到的元素个数。如果文件意外截断，返回值会小于你请求的数量。我在解析一个较大的XTC轨迹文件时，发现末尾数据不全，就是用这个检查发现的。

  实用技巧：在开发调试阶段，每读一个数据块，都打印一下ftell的值，跟XTC文件格式文档里的偏移表对一下。对不上，就说明前面的解析逻辑出错了。这是最有效的定位手段。

好了，二进制基础的三个核心：字节序、数字表示、指针操作，到这里基本就讲完了。它们就像盖楼的地基，虽然枯燥，但真的绕不过去。下一节我们直接拿真实的XTC文件片段，亲手把它解析出来。