fill

Provides the Fill trait, an alternative to Extend for finite containers.

Usage

The official recommendation for the Extend trait is to simulate pushing all items from the iterator, panicking if a resource limit is exceeded. Instead of looping over all items the implementors of Fill should only pull items from the iterator while space is available. For example, an option can be viewed as a collection with a capacity of one. One can fill it with the first item of an iterator if it is empty.

use fill::Fill;
let mut memory = None;

memory.fill(42..);
assert_eq!(memory, Some(42));