FusedIterator in std::iter - Rust (original) (raw)

Trait FusedIterator

1.26.0 · Source

pub trait FusedIterator: Iterator { }

Expand description

An iterator that always continues to yield None when exhausted.

Calling next on a fused iterator that has returned None once is guaranteed to return None again. This trait should be implemented by all iterators that behave this way because it allows optimizing Iterator::fuse().

Note: In general, you should not use FusedIterator in generic bounds if you need a fused iterator. Instead, you should just call Iterator::fuse()on the iterator. If the iterator is already fused, the additional Fusewrapper will be a no-op with no performance penalty.