Library / Core interfaces / Collections and iteration / ValueIterator
INTERFACEEXTENDS Iterator<T>
ValueIterator
ValueIterator OF T — extends Iterator OF T with by-value navigation. Implemented by the buffer iterators, whose backing storage yields elements by value, not by reference: nextValue() / peekValue() / skipValue() hand back a copy of the element. The value-form mirror of ReferenceIterator.
Methods 3
MODIFY METHOD nextValue() RETURNS | Tmodifies
2.0 pipe-XOR shape: a successful navigation populates value
with a copy of the element at the new cursor; end-of-iteration
populates s with FAILURE.
METHOD peekValue() RETURNS | Treads
peekValue is non-consuming: the value at the current cursor without advancing. Same pipe-XOR shape as nextValue().
MODIFY METHOD skipValue(uint64 n) RETURNS | Tmodifies