如何在 StackVec 上实现 IntoIterator

Question

我正在尝试编写一个类似 Vec 的对象，它具有固定大小以用于堆栈。

这是我正在尝试完成的在线课程的一部分 Assignment 1, Phase 2A。

我在实施 IntoIterator 特征时遇到问题。

代码为StructVec

#![no_std]

pub struct StackVec<'a, T: 'a> {
    storage: &'a mut [T],
    len: usize
}

impl<'a, T: 'a> StackVec<'a, T> {
    pub fn new(storage: &'a mut [T]) -> StackVec<'a, T> {
        StackVec { storage, len: 0 }
    }

    pub fn with_len(storage: &'a mut [T], len: usize) -> StackVec<'a, T> {
        StackVec { storage, len }
    }

    pub fn capacity(&self) -> usize {
        self.storage.len()
    }

    pub fn truncate(&mut self, len: usize) {
        if len < self.len {
            self.len = len;
        }
    }

    pub fn into_slice(self) -> &'a mut [T] {
        &mut self.storage[..self.len]
    }

    pub fn as_slice(&self) -> &[T] {
        &self.storage[..self.len]
    }

    pub fn as_mut_slice(&mut self) -> &mut [T] {
        &mut self.storage[..self.len]
    }

    pub fn len(&self) -> usize {
        self.len
    }

    pub fn is_empty(&self) -> bool {
        self.len == 0
    }

    pub fn is_full(&self) -> bool {
        self.len == self.storage.len()
    }

    pub fn push(&mut self, value: T) -> Result<(), ()> {
        if self.is_full() {
            return Err(());
        }
        self.storage[self.len] = value;
        self.len += 1;
        Ok(())
    }
}

我能够通过返回底层数组的迭代器来实现 IntoIterator 特性：

impl<'a, T: 'a> IntoIterator for StackVec<'a, T> {
    type Item = &'a mut T;
    type IntoIter = core::slice::IterMut<'a, T>;

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

然而，这并不是我真正想要的，因为它将遍历整个数组，而不仅仅是被推到它上面的项目。

我试过从底层数组的数组切片返回一个迭代器，但我被生命周期困住了：

impl<'a, T: 'a> IntoIterator for StackVec<'a, T> {
    type Item = &'a T;
    type IntoIter = core::slice::Iter<'a, T>;

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

编译失败，出现错误

error[E0597]: `self` does not live long enough
   --> src/lib.rs:165:9
    |
165 |         self.as_slice().into_iter()
    |         ^^^^ borrowed value does not live long enough
166 |     }
    |     - borrowed value only lives until here
    |
note: borrowed value must be valid for the lifetime 'a as defined on the impl at 160:1...
   --> src/lib.rs:160:1
    |
160 | / impl<'a, T: 'a> IntoIterator for StackVec<'a, T> {
161 | |     type Item = &'a T;
162 | |     type IntoIter = core::slice::Iter<'a, T>;
163 | |
...   |
166 | |     }
167 | | }
    | |_^

我也试过完全创建一个新的 Iterator 但我又被抓了！

struct Iter<'a, T: 'a> {
    stack_vec: StackVec<'a, T>,
    start: usize,
}

impl<'a, T: 'a> Iterator for Iter<'a, T> {
    type Item = T;

    fn next(&mut self) -> Option<Self::Item> {
        let start = self.start;
        if start < self.stack_vec.len {
            self.start += 1;
            Some(self.stack_vec[start])
        } else {
            None
        }
    }

    fn size_hint(&self) -> (usize, Option<usize>) {
        let size = self.stack_vec.len - self.start;
        (size, Some(size))
    }
}

编译失败，出现错误：

error[E0508]: cannot move out of type `[T]`, a non-copy slice
   --> src/lib.rs:148:18
    |
148 |             Some(self.stack_vec[start])
    |                  ^^^^^^^^^^^^^^^^^^^^^ cannot move out of here

我试过查看做同样事情的板条箱，但要么它们使用了我不能用于此作业的 std 库，要么我不明白如何将它们的代码移植到我的。

https://github.com/bluss/arrayvec

https://github.com/danielhenrymantilla/stackvec-rs/blob/master/src/stackvec/traits/into_iter.rs

我做错了什么？

Answer 1

作为您原始想法的一个相当简单的扩展，您可以使用 take 方法限制迭代器可以 return 的元素数量。这会将您的 IntoIterator 实施变成：


impl<'a, T: 'a> IntoIterator for StackVec<'a, T> {
    type Item = &'a mut T;
    type IntoIter = std::iter::Take<core::slice::IterMut<'a, T>>;

    fn into_iter(self) -> Self::IntoIter {
        self.storage.into_iter().take(self.len)
    }
}

您运行与您实施 IntoIterator 的其他尝试存在问题，因为 into_iter 方法取得了 self 的所有权。这意味着一旦函数退出，您需要确保您已经从 self 中移动或复制了您想要在迭代器中使用的所有内容。由于 as_slice 仅借用，因此您不能 return 从您的函数到切片的迭代器（它借用的数据将被删除）。

impl<'a, T: 'a> IntoIterator for StackVec<'a, T> {
    type Item = &'a T;
    type IntoIter = core::slice::Iter<'a, T>;

    fn into_iter(self) -> Self::IntoIter {
        //       ^ no & or &mut here means this function takes ownership of self
        self.as_slice().into_iter()
    }
}

您仍然可以创建 StackVec 结构的非拥有迭代器，但您不会使用 IntoIterator 来创建它。相反，只需在您的结构上创建一个名为 iter:

的方法

pub fn iter(&self) -> impl Iterator<Item=&T> {
    self.storage.iter().take(self.len)
}

如何在 StackVec 上实现 IntoIterator

How to implement IntoIterator on a StackVec

iterator

lifetime

rust