Class TextElementIterator

java.lang.Object

com.github.javaparser.printer.lexicalpreservation.TextElementIterator

All Implemented Interfaces:

Iterator<TextElement>, ListIterator<TextElement>

public class TextElementIterator
extends Object
implements ListIterator<TextElement>

Iterator that tracks its current position in a TextElement list.

Unlike standard ListIterator, this class provides direct access to the current index via currentIndex(), which returns the index of the element that was returned by the most recent call to next() or previous().

This iterator is a replacement for the internal ArrayIterator class, with clearer semantics and better naming. It correctly handles bidirectional iteration by maintaining the current index internally.

Since:

3.28.0

Constructor Summary

Constructors

Constructor	Description
TextElementIterator(List<TextElement> elements, int fromIndex)	Creates an iterator starting at the specified index.

Method Summary

Modifier and Type	Method	Description
void	add(TextElement element)
int	currentIndex()	Returns the index of the element that was returned by the most recent call to next() or previous().
boolean	hasNext()
boolean	hasPrevious()
TextElement	next()
int	nextIndex()
TextElement	previous()
int	previousIndex()
void	remove()
void	set(TextElement element)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Iterator

forEachRemaining

Constructor Details

TextElementIterator

public TextElementIterator(List<TextElement> elements,
 int fromIndex)

Creates an iterator starting at the specified index. The current index is initialized to -1, indicating that no element has been read yet.

Parameters:

elements - the list to iterate over

fromIndex - the starting index (cursor position)

Throws:

IndexOutOfBoundsException - if fromIndex is out of range

Method Details

currentIndex

public int currentIndex()

Returns the index of the element that was returned by the most recent call to next() or previous().

This method can be called multiple times without side effects - it will always return the same value until the next call to next(), previous(), or remove().

Important: If neither next() nor previous() has been called yet, or if remove() was called after the last call to next() or previous(), this method returns -1.

Returns:

the index of the current element, or -1 if no element has been read or the current element was removed

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<TextElement>

Specified by:

hasNext in interface ListIterator<TextElement>

next

public TextElement next()

Specified by:

next in interface Iterator<TextElement>

Specified by:

next in interface ListIterator<TextElement>

hasPrevious

public boolean hasPrevious()

Specified by:

hasPrevious in interface ListIterator<TextElement>

previous

public TextElement previous()

Specified by:

previous in interface ListIterator<TextElement>

nextIndex

public int nextIndex()

Specified by:

nextIndex in interface ListIterator<TextElement>

previousIndex

public int previousIndex()

Specified by:

previousIndex in interface ListIterator<TextElement>

remove

public void remove()

Specified by:

remove in interface Iterator<TextElement>

Specified by:

remove in interface ListIterator<TextElement>

set

public void set(TextElement element)

Specified by:

set in interface ListIterator<TextElement>

add

public void add(TextElement element)

Specified by:

add in interface ListIterator<TextElement>