Allows splitting and internally iterating through
Usually used internally by
impl<'a, T: 'a + Send + Sync> UnindexedProducer for BitProducer<'a, T> where[src]
The type of item returned by this producer.
How the splitting is done:
First the highest layer that has at least one set bit is searched.
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.
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.
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
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.
impl<'a, T> RefUnwindSafe for BitProducer<'a, T> where
impl<'a, T> Send for BitProducer<'a, T>
impl<'a, T> Sync for BitProducer<'a, T>
impl<'a, T> Unpin for BitProducer<'a, T>
impl<'a, T> UnwindSafe for BitProducer<'a, T> where
type Error = Infallible
The type returned in the event of a conversion error.