src/libcore/unit.rs

   1 // Copyright 2017 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 use iter::FromIterator;
  12
  13 /// Collapses all unit items from an iterator into one.
  14 ///
  15 /// This is more useful when combined with higher-level abstractions, like
  16 /// collecting to a `Result<(), E>` where you only care about errors:
  17 ///
  18 /// ```
  19 /// use std::io::*;
  20 /// let data = vec![1, 2, 3, 4, 5];
  21 /// let res: Result<()> = data.iter()
  22 ///     .map(|x| writeln!(stdout(), "{}", x))
  23 ///     .collect();
  24 /// assert!(res.is_ok());
  25 /// ```
  26 #[stable(feature = "unit_from_iter", since = "1.23.0")]
  27 impl FromIterator<()> for () {
  28     fn from_iter<I: IntoIterator<Item=()>>(iter: I) -> Self {
  29         iter.into_iter().for_each(|()| {})
  30     }
  31 }