Qt小技巧17.使用魔法数（Magic Number）

1 什么是魔法数？

当使用 QDataStream 进行数据流读写时，魔法数（Magic Number）是用于标识特定文件格式或数据结构的固定数值或字节序列。

魔法数是一个固定的数值或字节序列，用于识别特定文件格式或数据表示方式，在读取操作中起到了一个检测标识的作用，可以帮助确定所读取的文件是否符合预期的格式，以便采取适当的处理方式。通过读取文件的魔法数，可以验证文件的完整性和格式正确性，以避免处理错误格式的文件。

2 举个例子

在写入文件时，使用 QDataStream 将魔法数写入文件，这个魔法数可以是一个整数或一个字节序列，取决于具体需求和文件格式的定义。例如，可以写入一个特定的整数或一个独特的字节序列：

QFile file("data.bin");
if (file.open(QIODevice::WriteOnly))
{
    QDataStream stream(&file);
    quint32 magicNumber = 0x12345678;
    stream << magicNumber;
    // 其他数据写入操作
    file.close();
}

在读取文件时，打开文件并使用 QDataStream 读取文件的魔法数。通过读取魔法数，可以检查文件是否符合预期格式：

QFile file("data.bin");
if (file.open(QIODevice::ReadOnly))
{
    QDataStream stream(&file);
    quint32 magicNumber;
    stream >> magicNumber;
    if (magicNumber == 0x12345678)
    {
        // 文件格式有效，可以继续读取其他数据
    }
    else
    {
        // 文件格式无效，采取相应的处理方式
    }
    file.close();
}

通过上述步骤，可以在读取文件之前先读取魔法数，并根据魔法数的值判断文件的格式是否有效。如果魔法数与预期值匹配，则文件被认为是有效的，可以继续读取其他数据。如果魔法数与预期值不匹配，则文件可能不符合预期格式，可以采取适当的处理方式，如报错或进行其他错误处理。

3 总结

魔法数是一种用于标识文件格式或数据结构的特定值或字节序列，可以在使用 QDataStream 进行数据读写时用于文件格式校验和数据处理选择。