登录
侧边栏壁纸
博主头像
勇芳

  • 累计撰写 330 篇文章
  • 累计收到 0 条评论
VisualFreeBasic编程文档

SDL3_API分类参考_字节序（CategoryEndian）

勇芳
2026-3-6 / 0 评论 / 9 阅读

字节序子系统（CategoryEndian）

SDL 提供了用于转换特定字节序数值的函数，可实现不同字节序（大小端）之间的转换。

这些函数分为两类：

  1. 无条件字节序交换（SDL_Swap16、SDL_Swap32、SDL_Swap64、SDL_SwapFloat）：无论当前系统字节序如何，始终反转数值的字节顺序；
  2. 与系统原生字节序互转（SDL_Swap16LE/SDL_Swap16BE、SDL_Swap32LE/SDL_Swap32BE、SDL_SwapFloatLE/SDL_SwapFloatBE）：这类功能由宏实现，若无需交换则直接返回原值（无操作）——例如 x86（小端）处理器上，SDL_Swap32LE 无动作，SDL_Swap32BE 反转字节；PowerPC（大端）处理器上则行为相反。

字节序交换例程为内联函数，会尽可能使用编译器内联函数、内联汇编等优化手段，保证字节交换的执行效率。

函数

  • SDL_Swap16：无条件交换 16 位整数的字节序（返回交换后的值）
  • SDL_Swap32：无条件交换 32 位整数的字节序（返回交换后的值）
  • SDL_Swap64：无条件交换 64 位整数的字节序（返回交换后的值）
  • SDL_SwapFloat：无条件交换 32 位浮点数的字节序（返回交换后的值）

数据类型

  • （无）

结构体

  • （无）

枚举

  • （无）

宏

  • SDL_BIG_ENDIAN：宏常量，标识大端字节序（高位字节存储在低地址）
  • SDL_BYTEORDER：编译期宏，标识当前系统的原生字节序（值为 SDL_BIG_ENDIAN 或 SDL_LIL_ENDIAN）
  • SDL_FLOATWORDORDER：宏常量，标识浮点数的字节序（通常与整数字节序一致）
  • SDL_LIL_ENDIAN：宏常量，标识小端字节序（低位字节存储在低地址，等价于 SDL_LITTLE_ENDIAN）
  • SDL_Swap16BE：将 16 位整数从大端序转换为系统原生字节序（小端系统交换，大端系统无操作）
  • SDL_Swap16LE：将 16 位整数从小端序转换为系统原生字节序（大端系统交换，小端系统无操作）
  • SDL_Swap32BE：将 32 位整数从大端序转换为系统原生字节序（小端系统交换，大端系统无操作）
  • SDL_Swap32LE：将 32 位整数从小端序转换为系统原生字节序（大端系统交换，小端系统无操作）
  • SDL_Swap64BE：将 64 位整数从大端序转换为系统原生字节序（小端系统交换，大端系统无操作）
  • SDL_Swap64LE：将 64 位整数从小端序转换为系统原生字节序（大端系统交换，小端系统无操作）
  • SDL_SwapFloatBE：将 32 位浮点数从大端序转换为系统原生字节序（小端系统交换，大端系统无操作）
  • SDL_SwapFloatLE：将 32 位浮点数从小端序转换为系统原生字节序（大端系统交换，小端系统无操作）

FreeBASIC 示例代码

' 引入 SDL 相关声明（需确保 FreeBASIC 已链接 SDL3 库）
#Include "SDL.bi"

' 补充函数声明（FreeBASIC 绑定可能缺失）
Declare Function SDL_Swap16 CDecl (ByVal x As UShort) As UShort
Declare Function SDL_Swap32 CDecl (ByVal x As UInteger) As UInteger
Declare Function SDL_Swap64 CDecl (ByVal x As ULongInt) As ULongInt
Declare Function SDL_SwapFloat CDecl (ByVal x As Single) As Single

' 补充字节序宏定义（若 FreeBASIC 绑定未包含）
#If Not Defined(SDL_BIG_ENDIAN)
    #Define SDL_BIG_ENDIAN 4321
#EndIf
#If Not Defined(SDL_LIL_ENDIAN)
    #Define SDL_LIL_ENDIAN 1234
#EndIf
#If Not Defined(SDL_BYTEORDER)
    ' x86/x86_64 默认为小端，其他架构需根据实际情况调整
    #Define SDL_BYTEORDER SDL_LIL_ENDIAN
