Macro proc_bitfield::set_bits
set_bits!() { /* proc-macro */ }
Expand description
Modifies a single field in an anonymous bitfield, without creating a bitfield struct.
§Usage example: modifying a bitfield with set_bits!
As for bits!
, the field’s type T
can be specified by prepending T @
to the bit range, or additionally by casting the new value with as T
. However, in this example it can be inferred.
let mut a = 0x1234_u16;
// A single field spanning the entire bitfield, using an unbounded range:
// NOTE: In this case, the bitfield's storage type needs to be specified by appending `as T`
set_bits!(a as u16, .. = 0xFFFF); // Bits 0 to 31
assert_eq!(a, 0xFFFF);
a = 0x1234_u16;
// Multi-bit field, specified using an inclusive range:
set_bits!(a, 0..=3 = 0xF); // Bits 0 to 3
assert_eq!(a, 0x123F);
// Multi-bit field, specified using an exclusive range:
set_bits!(a, 4..8 = 0xF); // Bits 4 to 7
assert_eq!(a, 0x12FF);
// Multi-bit field specified using its start bit and length:
set_bits!(a, 8; 4 = 0xF); // Bits 8 to 11
assert_eq!(a, 0x1FFF);
// Single-bit field, specified using an inclusive range:
set_bits!(a, 12..=12 = 1); // Bit 12
assert_eq!(a, 0x1FFF);
// Single-bit field, specified using an exclusive range:
set_bits!(a, 13..14 = 1); // Bit 13
assert_eq!(a, 0x3FFF);
// Single-bit field, specified using its start bit and a length of 1:
set_bits!(a, 14; 1 = 1); // Bit 14
assert_eq!(a, 0x7FFF);
// Single-bit boolean flag, specified using a single bit position:
set_bits!(a, 15 = true); // Bit 15
assert_eq!(a, 0xFFFF);