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

use std::pin::Pin;

use crate::prelude::*;
use crate::stream::{Stream, Sum};

impl<T, U> Sum<Option<U>> for Option<T>
where
    T: Sum<U>,
{
    #[doc = r#"
        Takes each element in the `Iterator`: if it is a `None`, no further
        elements are taken, and the `None` is returned. Should no `None` occur,
        the sum of all elements is returned.

        # Examples

        This sums up the position of the character 'a' in a vector of strings,
        if a word did not have the character 'a' the operation returns `None`:

        ```
        # fn main() { async_std::task::block_on(async {
        #
        use async_std::prelude::*;
        use async_std::stream;

        let words = stream::from_iter(vec!["have", "a", "great", "day"]);
        let total: Option<usize> = words.map(|w| w.find('a')).sum().await;
        assert_eq!(total, Some(5));
        #
        # }) }
        ```
    "#]
    fn sum<'a, S>(stream: S) -> Pin<Box<dyn Future<Output = Option<T>> + 'a>>
        where S: Stream<Item = Option<U>> + 'a
    {
        Box::pin(async move {
            pin_utils::pin_mut!(stream);

            // Using `scan` here because it is able to stop the stream early
            // if a failure occurs
            let mut found_none = false;
            let out = <T as Sum<U>>::sum(stream
                .scan((), |_, elem| {
                    match elem {
                        Some(elem) => Some(elem),
                        None => {
                            found_none = true;
                            // Stop processing the stream on error
                            None
                        }
                    }
                })).await;

            if found_none {
                None
            } else {
                Some(out)
            }
        })
    }
}