com.neeve.lang

Interface XStringIterator

All Superinterfaces:

Iterator<String>, XIterator<String>

All Known Implementing Classes:

XStringArrayIterator, XStringSequence

public interface XStringIterator
extends XIterator<String>

A String based XIterator that provide support for copying the next value into an XString.

Since:

3.4

Method Summary

Modifier and Type	Method and Description
void	nextInto(XString to) Copies the next value into the provided XString.

Methods inherited from interface com.neeve.lang.XIterator

toFirst

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, next, remove

Method Detail

nextInto

void nextInto(XString to)

Copies the next value into the provided XString.

This call has the same semantics as Iterator.next() except that the iterator implementation may be able to avoid allocating a String object.

While this method is provided in support of zero garbage iteration it is implementation depend as to whether or not this call is zero garbage.

Throws:

NoSuchElementException - iteration has no more elements.