Trait bitvec::view::AsMutBits

source ·
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; }
Expand description

§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§

source

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.

source

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.

Object Safety§

This trait is not object safe.

Implementors§

source§

impl<A, T> AsMutBits<T> for A
where A: AsMut<[T]>, T: BitStore,