Method next

rust/src/iteration.rs:227–251

(&mut self)

    type Item = (&'a K, &'a V);

    fn next(&mut self) -> Option<Self::Item> {
        // STREAMLINED CONTROL FLOW: Eliminate finished flag, reduce branching
        //
        // Key optimizations:
        // 1. Use current_leaf_ref.is_none() as terminal state (no finished flag)
        // 2. Direct flow with fewer nested conditions
        // 3. Simplified advance_to_next_leaf_direct() with bool return
        // 4. Single exit point pattern

        loop {
            // Direct access - if no leaf, we're done (terminal state)
            let leaf = self.current_leaf_ref?;

            // Try current leaf first
            if let Some(item) = self.try_get_next_item(leaf) {
                return Some(item);
            }

            // Advance to next leaf - if false, we're done
            if !self.advance_to_next_leaf_direct() {
                return None;
            }
            // Continue with next leaf
        }
    }
}

// ============================================================================