[][src]Function async_std::stream::extend

pub async fn extend<'a, '_, C, A, T>(collection: &'_ mut C, stream: T) where
    C: Extend<A>,
    A: 'a,
    T: IntoStream<Item = A> + 'a, 

Extends a collection with the contents of a stream.

Streams produce a series of values asynchronously, and collections can also be thought of as a series of values. The Extend trait bridges this gap, allowing you to extend a collection asynchronously by including the contents of that stream. 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

use async_std::prelude::*;
use async_std::stream;

let mut v: Vec<usize> = vec![1, 2];
let s = stream::repeat(3usize).take(3);
stream::extend(&mut v, s).await;

assert_eq!(v, vec![1, 2, 3, 3, 3]);