Method frames_mut

libs/error-stack/src/report.rs:626–638

Visits every [`Frame`] of the report mutably, in the same order as [`frames()`]. Returning [`ControlFlow::Break`] from `visitor` stops the traversal early. The break is propagated to the caller, a full traversal returns [`ControlFlow::Continue`]. This is deliberately not an [`Iterator`]: an iterator over `&mut Frame` hands out references whose lifetimes are independent of each other, so a frame

(
        &mut self,
        mut visitor: impl FnMut(&mut Frame) -> ControlFlow<()>,
    )

    ///
    /// [`frames()`]: Self::frames
    pub fn frames_mut(
        &mut self,
        mut visitor: impl FnMut(&mut Frame) -> ControlFlow<()>,
    ) -> ControlFlow<()> {
        // If lending iterators ever land in `core`, this should become one: yielding `&mut Frame`
        // bound to the `next()` borrow is sound and more ergonomic than a visitor.
        let mut stack = vec![self.frames.iter_mut()];
        while let Some(frame) = iter::next(&mut stack) {
            visitor(frame)?;
            stack.push(frame.sources_mut().iter_mut());
        }
        ControlFlow::Continue(())
    }

    /// Creates an iterator of references of type `T` that have been [`attached`](Self::attach) or
    /// that are [`provide`](Error::provide)d by [`Error`] objects.