Package org.apache.commons.collections.iterators

Class ReverseListIterator

java.lang.Object
org.apache.commons.collections.iterators.ReverseListIterator
All Implemented Interfaces:
Iterator, ListIterator, ResettableIterator, ResettableListIterator
@Deprecated(since="2021-04-30") public class ReverseListIterator extends Object implements ResettableListIterator
Deprecated.
Apache Commons Collections version 3.x is being deprecated from AEMaaCS. The upgraded version 4.4 of Commons Collections is already included as replacement. Customers are advised to upgrade to this version of the library. Please note: the package name was changed to org.apache.commons.collections4. Further note that there are AEM APIs currently exposing the old collections classes; these will be updated in upcoming releases.
Iterates backwards through a List, starting with the last element and continuing to the first. This is useful for looping around a list in reverse order without needing to actually reverse the list.

The first call to next() will return the last element from the list, and so on. The hasNext() method works in concert with the next() method as expected. However, the nextIndex() method returns the correct index in the list, thus it starts high and reduces as the iteration continues. The previous methods work similarly.

Since:
Commons Collections 3.2

  • Constructor Summary

    Constructors
    Constructor
    Description
    ReverseListIterator(List list)
    Deprecated.
    Constructor that wraps a list.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    add(Object obj)
    Deprecated.
    Adds a new element to the list between the next and previous elements.
    boolean
    hasNext()
    Deprecated.
    Checks whether there is another element.
    boolean
    hasPrevious()
    Deprecated.
    Checks whether there is a previous element.
    Object
    next()
    Deprecated.
    Gets the next element.
    int
    nextIndex()
    Deprecated.
    Gets the index of the next element.
    Object
    previous()
    Deprecated.
    Gets the previous element.
    int
    previousIndex()
    Deprecated.
    Gets the index of the previous element.
    void
    remove()
    Deprecated.
    Removes the last returned element.
    void
    reset()
    Deprecated.
    Resets the iterator back to the start (which is the end of the list as this is a reversed iterator)
    void
    set(Object obj)
    Deprecated.
    Replaces the last returned element.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface java.util.Iterator

    forEachRemaining

  • Constructor Details

    • ReverseListIterator

      public ReverseListIterator(List list)
      Deprecated.
      Constructor that wraps a list.
      Parameters:
      list - the list to create a reversed iterator for
      Throws:
      NullPointerException - if the list is null

  • Method Details

    • hasNext

      public boolean hasNext()
      Deprecated.
      Checks whether there is another element.
      Specified by:
      hasNext in interface Iterator
      Specified by:
      hasNext in interface ListIterator
      Returns:
      true if there is another element

    • next

      public Object next()
      Deprecated.
      Gets the next element. The next element is the previous in the list.
      Specified by:
      next in interface Iterator
      Specified by:
      next in interface ListIterator
      Returns:
      the next element in the iterator

    • nextIndex

      public int nextIndex()
      Deprecated.
      Gets the index of the next element.
      Specified by:
      nextIndex in interface ListIterator
      Returns:
      the index of the next element in the iterator

    • hasPrevious

      public boolean hasPrevious()
      Deprecated.
      Checks whether there is a previous element.
      Specified by:
      hasPrevious in interface ListIterator
      Returns:
      true if there is a previous element

    • previous

      public Object previous()
      Deprecated.
      Gets the previous element. The next element is the previous in the list.
      Specified by:
      previous in interface ListIterator
      Returns:
      the previous element in the iterator

    • previousIndex

      public int previousIndex()
      Deprecated.
      Gets the index of the previous element.
      Specified by:
      previousIndex in interface ListIterator
      Returns:
      the index of the previous element in the iterator

    • remove

      public void remove()
      Deprecated.
      Removes the last returned element.
      Specified by:
      remove in interface Iterator
      Specified by:
      remove in interface ListIterator
      Throws:
      UnsupportedOperationException - if the list is unmodifiable
      IllegalStateException - if there is no element to remove

    • set

      public void set(Object obj)
      Deprecated.
      Replaces the last returned element.
      Specified by:
      set in interface ListIterator
      Parameters:
      obj - the object to set
      Throws:
      UnsupportedOperationException - if the list is unmodifiable
      IllegalStateException - if the iterator is not in a valid state for set

    • add

      public void add(Object obj)
      Deprecated.
      Adds a new element to the list between the next and previous elements.
      Specified by:
      add in interface ListIterator
      Parameters:
      obj - the object to add
      Throws:
      UnsupportedOperationException - if the list is unmodifiable
      IllegalStateException - if the iterator is not in a valid state for set

    • reset

      public void reset()
      Deprecated.
      Resets the iterator back to the start (which is the end of the list as this is a reversed iterator)
      Specified by:
      reset in interface ResettableIterator
      Specified by:
      reset in interface ResettableListIterator