futures 0.1.0

An implementation of futures and streams featuring zero allocations, composability, and iterator-like interfaces.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

use std::marker;
use std::any::Any;

use {Task, TaskData, TaskNotifyData, Poll, Future};

/// A combinator which will store some data into task-local storage.
///
/// This combinator is created by the `futures::store` method.
pub struct Store<T: Send + 'static, E> {
    item: Option<T>,
    _marker: marker::PhantomData<fn() -> E>,
}

/// A combinator to store some data into task-local storage.
pub fn store<T, E>(t: T) -> Store<T, E>
    where T: Any + Send + 'static,
          E: Send + 'static,
{
    Store { item: Some(t), _marker: marker::PhantomData }
}

impl<T, E> Future for Store<T, E>
    where T: Any + Send + 'static,
          E: Send + 'static,
{
    type Item = TaskData<T>;
    type Error = E;

    fn poll(&mut self, task: &mut Task) -> Poll<TaskData<T>, E> {
        let item = self.item.take().expect("cannot poll Store twice");
        Poll::Ok(task.insert(item))
    }

    fn schedule(&mut self, task: &mut Task) {
        task.notify()
    }
}

/// A combinator which will store some data into task-local storage.
///
/// This combinator is created by the `futures::store` method.
pub struct StoreNotify<T: Send + 'static, E> {
    item: Option<T>,
    _marker: marker::PhantomData<fn() -> E>,
}

/// A combinator to store some data into task-local storage.
pub fn store_notify<T, E>(t: T) -> StoreNotify<T, E>
    where T: Any + Send + Sync + 'static,
          E: Send + 'static,
{
    StoreNotify { item: Some(t), _marker: marker::PhantomData }
}

impl<T, E> Future for StoreNotify<T, E>
    where T: Any + Send + Sync + 'static,
          E: Send + 'static,
{
    type Item = TaskNotifyData<T>;
    type Error = E;

    fn poll(&mut self, task: &mut Task) -> Poll<TaskNotifyData<T>, E> {
        let item = self.item.take().expect("cannot poll Store twice");
        Poll::Ok(task.insert_notify(item))
    }

    fn schedule(&mut self, task: &mut Task) {
        task.notify()
    }
}