# 1.12.0[−][src]Trait core::iter::Sum

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

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: Iterator<Item = A>>(iter: I) -> Self`

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

Loading content...

## Implementors

### `impl Sum<Wrapping<i128>> for Wrapping<i128>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<i128>>>(iter: I) -> Wrapping<i128>`[src]

### `impl Sum<Wrapping<i16>> for Wrapping<i16>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<i16>>>(iter: I) -> Wrapping<i16>`[src]

### `impl Sum<Wrapping<i32>> for Wrapping<i32>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<i32>>>(iter: I) -> Wrapping<i32>`[src]

### `impl Sum<Wrapping<i64>> for Wrapping<i64>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<i64>>>(iter: I) -> Wrapping<i64>`[src]

### `impl Sum<Wrapping<i8>> for Wrapping<i8>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<i8>>>(iter: I) -> Wrapping<i8>`[src]

### `impl Sum<Wrapping<isize>> for Wrapping<isize>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<isize>>>(iter: I) -> Wrapping<isize>`[src]

### `impl Sum<Wrapping<u128>> for Wrapping<u128>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<u128>>>(iter: I) -> Wrapping<u128>`[src]

### `impl Sum<Wrapping<u16>> for Wrapping<u16>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<u16>>>(iter: I) -> Wrapping<u16>`[src]

### `impl Sum<Wrapping<u32>> for Wrapping<u32>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<u32>>>(iter: I) -> Wrapping<u32>`[src]

### `impl Sum<Wrapping<u64>> for Wrapping<u64>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<u64>>>(iter: I) -> Wrapping<u64>`[src]

### `impl Sum<Wrapping<u8>> for Wrapping<u8>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<u8>>>(iter: I) -> Wrapping<u8>`[src]

### `impl Sum<Wrapping<usize>> for Wrapping<usize>`[src]

#### `fn sum<I: Iterator<Item = Wrapping<usize>>>(iter: I) -> Wrapping<usize>`[src]

### `impl Sum<Duration> for Duration`[src]

#### `fn sum<I: Iterator<Item = Duration>>(iter: I) -> Duration`[src]

### `impl Sum<f32> for f32`[src]

#### `fn sum<I: Iterator<Item = f32>>(iter: I) -> f32`[src]

### `impl Sum<f64> for f64`[src]

#### `fn sum<I: Iterator<Item = f64>>(iter: I) -> f64`[src]

### `impl Sum<i128> for i128`[src]

#### `fn sum<I: Iterator<Item = i128>>(iter: I) -> i128`[src]

### `impl Sum<i16> for i16`[src]

#### `fn sum<I: Iterator<Item = i16>>(iter: I) -> i16`[src]

### `impl Sum<i32> for i32`[src]

#### `fn sum<I: Iterator<Item = i32>>(iter: I) -> i32`[src]

### `impl Sum<i64> for i64`[src]

#### `fn sum<I: Iterator<Item = i64>>(iter: I) -> i64`[src]

### `impl Sum<i8> for i8`[src]

#### `fn sum<I: Iterator<Item = i8>>(iter: I) -> i8`[src]

### `impl Sum<isize> for isize`[src]

#### `fn sum<I: Iterator<Item = isize>>(iter: I) -> isize`[src]

### `impl Sum<u128> for u128`[src]

#### `fn sum<I: Iterator<Item = u128>>(iter: I) -> u128`[src]

### `impl Sum<u16> for u16`[src]

#### `fn sum<I: Iterator<Item = u16>>(iter: I) -> u16`[src]

### `impl Sum<u32> for u32`[src]

#### `fn sum<I: Iterator<Item = u32>>(iter: I) -> u32`[src]

### `impl Sum<u64> for u64`[src]

#### `fn sum<I: Iterator<Item = u64>>(iter: I) -> u64`[src]

### `impl Sum<u8> for u8`[src]

#### `fn sum<I: Iterator<Item = u8>>(iter: I) -> u8`[src]

### `impl Sum<usize> for usize`[src]

#### `fn sum<I: Iterator<Item = usize>>(iter: I) -> usize`[src]

### `impl<'a> Sum<&'a Wrapping<i128>> for Wrapping<i128>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<i128>>>(iter: I) -> Wrapping<i128>`[src]

### `impl<'a> Sum<&'a Wrapping<i16>> for Wrapping<i16>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<i16>>>(iter: I) -> Wrapping<i16>`[src]

### `impl<'a> Sum<&'a Wrapping<i32>> for Wrapping<i32>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<i32>>>(iter: I) -> Wrapping<i32>`[src]

### `impl<'a> Sum<&'a Wrapping<i64>> for Wrapping<i64>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<i64>>>(iter: I) -> Wrapping<i64>`[src]

### `impl<'a> Sum<&'a Wrapping<i8>> for Wrapping<i8>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<i8>>>(iter: I) -> Wrapping<i8>`[src]

### `impl<'a> Sum<&'a Wrapping<isize>> for Wrapping<isize>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<isize>>>(iter: I) -> Wrapping<isize>`[src]

### `impl<'a> Sum<&'a Wrapping<u128>> for Wrapping<u128>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<u128>>>(iter: I) -> Wrapping<u128>`[src]

### `impl<'a> Sum<&'a Wrapping<u16>> for Wrapping<u16>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<u16>>>(iter: I) -> Wrapping<u16>`[src]

### `impl<'a> Sum<&'a Wrapping<u32>> for Wrapping<u32>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<u32>>>(iter: I) -> Wrapping<u32>`[src]

### `impl<'a> Sum<&'a Wrapping<u64>> for Wrapping<u64>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<u64>>>(iter: I) -> Wrapping<u64>`[src]

### `impl<'a> Sum<&'a Wrapping<u8>> for Wrapping<u8>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<u8>>>(iter: I) -> Wrapping<u8>`[src]

### `impl<'a> Sum<&'a Wrapping<usize>> for Wrapping<usize>`[src]

#### `fn sum<I: Iterator<Item = &'a Wrapping<usize>>>(iter: I) -> Wrapping<usize>`[src]

