Trait std::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());为您的类型实现 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);
}通常将 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()
}Required Associated Types§
Required Methods§
Implementors§
1.10.0 · source§impl<'a> IntoIterator for &'a UnixListener
Available on Unix only.
impl<'a> IntoIterator for &'a UnixListener
Available on Unix only.