Trait core::iter::IntoIterator

1.0.0 · source ·

pub trait IntoIterator {
    type Item;
    type IntoIter: Iterator<Item = Self::Item>;

    // Required method
    fn into_iter(self) -> Self::IntoIter;
}

Expand description

转换为 Iterator。

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

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

另请参见：FromIterator。

Examples

基本用法：

let v = [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

Required Associated Types§

source

type Item

被迭代的元素的类型。

source

type IntoIter: Iterator<Item = Self::Item>

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

Required Methods§

source

fn into_iter(self) -> Self::IntoIter

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

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

Examples

基本用法：

let v = [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());