Struct ExampleBitfield

Source

pub struct ExampleBitfield(/* private fields */);

Available on trace_macros only.

Expand description

An example bitfield type.

This type was generated by the following bitfield! macro invocation:

use crate::{
   bitfield,
   example::{AnotherTestEnum, TestEnum},
};

bitfield! {
   /// An example bitfield type.
   ///
   /// This type was generated by the following [`bitfield!`]
   /// macro invocation:
   /// ```
   #[doc = include_str!("example_bitfield.rs")]
   /// ```
   #[derive(PartialEq, Eq, Hash)]
   pub struct ExampleBitfield<u64> {
       /// Six bits of arbitrary meaning.
       pub const SOME_BITS = 6;

       /// A bit flag.
       ///
       /// This is `true` if foo is enabled. What that means is left
       /// as an exercise to the reader.
       pub const FOO_ENABLED: bool;

       /// Another bit flag.
       ///
       /// This is `true` if bar is enabled. What that means is left
       /// as an exercise to the reader.
       pub const BAR_ENABLED: bool;

       /// These bits are reserved and should always be 0.
       const _RESERVED_1 = 2;

       /// An enum value
       pub const TEST_ENUM: TestEnum;

       const _RESERVED_BITS = 4;

       /// Another enum.
       pub const ANOTHER_ENUM: AnotherTestEnum;

       /// An 8-bit signed integer value.
       ///
       /// Who knows what this means.
       pub const A_BYTE: i8;

       /// `..` can be used to create a packing spec for all the remaining
       /// bits in a bitfield.
       pub const REST = ..;
   }
}

Implementations§

Source §

impl ExampleBitfield

Source

pub const SOME_BITS: Pack64<u64, Self>

Six bits of arbitrary meaning.

Source

pub const FOO_ENABLED: Pack64<bool, Self>

A bit flag.

This is true if foo is enabled. What that means is left as an exercise to the reader.

Source

pub const BAR_ENABLED: Pack64<bool, Self>

Another bit flag.

This is true if bar is enabled. What that means is left as an exercise to the reader.

Source

pub const TEST_ENUM: Pack64<TestEnum, Self>

An enum value

Source

pub const ANOTHER_ENUM: Pack64<AnotherTestEnum, Self>

Another enum.

Source

pub const A_BYTE: Pack64<i8, Self>

An 8-bit signed integer value.

Who knows what this means.

Source

pub const REST: Pack64<u64, Self>

.. can be used to create a packing spec for all the remaining bits in a bitfield.

Source

pub const fn from_bits(bits: u64) -> Self

Constructs a new instance of Self from the provided raw bits.

Source

pub const fn new() -> Self

Constructs a new instance of Self with all bits set to 0.

Source

pub const fn bits(self) -> u64

Returns the raw bit representatiion of self as an integer.

Source

pub fn with<T>(self, field: Pack64<T, Self>, value: T) -> Self
where T: FromBits<u64>,

Packs the bit representation of value into self at the bit range designated by field, returning a new bitfield.

Source

pub fn set<T>(&mut self, field: Pack64<T, Self>, value: T) -> &mut Self
where T: FromBits<u64>,

Packs the bit representation of value into self at the range designated by field, mutating self in place.

Source

pub fn get<T>(self, field: Pack64<T, Self>) -> T
where T: FromBits<u64>,

Unpacks the bit range represented by field from self, and converts it into a T-typed value.

§Panics

This method panics if self does not contain a valid bit pattern for a T-typed value, as determined by T’s FromBits::try_from_bits implementation.

Source

pub fn try_get<T>(self, field: Pack64<T, Self>) -> Result<T, T::Error>
where T: FromBits<u64>,

Unpacks the bit range represented by field from self and attempts to convert it into a T-typed value.

§Returns

Ok(T) if a T-typed value could be constructed from the bits in src
Err(T::Error) if src does not contain a valid bit pattern for a T-typed value, as determined by T’s [FromBits::try_from_bits implementation.

Source

pub fn assert_valid()

Asserts that all the packing specs for this type are valid.

This is intended to be used in unit tests.

Source

pub fn display_ascii(&self) -> impl Display

Returns a value that formats this bitfield in a multi-line format, using only ASCII characters.

This is equivalent to formatting this bitfield using a {} display specifier, but will never use Unicode box-drawing characters, even when an upstream formatter uses the {:#} fmt::Display specifier. This is intended for use on platforms where Unicode box drawing characters are never available.

Source

pub fn display_unicode(&self) -> impl Display

Returns a value that formats this bitfield in a multi-line format, always using Unicode box-drawing characters.

This is equivalent to formatting this bitfield using a {:#} format specifier, but will always use Unicode box-drawing characters, even when an upstream formatter uses the {} fmt::Display specifier.