pub fn spawn<S, E>(
    stream: S,
    executor: &E,
    buffer: usize
) -> SpawnHandle<S::Item, S::Error> where
    S: Stream,
    E: Executor<Execute<S>>, 
Expand description

Spawns a stream onto the instance of Executor provided, executor, returning a handle representing the remote stream.

The stream will be canceled if the SpawnHandle is dropped.

The SpawnHandle returned is a stream that is a proxy for stream itself. When stream has additional items available, then the SpawnHandle will have those same items available.

At most buffer + 1 elements will be buffered at a time. If the buffer is full, then stream will stop progressing until more space is available. This allows the SpawnHandle to exert backpressure on the stream.

Panics

This function will panic if executor is unable spawn a Future containing the entirety of the stream.