[][src]Trait async_std::stream::Extend

pub trait Extend<A> {
    fn stream_extend<'a, T: IntoStream<Item = A> + 'a>(
        &'a mut self,
        stream: T
    ) -> Pin<Box<dyn Future<Output = ()> + 'a>>; }
This is supported on unstable only.

Extend 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::{self, Extend};

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

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

Required methods

Important traits for Pin<P>
fn stream_extend<'a, T: IntoStream<Item = A> + 'a>(
    &'a mut self,
    stream: T
) -> Pin<Box<dyn Future<Output = ()> + 'a>>

This is supported on unstable only.

Extends a collection with the contents of a stream.

Loading content...

Implementations on Foreign Types

impl Extend<()> for ()[src]

impl<T> Extend<T> for Vec<T>[src]

Loading content...

Implementors

Loading content...