### `impl<'a> Sum<&'a Duration> for Duration`[src]

#### `fn sum<I: Iterator<Item = &'a Duration>>(iter: I) -> Duration`[src]

### `impl<'a> Sum<&'a f32> for f32`[src]

#### `fn sum<I: Iterator<Item = &'a f32>>(iter: I) -> f32`[src]

### `impl<'a> Sum<&'a f64> for f64`[src]

#### `fn sum<I: Iterator<Item = &'a f64>>(iter: I) -> f64`[src]

### `impl<'a> Sum<&'a i128> for i128`[src]

#### `fn sum<I: Iterator<Item = &'a i128>>(iter: I) -> i128`[src]

### `impl<'a> Sum<&'a i16> for i16`[src]

#### `fn sum<I: Iterator<Item = &'a i16>>(iter: I) -> i16`[src]

### `impl<'a> Sum<&'a i32> for i32`[src]

#### `fn sum<I: Iterator<Item = &'a i32>>(iter: I) -> i32`[src]

### `impl<'a> Sum<&'a i64> for i64`[src]

#### `fn sum<I: Iterator<Item = &'a i64>>(iter: I) -> i64`[src]

### `impl<'a> Sum<&'a i8> for i8`[src]

#### `fn sum<I: Iterator<Item = &'a i8>>(iter: I) -> i8`[src]

### `impl<'a> Sum<&'a isize> for isize`[src]

#### `fn sum<I: Iterator<Item = &'a isize>>(iter: I) -> isize`[src]

### `impl<'a> Sum<&'a u128> for u128`[src]

#### `fn sum<I: Iterator<Item = &'a u128>>(iter: I) -> u128`[src]

### `impl<'a> Sum<&'a u16> for u16`[src]

#### `fn sum<I: Iterator<Item = &'a u16>>(iter: I) -> u16`[src]

### `impl<'a> Sum<&'a u32> for u32`[src]

#### `fn sum<I: Iterator<Item = &'a u32>>(iter: I) -> u32`[src]

### `impl<'a> Sum<&'a u64> for u64`[src]

#### `fn sum<I: Iterator<Item = &'a u64>>(iter: I) -> u64`[src]

### `impl<'a> Sum<&'a u8> for u8`[src]

#### `fn sum<I: Iterator<Item = &'a u8>>(iter: I) -> u8`[src]

### `impl<'a> Sum<&'a usize> for usize`[src]

#### `fn sum<I: Iterator<Item = &'a usize>>(iter: I) -> usize`[src]

### `impl<T, U, E> Sum<Result<U, E>> for Result<T, E> where
T: Sum<U>,` [src]

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

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));Run

Loading content...

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g., `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g., `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g., `str,u8` or `String,struct:Vec,test`)