Struct BitSet 

pub struct BitSet<'a> { /* private fields */ }

Compact bit array overlaid on a byte slice.

• O(1) get/set/clear/toggle per bit
• No overhead – 1 bit per flag
• Used for feature flags, user permission masks, state bitfields

Implementations

impl<'a> BitSet<'a>

pub fn from_bytes(data: &'a mut [u8]) -> Self

Overlay a BitSet on a mutable byte slice.

pub fn capacity(&self) -> usize

Number of bits available.

pub fn get(&self, index: usize) -> Result<bool, ProgramError>

Get a bit by index.

pub fn set(&mut self, index: usize) -> Result<(), ProgramError>

Set a bit to 1.

pub fn clear(&mut self, index: usize) -> Result<(), ProgramError>

Clear a bit to 0.

pub fn toggle(&mut self, index: usize) -> Result<(), ProgramError>

Toggle a bit.

pub fn count_ones(&self) -> usize

Count the number of set bits (popcount).

pub fn count_zeros(&self) -> usize

Count the number of clear bits.

pub fn check_flags( &self, byte_offset: usize, required: u8, ) -> Result<(), ProgramError>

Check if ALL bits in a mask are set (starting at byte offset).

pub fn check_any_flag( &self, byte_offset: usize, any_of: u8, ) -> Result<(), ProgramError>

Check if ANY bit in a mask is set.

pub const fn required_bytes(num_bits: usize) -> usize

Compute the byte size needed for a BitSet with the given number of bits.