Trait nom::lib::std::iter::Sum

pub trait Sum<A = Self> {
    pub fn sum<I>(iter: I) -> Self
    where
        I: Iterator<Item = A>;
}

[−] Expand description

Trait to represent types that can be created by summing up an iterator.

This trait is used to implement the sum() method on iterators. Types which implement the trait can be generated by the sum() method. Like FromIterator this trait should rarely be called directly and instead interacted with through Iterator::sum().

Required methods

pub fn sum<I>(iter: I) -> Self where
    I: Iterator<Item = A>, [−]

Method which takes an iterator and generates Self from the elements by “summing up” the items.

Implementations on Foreign Types

impl<'a> Sum<&'a u16> for u16

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u16 where
    I: Iterator<Item = &'a u16>, 

impl Sum<Duration> for Duration

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Duration where
    I: Iterator<Item = Duration>, 

impl Sum<Wrapping<i64>> for Wrapping<i64>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i64> where
    I: Iterator<Item = Wrapping<i64>>, 

impl<'a> Sum<&'a Wrapping<i32>> for Wrapping<i32>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i32> where
    I: Iterator<Item = &'a Wrapping<i32>>, 

impl<'a> Sum<&'a Wrapping<i64>> for Wrapping<i64>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i64> where
    I: Iterator<Item = &'a Wrapping<i64>>, 

impl<'a> Sum<&'a i32> for i32

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i32 where
    I: Iterator<Item = &'a i32>, 

impl<'a> Sum<&'a f32> for f32

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> f32 where
    I: Iterator<Item = &'a f32>, 

impl Sum<isize> for isize

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> isize where
    I: Iterator<Item = isize>, 

impl<'a> Sum<&'a Wrapping<isize>> for Wrapping<isize>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<isize> where
    I: Iterator<Item = &'a Wrapping<isize>>, 

impl Sum<u8> for u8

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u8 where
    I: Iterator<Item = u8>, 

impl<'a> Sum<&'a f64> for f64

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> f64 where
    I: Iterator<Item = &'a f64>, 

impl Sum<i64> for i64

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i64 where
    I: Iterator<Item = i64>, 

impl<'a> Sum<&'a isize> for isize

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> isize where
    I: Iterator<Item = &'a isize>, 

impl<'a> Sum<&'a u64> for u64

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u64 where
    I: Iterator<Item = &'a u64>, 

impl Sum<f64> for f64

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> f64 where
    I: Iterator<Item = f64>, 

impl Sum<Wrapping<u8>> for Wrapping<u8>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u8> where
    I: Iterator<Item = Wrapping<u8>>, 

impl<'a> Sum<&'a i16> for i16

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i16 where
    I: Iterator<Item = &'a i16>, 

impl Sum<Wrapping<i16>> for Wrapping<i16>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i16> where
    I: Iterator<Item = Wrapping<i16>>, 

impl Sum<Wrapping<i8>> for Wrapping<i8>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i8> where
    I: Iterator<Item = Wrapping<i8>>, 

impl Sum<Wrapping<u32>> for Wrapping<u32>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u32> where
    I: Iterator<Item = Wrapping<u32>>, 

impl Sum<i16> for i16

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i16 where
    I: Iterator<Item = i16>, 

impl<'a> Sum<&'a u32> for u32

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u32 where
    I: Iterator<Item = &'a u32>, 

impl<'a> Sum<&'a u128> for u128

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u128 where
    I: Iterator<Item = &'a u128>, 

impl<'a> Sum<&'a Wrapping<u32>> for Wrapping<u32>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u32> where
    I: Iterator<Item = &'a Wrapping<u32>>, 

impl<'a> Sum<&'a Wrapping<u64>> for Wrapping<u64>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u64> where
    I: Iterator<Item = &'a Wrapping<u64>>, 

impl Sum<u128> for u128

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u128 where
    I: Iterator<Item = u128>, 

impl Sum<i32> for i32

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i32 where
    I: Iterator<Item = i32>, 

impl<'a> Sum<&'a Wrapping<u16>> for Wrapping<u16>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u16> where
    I: Iterator<Item = &'a Wrapping<u16>>, 

impl Sum<Wrapping<i128>> for Wrapping<i128>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i128> where
    I: Iterator<Item = Wrapping<i128>>, 

impl Sum<Wrapping<u16>> for Wrapping<u16>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u16> where
    I: Iterator<Item = Wrapping<u16>>, 

impl<'a> Sum<&'a Wrapping<u8>> for Wrapping<u8>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u8> where
    I: Iterator<Item = &'a Wrapping<u8>>, 

impl<'a> Sum<&'a Wrapping<usize>> for Wrapping<usize>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<usize> where
    I: Iterator<Item = &'a Wrapping<usize>>, 

impl<'a> Sum<&'a Wrapping<i8>> for Wrapping<i8>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i8> where
    I: Iterator<Item = &'a Wrapping<i8>>, 

impl<'a> Sum<&'a Wrapping<i16>> for Wrapping<i16>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i16> where
    I: Iterator<Item = &'a Wrapping<i16>>, 

impl Sum<i8> for i8

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i8 where
    I: Iterator<Item = i8>, 

impl<'a> Sum<&'a Wrapping<u128>> for Wrapping<u128>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u128> where
    I: Iterator<Item = &'a Wrapping<u128>>, 