#EndIf

' 定义大小端转换宏（模拟 SDL 原生宏行为）
#If SDL_BYTEORDER = SDL_LIL_ENDIAN
    #Define SDL_Swap16LE(x) (x)          ' 小端系统：LE转原生=无操作
    #Define SDL_Swap16BE(x) SDL_Swap16(x)' 小端系统：BE转原生=交换
    #Define SDL_Swap32LE(x) (x)          ' 小端系统：LE转原生=无操作
    #Define SDL_Swap32BE(x) SDL_Swap32(x)' 小端系统：BE转原生=交换
    #Define SDL_SwapFloatLE(x) (x)       ' 小端系统：LE转原生=无操作
    #Define SDL_SwapFloatBE(x) SDL_SwapFloat(x)' 小端系统：BE转原生=交换
#Else
    #Define SDL_Swap16LE(x) SDL_Swap16(x)' 大端系统：LE转原生=交换
    #Define SDL_Swap16BE(x) (x)          ' 大端系统：BE转原生=无操作
    #Define SDL_Swap32LE(x) SDL_Swap32(x)' 大端系统：LE转原生=交换
    #Define SDL_Swap32BE(x) (x)          ' 大端系统：BE转原生=无操作
    #Define SDL_SwapFloatLE(x) SDL_SwapFloat(x)' 大端系统：LE转原生=交换
    #Define SDL_SwapFloatBE(x) (x)       ' 大端系统：BE转原生=无操作
#EndIf

' 打印字节序信息
Sub PrintEndianInfo()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "【系统字节序信息】")
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "原生字节序：%s", _
        IIf(SDL_BYTEORDER = SDL_LIL_ENDIAN, "小端 (LIL_ENDIAN)", "大端 (BIG_ENDIAN)"))

    ' 示例：32位整数 0x12345678 的字节序
    Dim As UInteger test32 = &H12345678
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "原始32位值：0x%08X", test32)
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "无条件交换后：0x%08X", SDL_Swap32(test32))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "BE转原生后：0x%08X", SDL_Swap32BE(test32))
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "LE转原生后：0x%08X", SDL_Swap32LE(test32))
End Sub

' 模拟文件/网络数据读写（大端序）
Sub HandleBigEndianData()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, vbCrLf & "【处理大端序数据】")

    ' 假设从文件/网络读取的大端序数据
    Dim As UShort be16 = &H1234   ' 大端序 16 位数据
    Dim As UInteger be32 = &H12345678 ' 大端序 32 位数据
    Dim As Single beFloat = 123.456   ' 大端序浮点数

    ' 转换为系统原生字节序
    Dim As UShort native16 = SDL_Swap16BE(be16)
    Dim As UInteger native32 = SDL_Swap32BE(be32)
    Dim As Single nativeFloat = SDL_SwapFloatBE(beFloat)

    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "大端序16位：0x%04X → 原生序：0x%04X", be16, native16)
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "大端序32位：0x%08X → 原生序：0x%08X", be32, native32)
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "大端序浮点数：%.3f → 原生序：%.3f", beFloat, nativeFloat)

    ' 将原生序数据转换回大端序（用于写入文件/网络）
    Dim As UShort be16_again = SDL_Swap16BE(native16)
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "原生序转回大端序：0x%04X", be16_again)
End Sub

' 字节序转换性能示例
Sub PerformanceTest()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, vbCrLf & "【字节序转换性能测试】")

    Const TEST_COUNT As ULongInt = 100000000 ' 1亿次转换
    Dim As UInteger value = &H11223344
    Dim As UInteger result
    Dim As ULongInt startTicks, endTicks

    ' 测试无条件交换
    startTicks = SDL_GetPerformanceCounter()
    For i As ULongInt = 1 To TEST_COUNT
        result = SDL_Swap32(value)
    Next
    endTicks = SDL_GetPerformanceCounter()

    Dim As Double elapsed = (endTicks - startTicks) / SDL_GetPerformanceFrequency()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SDL_Swap32 执行%llu次耗时：%.3f秒 (单次：%.6f微秒)", _
        TEST_COUNT, elapsed, elapsed * 1000000 / TEST_COUNT)

    ' 测试条件交换（LE转原生，小端系统无操作）
    startTicks = SDL_GetPerformanceCounter()
    For i As ULongInt = 1 To TEST_COUNT
        result = SDL_Swap32LE(value)
    Next
    endTicks = SDL_GetPerformanceCounter()

    elapsed = (endTicks - startTicks) / SDL_GetPerformanceFrequency()
    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "SDL_Swap32LE 执行%llu次耗时：%.3f秒 (单次：%.6f微秒)", _
        TEST_COUNT, elapsed, elapsed * 1000000 / TEST_COUNT)
