Struct bitvec::index::BitPos

#[repr(transparent)]
pub struct BitPos<R = usize> where
    R: BitRegister,  { /* fields omitted */ }

Bit Position

This is a position counter of a real bit in an R memory element.

Like BitIdx, it is a counter in the ring 0 .. R::BITS. It marks a real bit in memory, and is the shift distance in the expression 1 << n. It can only be produced by applying BitOrder::at to an existing BitIdx produced by bitvec.

Type Parameters

• R: The register element that this position governs.

Validity

Values of this type are required to be in the range 0 .. R::BITS. Any value not less than R::BITS makes the program invalid, and will likely cause either a crash or incorrect memory access.

Construction

This type is publicly constructible, but is only correct to do so within an implementation of BitOrder::at. bitvec will only request its creation through that trait implementation, and has no sites that can publicly accept untrusted values.

Implementations

impl<R> BitPos<R> where
    R: BitRegister, 

pub const MAX: Self

The position value of the most significant bit in an R element.

pub const MIN: Self

The position value of the least significant bit in an R element.

pub fn new(pos: u8) -> Option<Self>

Wraps a counter value as a known-good position within an R register.

Parameters

• pos: The counter value to mark as a position. This must be in the range 0 .. R::BITS.

Returns

This returns Some(pos) when it is in the valid range 0 .. R::BITS, and None when it is not.

pub unsafe fn new_unchecked(pos: u8) -> Self

Wraps a counter value as an assumed-good position within an R register.

Parameters

• value: The counter value to mark as a position. This must be in the range 0 .. R::BITS.

Returns

This unconditionally marks pos as a valid bit-position.

Safety

If the pos value is outside the valid range, then the program is incorrect. Debug builds will panic; release builds do not inspect the value or specify a behavior.

pub fn into_inner(self) -> u8

Removes the position wrapper, leaving the internal counter.

pub fn select(self) -> BitSel<R>

Computes the bit selector corresponding to self.

This is always 1 << self.pos.

pub fn mask(self) -> BitMask<R>

Computes the bit selector for self as an accessor mask.

This is a type-cast over Self::select.

Trait Implementations

impl<R> Binary for BitPos<R> where
    R: BitRegister, 

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Clone> Clone for BitPos<R> where
    R: BitRegister, 

fn clone(&self) -> BitPos<R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R> Debug for BitPos<R> where
    R: BitRegister, 

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Default> Default for BitPos<R> where
    R: BitRegister, 

fn default() -> BitPos<R>

Returns the “default value” for a type.

impl<R> Display for BitPos<R> where
    R: BitRegister, 

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Hash> Hash for BitPos<R> where
    R: BitRegister, 

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<R: Ord> Ord for BitPos<R> where
    R: BitRegister, 

fn cmp(&self, other: &BitPos<R>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<R: PartialEq> PartialEq<BitPos<R>> for BitPos<R> where
    R: BitRegister, 

fn eq(&self, other: &BitPos<R>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &BitPos<R>) -> bool

This method tests for !=.

impl<R: PartialOrd> PartialOrd<BitPos<R>> for BitPos<R> where
    R: BitRegister, 

fn partial_cmp(&self, other: &BitPos<R>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<R: Copy> Copy for BitPos<R> where
    R: BitRegister, 

impl<R: Eq> Eq for BitPos<R> where
    R: BitRegister, 

impl<R> StructuralEq for BitPos<R> where
    R: BitRegister, 

impl<R> StructuralPartialEq for BitPos<R> where
    R: BitRegister,