[][src]Struct hibitset::BitProducer

pub struct BitProducer<'a, T: 'a + Send + Sync>(pub BitIter<&'a T>, pub u8);

Allows splitting and internally iterating through BitSet.

Usually used internally by BitParIter.

Trait Implementations

impl<'a, T: Debug + 'a + Send + Sync> Debug for BitProducer<'a, T>[src]

impl<'a, T: 'a + Send + Sync> UnindexedProducer for BitProducer<'a, T> where
    T: BitSetLike
[src]

type Item = u32

The type of item returned by this producer.

fn split(self) -> (Self, Option<Self>)[src]

How the splitting is done:

  1. First the highest layer that has at least one set bit is searched.

  2. If the layer that was found, has only one bit that's set, it's cleared. After that the correct prefix for the cleared bit is figured out and the descending is continued.

  3. If the layer that was found, has more than one bit that's set, a mask is created that splits it's set bits as close to half as possible. After creating the mask the layer is masked by either the mask or it's complement constructing two distinct producers which are then returned.

  4. If there isn't any layers that have more than one set bit, splitting doesn't happen.

The actual iteration is performed by the sequential iterator BitIter which internals are modified by this splitting algorithm.

This splitting strategy should split work evenly if the set bits are distributed close to uniformly random. As the strategy only looks one layer at the time, if there are subtrees that have lots of work and sibling subtrees that have little of work, then it will produce non-optimal splittings.

Auto Trait Implementations

impl<'a, T> Unpin for BitProducer<'a, T>

impl<'a, T> Sync for BitProducer<'a, T>

impl<'a, T> Send for BitProducer<'a, T>

impl<'a, T> UnwindSafe for BitProducer<'a, T> where
    T: RefUnwindSafe

impl<'a, T> RefUnwindSafe for BitProducer<'a, T> where
    T: RefUnwindSafe

Blanket Implementations

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]