Trait AsMutBits

pub trait AsMutBits<T>
where
    T: BitStore,
{
    // Required methods
    fn as_mut_bits<O>(&mut self) -> &mut BitSlice<T, O>
       where O: BitOrder;
    fn try_as_mut_bits<O>(
        &mut self,
    ) -> Result<&mut BitSlice<T, O>, BitSpanError<T>>
       where O: BitOrder;
}

Mutable Bit View

This trait is an analogue to the AsMut trait, in that it enables any type to provide a view of a mutable bit-slice.

It does not require an AsMut<[T: BitStore]> implementation, but a blanket implementation for all AsMut<[T: BitStore]> is provided. This allows you to choose whether to implement only one of AsMutBits<T> or AsMut<[T]>, and gain a bit-slice view through either choice.

Usage

The .as_mut_bits<_>() method has the same usage patterns as BitView::view_bits_mut.

Notes

You are not forbidden from creating multiple views with different element types to the same region, but doing so is likely to cause inconsistent and surprising behavior.

Refrain from implementing this trait with more than one storage argument unless you are sure that you can uphold the memory region requirements of all of them, and are aware of the behavior conflicts that may arise.

Required Methods

fn as_mut_bits<O>(&mut self) -> &mut BitSlice<T, O>

where O: BitOrder,

Views self as a mutable bit-slice region with the O ordering.

fn try_as_mut_bits<O>(&mut self) -> Result<&mut BitSlice<T, O>, BitSpanError<T>>

where O: BitOrder,

Attempts to view self as a mutable bit-slice region with the O ordering.

This may return an error if self is too long to view as a bit-slice.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl<A, T> AsMutBits<T> for A

where A: AsMut<[T]>, T: BitStore,