The Progress.Collections.ListIterator <T> class represents the type of object returned by the GetIterator() method on a List<T> class and allows the traversal of elements in the list.

This class is FINAL and cannot be extended.

Serializable:

No

Constructor(s)

The class constructor is reserved for system use only.

Super Class

Progress.Lang.Object class

Interfaces

Progress.Collections.IIterator<T> interface

Public Properties

Current property (Iterator) —

Public Methods

MoveNext( ) method (Iterator) Reset( ) method (Iterator)

Notes

  • Progress.Collections.ListIterator<T> iterates over the elements in the natural sequential order of the list (1, 2, 3, …).
  • Progress.Collections.ListIterator<T> does not skip over elements whose values are Unknown (?) or invalid object references (deleted objects). Iteration traverses each of the Unknown (?) or invalid object reference elements, as if they were legitimate entries in the list. If an invalid object reference is encountered, then the iterator sets the Current property to the Unknown (?) value.
  • Progress.Collections.ListIterator<T> does not participate in transactional processing. That is, any changes made to the structure of a ListIterator<T> are not backed out if they occur within a transaction that is backed out.
  • An iterator instance becomes invalid when the associated list has elements added, removed, or replaced after the given ListIterator<T> object is created, as the elements are no longer in the exact original location they occupied when the iterator was created. A new one must be acquired via the GetIterator() method on the list collection.

See also

<T> Generic type reference