proc-bitfield 0.5.3

A crate to expressively declare bitfield-like structs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

## Usage example: modifying a bitfield with `set_bits!`

As for [`bits!`](https://docs.rs/proc-bitfield/latest/proc_bitfield/macro.bits.html), 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.

```rust
# use proc_bitfield::set_bits;
#
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);
```