1.12.0[−][src]Trait prcn_lib::prelude::__std_iter::Sum
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
fn sum<I>(iter: I) -> Self where
I: Iterator<Item = A>,
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 u64> for u64
[src]
impl Sum<Wrapping<u128>> for Wrapping<u128>
[src]
impl<'a> Sum<&'a u8> for u8
[src]
impl Sum<i64> for i64
[src]
impl<'a> Sum<&'a Wrapping<usize>> for Wrapping<usize>
[src]
impl<'a> Sum<&'a i32> for i32
[src]
impl<'a> Sum<&'a usize> for usize
[src]
impl Sum<i32> for i32
[src]
impl Sum<Wrapping<isize>> for Wrapping<isize>
[src]
impl<'a> Sum<&'a i64> for i64
[src]
impl Sum<u8> for u8
[src]
impl Sum<usize> for usize
[src]
impl<T, U> Sum<Option<U>> for Option<T> where
T: Sum<U>,
[src]
T: Sum<U>,
fn sum<I>(iter: I) -> Option<T> where
I: Iterator<Item = Option<U>>,
[src]
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<'a> Sum<&'a Wrapping<u64>> for Wrapping<u64>
[src]
impl Sum<Wrapping<usize>> for Wrapping<usize>
[src]
impl Sum<isize> for isize
[src]
impl Sum<Wrapping<i8>> for Wrapping<i8>
[src]
impl<'a> Sum<&'a isize> for isize
[src]
impl<'a> Sum<&'a f32> for f32
[src]
impl Sum<f32> for f32
[src]
impl<'a> Sum<&'a i128> for i128
[src]
impl<'a> Sum<&'a u128> for u128
[src]
impl<'a> Sum<&'a Wrapping<i128>> for Wrapping<i128>
[src]
impl<'a> Sum<&'a u32> for u32
[src]
impl Sum<u64> for u64
[src]
impl<'a> Sum<&'a Wrapping<i32>> for Wrapping<i32>
[src]
impl Sum<Wrapping<u8>> for Wrapping<u8>
[src]
impl Sum<Wrapping<i32>> for Wrapping<i32>
[src]
impl Sum<i128> for i128
[src]
impl Sum<i8> for i8
[src]
impl Sum<u16> for u16
[src]
impl Sum<Wrapping<u32>> for Wrapping<u32>
[src]
impl<'a> Sum<&'a Wrapping<i64>> for Wrapping<i64>
[src]
impl<'a> Sum<&'a Wrapping<i8>> for Wrapping<i8>
[src]
impl<'a> Sum<&'a f64> for f64
[src]
impl<'a> Sum<&'a i16> for i16
[src]
impl Sum<u32> for u32
[src]
impl<'a> Sum<&'a Wrapping<u8>> for Wrapping<u8>
[src]
impl Sum<f64> for f64
[src]
impl Sum<Wrapping<i16>> for Wrapping<i16>
[src]
impl<'a> Sum<&'a Wrapping<u16>> for Wrapping<u16>
[src]
impl<T, U, E> Sum<Result<U, E>> for Result<T, E> where
T: Sum<U>,
[src]
T: Sum<U>,
fn sum<I>(iter: I) -> Result<T, E> where
I: Iterator<Item = Result<U, E>>,
[src]
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<'a> Sum<&'a Duration> for Duration
[src]
impl<'a> Sum<&'a Wrapping<u32>> for Wrapping<u32>
[src]
impl<'a> Sum<&'a u16> for u16
[src]
impl<'a> Sum<&'a i8> for i8
[src]
impl Sum<Duration> for Duration
[src]
impl Sum<i16> for i16
[src]
impl Sum<u128> for u128
[src]
impl Sum<Wrapping<i64>> for Wrapping<i64>
[src]
impl Sum<Wrapping<u64>> for Wrapping<u64>
[src]
impl<'a> Sum<&'a Wrapping<i16>> for Wrapping<i16>
[src]
impl<'a> Sum<&'a Wrapping<u128>> for Wrapping<u128>
[src]
impl Sum<Wrapping<u16>> for Wrapping<u16>
[src]
impl<'a> Sum<&'a Wrapping<isize>> for Wrapping<isize>
[src]
impl Sum<Wrapping<i128>> for Wrapping<i128>
[src]
impl<T> Sum<Complex<T>> for Complex<T> where
T: Clone + Num,
[src]
T: Clone + Num,
impl<'a, T> Sum<&'a Complex<T>> for Complex<T> where
T: 'a + Clone + Num,
[src]
T: 'a + Clone + Num,
impl<T> Sum<Ratio<T>> for Ratio<T> where
T: Clone + Integer,
[src]
T: Clone + Integer,
impl<'a, T> Sum<&'a Ratio<T>> for Ratio<T> where
T: Clone + Integer,
[src]
T: Clone + Integer,
impl<K, V> Sum<OrdMap<K, V>> for OrdMap<K, V> where
K: Ord + Clone,
V: Clone,
[src]
K: Ord + Clone,
V: Clone,
impl<K, V, S> Sum<HashMap<K, V, S>> for HashMap<K, V, S> where
K: Hash + Eq + Clone,
S: BuildHasher + Default,
V: Clone,
[src]
K: Hash + Eq + Clone,
S: BuildHasher + Default,
V: Clone,
impl<A> Sum<Vector<A>> for Vector<A> where
A: Clone,
[src]
A: Clone,
impl<A> Sum<OrdSet<A>> for OrdSet<A> where
A: Clone + Ord,
[src]
A: Clone + Ord,
impl<A, S> Sum<HashSet<A, S>> for HashSet<A, S> where
A: Hash + Eq + Clone,
S: BuildHasher + Default,
[src]
A: Hash + Eq + Clone,
S: BuildHasher + Default,
impl<N, R, C> Sum<Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>> for Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer> where
C: DimName,
N: Scalar + ClosedAdd<N> + Zero,
R: DimName,
DefaultAllocator: Allocator<N, R, C>,
[src]
C: DimName,
N: Scalar + ClosedAdd<N> + Zero,
R: DimName,
DefaultAllocator: Allocator<N, R, C>,
fn sum<I>(
iter: I
) -> Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer> where
I: Iterator<Item = Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>>,
[src]
iter: I
) -> Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer> where
I: Iterator<Item = Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>>,
impl<'a, N, R, C> Sum<&'a Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>> for Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer> where
C: DimName,
N: Scalar + ClosedAdd<N> + Zero,
R: DimName,
DefaultAllocator: Allocator<N, R, C>,
[src]
C: DimName,
N: Scalar + ClosedAdd<N> + Zero,
R: DimName,
DefaultAllocator: Allocator<N, R, C>,
fn sum<I>(
iter: I
) -> Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer> where
I: Iterator<Item = &'a Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>>,
[src]
iter: I
) -> Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer> where
I: Iterator<Item = &'a Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>>,
impl<'a, N, C> Sum<&'a Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>> for Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer> where
C: Dim,
N: Scalar + ClosedAdd<N> + Zero,
DefaultAllocator: Allocator<N, Dynamic, C>,
[src]
C: Dim,
N: Scalar + ClosedAdd<N> + Zero,
DefaultAllocator: Allocator<N, Dynamic, C>,
fn sum<I>(
iter: I
) -> Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer> where
I: Iterator<Item = &'a Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>>,
[src]
iter: I
) -> Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer> where
I: Iterator<Item = &'a Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>>,
impl<N, C> Sum<Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>> for Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer> where
C: Dim,
N: Scalar + ClosedAdd<N> + Zero,
DefaultAllocator: Allocator<N, Dynamic, C>,
[src]
C: Dim,
N: Scalar + ClosedAdd<N> + Zero,
DefaultAllocator: Allocator<N, Dynamic, C>,
fn sum<I>(
iter: I
) -> Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer> where
I: Iterator<Item = Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>>,
[src]
iter: I
) -> Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer> where
I: Iterator<Item = Matrix<N, Dynamic, C, <DefaultAllocator as Allocator<N, Dynamic, C>>::Buffer>>,
Example
assert_eq!(vec![DVector::repeat(3, 1.0f64), DVector::repeat(3, 1.0f64), DVector::repeat(3, 1.0f64)].into_iter().sum::<DVector<f64>>(), DVector::repeat(3, 1.0f64) + DVector::repeat(3, 1.0f64) + DVector::repeat(3, 1.0f64));
Panics
Panics if the iterator is empty:
iter::empty::<DMatrix<f64>>().sum::<DMatrix<f64>>(); // panics!
Implementors
impl<T> Sum<T> for BigInt where
BigInt: Add<T>,
<BigInt as Add<T>>::Output == BigInt,
[src]
BigInt: Add<T>,
<BigInt as Add<T>>::Output == BigInt,
impl<T> Sum<T> for BigUint where
BigUint: Add<T>,
<BigUint as Add<T>>::Output == BigUint,
[src]
BigUint: Add<T>,
<BigUint as Add<T>>::Output == BigUint,