DequeIterator

Traverses borrowed circular storage as readonly element references.

Sn is under heavy development. Reference extracted from this release’s bundled standard library. Public API examples are not an exhaustive compatibility test. Read the matching release guide for tested workflows and limitations. Read the status →

Module std.collections

import std.collections;

Public declaration contracts and authored examples. A page can document several related symbols. Implementation bodies are excluded.

DequeIterator

pub final class DequeIterator<T>

Traverses borrowed circular storage as readonly element references.

The cursor allocates nothing and retains no owner. Next costs O(1); exhaustion is permanent. Any structural owner mutation, move or destruction invalidates the cursor and yielded references. External synchronization is required. T: Exact ring element type.

DequeIterator.Next

pub fn Next() -> T&?

Advances and borrows the next logical ring element. Return: Optional readonly reference, or none after exhaustion. Warning: References never retain storage; owner invalidation rules apply.

Documentation snapshot: October 24, 2026 About versions ↗