End Sub

' 主程序
Sub Main()
    ' 初始化 SDL
    If (SDL_Init(0) < 0) Then
        SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "SDL 初始化失败：%s", SDL_GetError())
        Exit Sub
    End If

    ' 运行示例
    PrintEndianInfo()
    HandleBigEndianData()
    PerformanceTest()

    ' 清理 SDL
    SDL_Quit()

    SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, vbCrLf & "程序正常退出")
End Sub

' 运行主程序
Main()

核心知识点补充

  1. 字节序基础概念：

    • 小端（LIL_ENDIAN）：低位字节存低地址，高位字节存高地址（x86/x86_64、ARM 主流模式）；
    • 大端（BIG_ENDIAN）：高位字节存低地址，低位字节存高地址（网络协议、部分嵌入式CPU）；
    • 示例：数值 0x12345678 在小端系统中存储为 0x78 0x56 0x34 0x12，大端系统中存储为 0x12 0x34 0x56 0x78。
  2. SDL 字节序函数/宏的使用场景： 函数/宏 适用场景
    SDL_SwapXXX 需强制反转字节序（如手动处理数据）
    SDL_SwapXXXBE 读取大端序数据（文件/网络）转原生序
    SDL_SwapXXXLE 读取小端序数据转原生序
    SDL_BYTEORDER 编译期判断系统原生字节序

  3. 性能优化要点：

    • SDL 的字节序交换函数为内联实现，无函数调用开销；
    • SDL_SwapXXXLE/BE 宏在无需交换时为「空操作」，性能接近直接赋值；
    • 编译器会对频繁调用的字节交换操作做进一步优化（如内联汇编、SIMD）。

  4. 跨平台数据交互规范：

    • 网络协议、二进制文件通常使用大端序（网络字节序）；
    • 读取外部数据时，先用 SDL_SwapXXXBE 转换为系统原生序，处理完成后再用 SDL_SwapXXXBE 转回大端序写入；
    • 避免直接操作字节数组，优先使用 SDL 提供的转换函数，减少出错概率。

总结

  1. 核心优势：

    • 统一的跨平台字节序转换接口，无需手动编写字节交换逻辑；
    • 条件转换宏（LE/BE）自动适配系统字节序，无多余开销；
    • 内联实现+编译器优化，保证字节交换的极致性能；
    • 覆盖整数（16/32/64位）和浮点数，满足各类数据转换需求。

  2. 使用建议：

    • 处理外部数据（文件/网络）时，优先使用 SDL_SwapXXXBE/LE 转换为系统原生序；
    • 仅需强制反转字节序时，使用 SDL_SwapXXX；
    • 编译期判断字节序用 SDL_BYTEORDER，运行时无需判断（转换宏已自动处理）；
    • 批量数据转换时，结合 SIMD 进一步提升性能（如 SDL_SIMD 相关接口）。

  3. 关键点回顾：

    • SDL_SwapXXXBE/LE 是处理跨平台数据的核心，自动适配系统字节序；
    • SDL 字节序函数为内联实现，性能接近手写汇编；
    • 网络/二进制文件数据优先使用大端序，通过 SDL_SwapXXXBE 转换后再处理。
0
版权属于： 勇芳
本文链接： http://bbs.yfvb.com/post-317.html
文章声明： 本文版权内容属于《勇芳软件工作室》转载请标明出处
相关推荐
VisualFreeBasic游戏趣味编程_6.3_新圆不和已有圆相交
VisualFreeBasic游戏趣味编程_6.3_新圆不和已有圆相交
 VisualFreeBasic游戏趣味编程_5.5_针的发射与新增
VisualFreeBasic游戏趣味编程_5.5_针的发射与新增
 VisualFreeBasic代码_影音
VisualFreeBasic代码_影音
 VisualFreeBasic控件_WebView Edge浏览器
VisualFreeBasic控件_WebView Edge浏览器

评论一下？

OωO
取消