Trait staticstep::IntoIncBy [−][src]
pub trait IntoIncBy<T: Copy + Default + Step>: RangeBounds<T> { fn inc_by<const STEP: usize>(self) -> IncBy<T, STEP>ⓘ; }
Expand description
A subtrait of RangeBounds<T>
where T
is Copy + Default + Step
that turns implementers of it into an instance of IncBy
when
inc_by
is called. Currently, the blanket implementation of this
trait exported from the crate for RangeBounds
is the only possible useful implementation, but
it was decided not to make it a Sealed
trait in case additional methods are added in the
future that would be implementable by end-user code in a meaningfully varied way.
Required methods
Functionally equivalent to what step_by
does when it is
called through a primitive range, but written specifically with primitive ranges in mind such
that it optimizes identically to a while
loop in every case the author of this crate has
examined so far.
Example usage:
// Exclusive, so prints: 'A C E' for i in ('A'..'G').inc_by::<2>() { print!("{} ", i); } // Inclusive, so prints: '0 4 8 12' for i in (0isize..=12isize).inc_by::<4>() { print!("{} ", i); }