Trait otter_api_tests::iter::Extend 1.0.0[−][src]
pub trait Extend<A> { fn extend<T>(&mut self, iter: T)
where
T: IntoIterator<Item = A>; fn extend_one(&mut self, item: A) { ... } fn extend_reserve(&mut self, additional: usize) { ... } }
Expand description
Extend a collection with the contents of an iterator.
Iterators produce a series of values, and collections can also be thought
of as a series of values. The Extend
trait bridges this gap, allowing you
to extend a collection by including the contents of that iterator. When
extending a collection with an already existing key, that entry is updated
or, in the case of collections that permit multiple entries with equal
keys, that entry is inserted.
Examples
Basic usage:
// You can extend a String with some chars: let mut message = String::from("The first three letters are: "); message.extend(&['a', 'b', 'c']); assert_eq!("abc", &message[29..32]);
Implementing Extend
:
// A sample collection, that's just a wrapper over Vec<T> #[derive(Debug)] struct MyCollection(Vec<i32>); // Let's give it some methods so we can create one and add things // to it. impl MyCollection { fn new() -> MyCollection { MyCollection(Vec::new()) } fn add(&mut self, elem: i32) { self.0.push(elem); } } // since MyCollection has a list of i32s, we implement Extend for i32 impl Extend<i32> for MyCollection { // This is a bit simpler with the concrete type signature: we can call // extend on anything which can be turned into an Iterator which gives // us i32s. Because we need i32s to put into MyCollection. fn extend<T: IntoIterator<Item=i32>>(&mut self, iter: T) { // The implementation is very straightforward: loop through the // iterator, and add() each element to ourselves. for elem in iter { self.add(elem); } } } let mut c = MyCollection::new(); c.add(5); c.add(6); c.add(7); // let's extend our collection with three more numbers c.extend(vec![1, 2, 3]); // we've added these elements onto the end assert_eq!("MyCollection([5, 6, 7, 1, 2, 3])", format!("{:?}", c));
Required methods
fn extend<T>(&mut self, iter: T) where
T: IntoIterator<Item = A>,
[src]
fn extend<T>(&mut self, iter: T) where
T: IntoIterator<Item = A>,
[src]Extends a collection with the contents of an iterator.
As this is the only required method for this trait, the trait-level docs contain more details.
Examples
Basic usage:
// You can extend a String with some chars: let mut message = String::from("abc"); message.extend(['d', 'e', 'f'].iter()); assert_eq!("abcdef", &message);
Provided methods
fn extend_one(&mut self, item: A)
[src]
fn extend_one(&mut self, item: A)
[src]extend_one
)Extends a collection with exactly one element.
fn extend_reserve(&mut self, additional: usize)
[src]
fn extend_reserve(&mut self, additional: usize)
[src]extend_one
)Reserves capacity in a collection for the given number of additional elements.
The default implementation does nothing.
Implementations on Foreign Types
extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)Extend implementation that copies elements out of references before pushing them onto the Vec.
This implementation is specialized for slice iterators, where it uses copy_from_slice
to
append the entire slice at once.
extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)impl Extend<Op> for Op
impl Extend<Op> for Op
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = Op>,
impl Extend<EventMask> for EventMask
impl Extend<EventMask> for EventMask
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = EventMask>,
impl Extend<WatchMask> for WatchMask
impl Extend<WatchMask> for WatchMask
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = WatchMask>,
impl<A> Extend<<A as Array>::Item> for SmallVec<A> where
A: Array,
impl<A> Extend<<A as Array>::Item> for SmallVec<A> where
A: Array,
pub fn extend<I>(&mut self, iterable: I) where
I: IntoIterator<Item = <A as Array>::Item>,
impl<'s, T> Extend<T> for SliceVec<'s, T>
impl<'s, T> Extend<T> for SliceVec<'s, T>
pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = T>,
impl<A> Extend<<A as Array>::Item> for ArrayVec<A> where
A: Array,
impl<A> Extend<<A as Array>::Item> for ArrayVec<A> where
A: Array,
pub fn extend<T>(&mut self, iter: T) where
T: IntoIterator<Item = <A as Array>::Item>,
impl<A> Extend<<A as Array>::Item> for TinyVec<A> where
A: Array,
impl<A> Extend<<A as Array>::Item> for TinyVec<A> where
A: Array,
pub fn extend<T>(&mut self, iter: T) where
T: IntoIterator<Item = <A as Array>::Item>,
impl Extend<Transformations> for Transformations
impl Extend<Transformations> for Transformations
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = Transformations>,
impl Extend<FileType> for FileType
impl Extend<FileType> for FileType
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = FileType>,
pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = (usize, V)>,
Extend a HeaderMap
with the contents of another HeaderMap
.
This function expects the yielded items to follow the same structure as
IntoIter
.
Panics
This panics if the first yielded item does not have a HeaderName
.
Examples
let mut map = HeaderMap::new(); map.insert(ACCEPT, "text/plain".parse().unwrap()); map.insert(HOST, "hello.world".parse().unwrap()); let mut extra = HeaderMap::new(); extra.insert(HOST, "foo.bar".parse().unwrap()); extra.insert(COOKIE, "hello".parse().unwrap()); extra.append(COOKIE, "world".parse().unwrap()); map.extend(extra); assert_eq!(map["host"], "foo.bar"); assert_eq!(map["accept"], "text/plain"); assert_eq!(map["cookie"], "hello"); let v = map.get_all("host"); assert_eq!(1, v.iter().count()); let v = map.get_all("cookie"); assert_eq!(2, v.iter().count());
pub fn extend<T>(&mut self, iter: T) where
T: IntoIterator<Item = St>,
impl<Fut> Extend<Fut> for FuturesUnordered<Fut>
impl<Fut> Extend<Fut> for FuturesUnordered<Fut>
pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = Fut>,
pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = Fut>,
Extend the map with all key-value pairs in the iterable.
This is equivalent to calling insert
for each of
them in order, which means that for keys that already existed
in the map, their value is updated but it keeps the existing order.
New keys are inserted in the order they appear in the sequence. If equivalents of a key occur more than once, the last corresponding value prevails.
Inserts all new key-values from the iterator and replaces values with existing keys with new values returned from the iterator.
pub fn extend<T>(&mut self, iter: T) where
T: IntoIterator<Item = (K, V)>,
impl<T, S> Extend<T> for HashSet<T, S> where
T: Eq + Hash,
S: BuildHasher,
impl<T, S> Extend<T> for HashSet<T, S> where
T: Eq + Hash,
S: BuildHasher,
pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = T>,
pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = &'a T>,
Implementors
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = AtFlags>,
impl Extend<FallocateFlags> for FallocateFlags
impl Extend<FallocateFlags> for FallocateFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = FallocateFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = FdFlag>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = OFlag>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = SealFlag>,
impl Extend<SpliceFFlags> for SpliceFFlags
impl Extend<SpliceFFlags> for SpliceFFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = SpliceFFlags>,
impl Extend<DeleteModuleFlags> for DeleteModuleFlags
impl Extend<DeleteModuleFlags> for DeleteModuleFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = DeleteModuleFlags>,
impl Extend<ModuleInitFlags> for ModuleInitFlags
impl Extend<ModuleInitFlags> for ModuleInitFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = ModuleInitFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MntFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MsFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = FdFlag>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MQ_OFlag>,
impl Extend<InterfaceFlags> for InterfaceFlags
impl Extend<InterfaceFlags> for InterfaceFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = InterfaceFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = PollFlags>,
impl Extend<CloneFlags> for CloneFlags
impl Extend<CloneFlags> for CloneFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = CloneFlags>,
impl Extend<EpollCreateFlags> for EpollCreateFlags
impl Extend<EpollCreateFlags> for EpollCreateFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = EpollCreateFlags>,
impl Extend<EpollFlags> for EpollFlags
impl Extend<EpollFlags> for EpollFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = EpollFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = EfdFlags>,
impl Extend<AddWatchFlags> for AddWatchFlags
impl Extend<AddWatchFlags> for AddWatchFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = AddWatchFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = InitFlags>,
impl Extend<MemFdCreateFlag> for MemFdCreateFlag
impl Extend<MemFdCreateFlag> for MemFdCreateFlag
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MemFdCreateFlag>,
impl Extend<MRemapFlags> for MRemapFlags
impl Extend<MRemapFlags> for MRemapFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MRemapFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MapFlags>,
impl Extend<MlockAllFlags> for MlockAllFlags
impl Extend<MlockAllFlags> for MlockAllFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MlockAllFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MsFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = ProtFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = Persona>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = Options>,
impl Extend<QuotaValidFlags> for QuotaValidFlags
impl Extend<QuotaValidFlags> for QuotaValidFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = QuotaValidFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = SaFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = SfdFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = MsgFlags>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = SockFlag>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = Mode>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = SFlag>,
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = FsFlags>,
impl Extend<ControlFlags> for ControlFlags
impl Extend<ControlFlags> for ControlFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = ControlFlags>,
impl Extend<InputFlags> for InputFlags
impl Extend<InputFlags> for InputFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = InputFlags>,
impl Extend<LocalFlags> for LocalFlags
impl Extend<LocalFlags> for LocalFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = LocalFlags>,
impl Extend<OutputFlags> for OutputFlags
impl Extend<OutputFlags> for OutputFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = OutputFlags>,
impl Extend<TimerFlags> for TimerFlags
impl Extend<TimerFlags> for TimerFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = TimerFlags>,
impl Extend<TimerSetTimeFlags> for TimerSetTimeFlags
impl Extend<TimerSetTimeFlags> for TimerSetTimeFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = TimerSetTimeFlags>,
impl Extend<WaitPidFlag> for WaitPidFlag
impl Extend<WaitPidFlag> for WaitPidFlag
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = WaitPidFlag>,
impl Extend<AccessFlags> for AccessFlags
impl Extend<AccessFlags> for AccessFlags
pub fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = AccessFlags>,
pub fn extend<J>(&mut self, iter: J) where
J: IntoIterator<Item = &'a T>,
extend_one
)extend_one
)impl<'a, K, V, S> Extend<(K, &'a V)> for SparseSecondaryMap<K, V, S> where
S: BuildHasher,
K: Key,
V: 'a + Copy,
[src]
impl<'a, K, V, S> Extend<(K, &'a V)> for SparseSecondaryMap<K, V, S> where
S: BuildHasher,
K: Key,
V: 'a + Copy,
[src]extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)pub fn extend<J>(&mut self, iter: J) where
J: IntoIterator<Item = T>,
extend_one
)pub fn extend<I>(&mut self, iter: I) where
I: IntoIterator<Item = (K, V)>,
Inserts all new key-values from the iterator and replaces values with existing keys with new values returned from the iterator.
extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)extend_one
)Extend the ArrayVec
with an iterator.
Panics if extending the vector exceeds its capacity.
Extend the ArrayVec
with an iterator.
Panics if extending the vector exceeds its capacity.