如何将C++含位域的union结构体转换为Rust等价实现

Rust 没有内置C风格的匿名联合体、位域原生语法，且C标准中位域的位排布本身属于编译器实现定义行为，以下实现对齐你给出的C代码在主流x86/ARM小端环境、GCC/Clang编译下的实际行为：内存占1字节无额外开销，既支持拆分访问各个位段，也支持直接访问整字节u8值。

方案1：原生安全实现（生产环境推荐） #

使用#[repr(transparent)]标记保证结构体和u8的内存布局完全一致，通过位运算封装各个位段的读写接口，全程无unsafe代码，编译器会将位运算优化为和C位域访问完全等价的机器指令，零运行时开销：

#[repr(transparent)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
struct Mask {
    value: u8,
}

impl Mask {
    // 读取低5位（bit0~bit4）
    #[inline(always)]
    pub fn bit01234(&self) -> u8 {
        self.value & 0x1F
    }

    // 设置低5位，自动截断超出5位范围的输入值
    #[inline(always)]
    pub fn set_bit01234(&mut self, val: u8) {
        self.value = (self.value & 0xE0) | (val & 0x1F);
    }

    // 读取bit5
    #[inline(always)]
    pub fn bit5(&self) -> bool {
        (self.value & 0x20) != 0
    }

    #[inline(always)]
    pub fn set_bit5(&mut self, val: bool) {
        self.value = if val { self.value | 0x20 } else { self.value & !0x20 };
    }

    // 读取bit6
    #[inline(always)]
    pub fn bit6(&self) -> bool {
        (self.value & 0x40) != 0
    }

    #[inline(always)]
    pub fn set_bit6(&mut self, val: bool) {
        self.value = if val { self.value | 0x40 } else { self.value & !0x40 };
    }

    // 读取最高位bit7
    #[inline(always)]
    pub fn bit7(&self) -> bool {
        (self.value & 0x80) != 0
    }

    #[inline(always)]
    pub fn set_bit7(&mut self, val: bool) {
        self.value = if val { self.value | 0x80 } else { self.value & !0x80 };
    }

    // 直接访问整字节值
    #[inline(always)]
    pub fn value(&self) -> u8 {
        self.value
    }

    #[inline(always)]
    pub fn set_value(&mut self, val: u8) {
        self.value = val;
    }
}

如果你需要bit5/bit6/bit7返回数值而非布尔值，只需要把对应getter的返回值改为u8，将读取逻辑改为(self.value & 位掩码) >> 对应位移数即可，比如bit5的数值读取可写为(self.value & 0x20) >> 5。

方案2：C ABI兼容实现（仅FFI场景使用） #

如果你需要和C代码直接做内存交互，要求结构体内存布局和C编译器生成的类型完全匹配，可以使用Rust的union配合#[repr(C)]实现。注意这种方式需要unsafe访问位段成员，且位排布依赖Rust对C位域的兼容实现，跨平台编译时必须做布局校验：

// 注意：Rust对C风格位域的#[repr(C)]支持在较新版本稳定，旧版本编译器可能行为不一致
#[repr(C)]
#[derive(Debug, Clone, Copy)]
struct MaskBits {
    bit01234: u8: 5,
    bit5: u8: 1,
    bit6: u8: 1,
    bit7: u8: 1,
}

#[repr(C)]
#[derive(Debug, Clone, Copy)]
union Mask {
    bits: MaskBits,
    value: u8,
}

非FFI场景下强烈不推荐使用第二种方案，手动位运算封装的方式可控性更强，不会因为编译器版本、目标平台差异出现位序错乱的问题。

内容的提问来源于stack exchange，提问作者The Rizzler