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

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

转换为 Iterator。

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

实现 IntoIterator 的好处之一是您的类型将为 work with Rust’s for loop syntax。

也可以看看: 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

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

有关更多信息，请参见 module-level documentation。

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

返回可能包含的值上的消耗迭代器。

Examples

let x = Some("string");
let v: Vec<&str> = x.into_iter().collect();
assert_eq!(v, ["string"]);

let x = None;
let v: Vec<&str> = x.into_iter().collect();
assert!(v.is_empty());
Run

返回可能包含的值上的消耗迭代器。

如果结果为 Result::Ok，则迭代器将产生一个值，否则将不产生任何值。

Examples

基本用法:

let x: Result<u32, &str> = Ok(5);
let v: Vec<u32> = x.into_iter().collect();
assert_eq!(v, [5]);

let x: Result<u32, &str> = Err("nothing!");
let v: Vec<u32> = x.into_iter().collect();
assert_eq!(v, []);
Run

创建一个消费迭代器，即将每个值移出数组 (从开始到结束)。 除非 T 实现了 Copy，否则调用此数组后不能使用数组，因此整个数组都会被复制。

在调用 .into_iter() 之前，数组具有特殊行为 2021 版 – 有关更多信息，请参见 array 版本部分。