impl Sum<Wrapping<usize>> for Wrapping<usize>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<usize> where
    I: Iterator<Item = Wrapping<usize>>, 

impl Sum<Wrapping<u64>> for Wrapping<u64>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u64> where
    I: Iterator<Item = Wrapping<u64>>, 

impl<'a> Sum<&'a u8> for u8

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u8 where
    I: Iterator<Item = &'a u8>, 

impl Sum<u32> for u32

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u32 where
    I: Iterator<Item = u32>, 

impl Sum<i128> for i128

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i128 where
    I: Iterator<Item = i128>, 

impl Sum<Wrapping<u128>> for Wrapping<u128>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<u128> where
    I: Iterator<Item = Wrapping<u128>>, 

impl Sum<f32> for f32

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> f32 where
    I: Iterator<Item = f32>, 

impl<'a> Sum<&'a i8> for i8

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i8 where
    I: Iterator<Item = &'a i8>, 

impl<'a> Sum<&'a i128> for i128

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i128 where
    I: Iterator<Item = &'a i128>, 

impl<'a> Sum<&'a usize> for usize

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> usize where
    I: Iterator<Item = &'a usize>, 

impl Sum<usize> for usize

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> usize where
    I: Iterator<Item = usize>, 

impl<'a> Sum<&'a Duration> for Duration

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Duration where
    I: Iterator<Item = &'a Duration>, 

impl Sum<u64> for u64

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u64 where
    I: Iterator<Item = u64>, 

impl<'a> Sum<&'a i64> for i64

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> i64 where
    I: Iterator<Item = &'a i64>, 

impl<'a> Sum<&'a Wrapping<i128>> for Wrapping<i128>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i128> where
    I: Iterator<Item = &'a Wrapping<i128>>, 

impl Sum<Wrapping<i32>> for Wrapping<i32>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<i32> where
    I: Iterator<Item = Wrapping<i32>>, 

impl Sum<Wrapping<isize>> for Wrapping<isize>

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> Wrapping<isize> where
    I: Iterator<Item = Wrapping<isize>>, 

impl Sum<u16> for u16

[+] Show hidden undocumented items

pub fn sum<I>(iter: I) -> u16 where
    I: Iterator<Item = u16>, 

Implementors

impl<T, U> Sum<Option<U>> for Option<T> where
    T: Sum<U>, 

pub fn sum<I>(iter: I) -> Option<T> where
    I: Iterator<Item = Option<U>>, [−]

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:

let words = vec!["have", "a", "great", "day"];
let total: Option<usize> = words.iter().map(|w| w.find('a')).sum();
assert_eq!(total, Some(5));

impl<T, U, E> Sum<Result<U, E>> for Result<T, E> where
    T: Sum<U>, 

pub fn sum<I>(iter: I) -> Result<T, E> where
    I: Iterator<Item = Result<U, E>>, [−]

Takes each element in the Iterator: if it is an Err, no further elements are taken, and the Err is returned. Should no Err occur, the sum of all elements is returned.

Examples

This sums up every integer in a vector, rejecting the sum if a negative element is encountered:

let v = vec![1, 2];
let res: Result<i32, &'static str> = v.iter().map(|&x: &i32|
    if x < 0 { Err("Negative element found") }
    else { Ok(x) }
).sum();
assert_eq!(res, Ok(3));

impl<N, R: DimName, C: DimName> Sum<Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>> for MatrixMN<N, R, C> where     N: Scalar + ClosedAdd + Zero,     DefaultAllocator: Allocator<N, R, C>,

impl<N, C: Dim> Sum<Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>> for MatrixMN<N, Dynamic, C> where     N: Scalar + ClosedAdd + Zero,     DefaultAllocator: Allocator<N, Dynamic, C>,

impl<'a, N, R: DimName, C: DimName> Sum<&'a Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>> for MatrixMN<N, R, C> where     N: Scalar + ClosedAdd + Zero,     DefaultAllocator: Allocator<N, R, C>,

impl<'a, N, C: Dim> Sum<&'a Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>> for MatrixMN<N, Dynamic, C> where     N: Scalar + ClosedAdd + Zero,     DefaultAllocator: Allocator<N, Dynamic, C>,

impl<T: Num + Clone> Sum<Complex<T>> for Complex<T>

impl<'a, T: 'a + Num + Clone> Sum<&'a Complex<T>> for Complex<T>

impl<T: Integer + Clone> Sum<Ratio<T>> for Ratio<T>

impl<'a, T: Integer + Clone> Sum<&'a Ratio<T>> for Ratio<T>

impl<'a> Sum<&'a U128> for U128

impl Sum<U128> for U128

impl<'a> Sum<&'a U160> for U160

impl Sum<U160> for U160

impl<'a> Sum<&'a U224> for U224

impl Sum<U224> for U224

impl<'a> Sum<&'a U256> for U256

impl Sum<U256> for U256

impl<'a> Sum<&'a U384> for U384

impl Sum<U384> for U384

impl<'a> Sum<&'a U512> for U512

impl Sum<U512> for U512

impl<'a> Sum<&'a U520> for U520

impl Sum<U520> for U520

impl<'a> Sum<&'a U1024> for U1024

impl Sum<U1024> for U1024

impl<'a> Sum<&'a U2048> for U2048

impl Sum<U2048> for U2048

impl<'a> Sum<&'a U4096> for U4096

impl Sum<U4096> for U4096