Trait std::iter::IntoIterator1.0.0[−][src]

pub trait IntoIterator {
    type Item;
    type IntoIter: Iterator;
    fn into_iter(self) -> Self::IntoIter;
}
Expand description

转换为 Iterator。

通过为类型实现 IntoIterator，可以定义如何将其转换为迭代器。 这对于描述某种集合的类型很常见。

实现 IntoIterator 的好处之一是您的类型将为 使用 Rust 的 for 循环语法。

另请参见：FromIterator。

Examples

基本用法：

let v = vec![1, 2, 3];
let mut iter = v.into_iter();

assert_eq!(Some(1), iter.next());
assert_eq!(Some(2), iter.next());
assert_eq!(Some(3), iter.next());
assert_eq!(None, iter.next());
Run

为您的类型实现 IntoIterator：

// 一个样本集合，这只是 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);
    }
}

// 我们将实现 IntoIterator
impl IntoIterator for MyCollection {
    type Item = i32;
    type IntoIter = std::vec::IntoIter<Self::Item>;

    fn into_iter(self) -> Self::IntoIter {
        self.0.into_iter()
    }
}

// 现在我们可以进行一个新的集合了...
let mut c = MyCollection::new();

// ... 添加一些东西 ...
c.add(0);
c.add(1);
c.add(2);

// ... 然后将其转换为迭代器：
for (i, n) in c.into_iter().enumerate() {
    assert_eq!(i as i32, n);
}
Run

通常将 IntoIterator 用作 trait bound。只要它仍然是迭代器，就可以更改输入集合类型。 可以通过限制限制来指定其他范围 Item:

fn collect_as_strings<T>(collection: T) -> Vec<String>
where
    T: IntoIterator,
    T::Item: std::fmt::Debug,
{
    collection
        .into_iter()
        .map(|item| format!("{:?}", item))
        .collect()
}
Run

Associated Types

被迭代的元素的类型。

我们将其变成哪种迭代器？

Required methods

从一个值创建一个迭代器。

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

Examples

基本用法：

let v = vec![1, 2, 3];
let mut iter = v.into_iter();

assert_eq!(Some(1), iter.next());
assert_eq!(Some(2), iter.next());
assert_eq!(Some(3), iter.next());
assert_eq!(None, iter.next());
Run

Implementors