Trait core::iter::FromIterator

1.0.0 · source ·
pub trait FromIterator<A>: Sized {
    // Required method
    fn from_iter<T: IntoIterator<Item = A>>(iter: T) -> Self;
}
Expand description

Iterator 转换。

通过为类型实现 FromIterator,可以定义如何从迭代器创建它。 这对于描述某种集合的类型很常见。

如果想从迭代器的内容中创建一个集合,则首选 Iterator::collect() 方法。 但是,当您需要指定容器类型时,FromIterator::from_iter() 比使用 turbofish 更具可读性 (例如

::<Vec<_>>()). 有关其使用的更多示例,请参见 Iterator::collect() 文档。

另请参见:IntoIterator

Examples

基本用法:

let five_fives = std::iter::repeat(5).take(5);

let v = Vec::from_iter(five_fives);

assert_eq!(v, vec![5, 5, 5, 5, 5]);
Run

使用 Iterator::collect() 隐式使用 FromIterator

let five_fives = std::iter::repeat(5).take(5);

let v: Vec<i32> = five_fives.collect();

assert_eq!(v, vec![5, 5, 5, 5, 5]);
Run

使用 FromIterator::from_iter() 作为更易读的替代方案 Iterator::collect():

use std::collections::VecDeque;
let first = (0..10).collect::<VecDeque<i32>>();
let second = VecDeque::from_iter(0..10);

assert_eq!(first, second);
Run

为您的类型实现 FromIterator

// 一个样本集合,这只是 Vec<T> 的包装
#[derive(Debug)]
struct MyCollection(Vec<i32>);

// 让我们给它一些方法,以便我们可以创建一个方法并向其中添加一些东西。
impl MyCollection {
    fn new() -> MyCollection {
        MyCollection(Vec::new())
    }

    fn add(&mut self, elem: i32) {
        self.0.push(elem);
    }
}

// 我们将实现 FromIterator
impl FromIterator<i32> for MyCollection {
    fn from_iter<I: IntoIterator<Item=i32>>(iter: I) -> Self {
        let mut c = MyCollection::new();

        for i in iter {
            c.add(i);
        }

        c
    }
}

// 现在我们可以创建一个新的迭代器...
let iter = (0..5).into_iter();

// ... 并用它制作一个 MyCollection
let c = MyCollection::from_iter(iter);

assert_eq!(c.0, vec![0, 1, 2, 3, 4]);

// 也收集作品!

let iter = (0..5).into_iter();
let c: MyCollection = iter.collect();

assert_eq!(c.0, vec![0, 1, 2, 3, 4]);
Run

Required Methods§

source

fn from_iter<T: IntoIterator<Item = A>>(iter: T) -> Self

从迭代器创建一个值。

有关更多信息,请参见 模块级文档

Examples

基本用法:

let five_fives = std::iter::repeat(5).take(5);

let v = Vec::from_iter(five_fives);

assert_eq!(v, vec![5, 5, 5, 5, 5]);
Run

Implementors§

1.23.0 · source§

impl FromIterator<()> for ()

将一个迭代器中的所有 unit 项折叠为一个。

与更高级别的抽象结合使用时,此功能尤其有用,例如收集到仅关心错误的 Result<(), E> 上:

use std::io::*;
let data = vec![1, 2, 3, 4, 5];
let res: Result<()> = data.iter()
    .map(|x| writeln!(stdout(), "{x}"))
    .collect();
assert!(res.is_ok());
Run
source§

impl<A, E, V: FromIterator<A>> FromIterator<Result<A, E>> for Result<V, E>

source§

impl<A, V: FromIterator<A>> FromIterator<Option<A>> for Option<V>