Interface IntList

All Superinterfaces:
IntCollection
All Known Implementing Classes:
AbstractIntList, IntArrayList

public interface IntList extends IntCollection
This interface represents lists of int values.
Since:
1.0
See Also:
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    add(int index, int v)
    Adds an element to this list at a specified index.
    boolean
    addAll(int index, IntCollection c)
    Adds all the elements of a specified collection to this list starting at a specified index.
    int
    get(int index)
    Returns the element at a specified position in this list.
    int
    indexOf(int c)
    Returns the index of the first occurance of a specified element in this list.
    int
    indexOf(int index, int c)
    Returns the index of the first occurance of a specified element in this list after or at a specified index.
    int
    lastIndexOf(int c)
    Returns the index of the last occurance of a specified element in this list.
    int
    lastIndexOf(int index, int c)
    Returns the index of the last occurance of a specified element in this list before a specified index.
    Returns a list iterator over this list.
    listIterator(int index)
    Returns a list iterator over this list, starting from a specified index.
    int
    removeElementAt(int index)
    Removes the element at a specified index in this list.
    int
    set(int index, int v)
    Sets a specified element to a new value.
  • Method Details

    • add

      void add(int index, int v)
      Adds an element to this list at a specified index. All elements from the specified index and forward are pushed to their successor's indices.
      Parameters:
      index - the index at which to add the element. If index == size() the element is appended to this list.
      v - the int value to add to this list.
      Throws:
      UnsupportedOperationException - if the operation is not supported by this list.
      IndexOutOfBoundsException - if index does not denote a valid insertion position (valid: 0 - size()).
      See Also:
    • addAll

      boolean addAll(int index, IntCollection c)
      Adds all the elements of a specified collection to this list starting at a specified index. The elements are inserted in the specified collection's iteration order. All elements from the specified index and forward are pushed to their successors' indices (c.size() indices).
      Parameters:
      index - the index at which to insert the elements of the specified collection. If index == size() the elements are appended to this list.
      c - the collection whose elements to add to this list.
      Returns:
      true if this list was modified as a result of adding the elements of c; returns false otherwise.
      Throws:
      UnsupportedOperationException - if the operation is not supported by this list.
      NullPointerException - if c is null.
      IndexOutOfBoundsException - if index does not denote a valid insertion position (valid: 0 - size()).
      See Also:
    • get

      int get(int index)
      Returns the element at a specified position in this list.
      Parameters:
      index - the position of the element to return.
      Returns:
      the element at the specified position.
      Throws:
      IndexOutOfBoundsException - if index does not denote a valid index in this list.
    • indexOf

      int indexOf(int c)
      Returns the index of the first occurance of a specified element in this list.
      Parameters:
      c - the element to find.
      Returns:
      the index of the first occurance of the specified element in this list; returns -1, if the element is not contained in this list.
    • indexOf

      int indexOf(int index, int c)
      Returns the index of the first occurance of a specified element in this list after or at a specified index.
      Parameters:
      c - the element to find.
      index - the index at which to start the search.
      Returns:
      the index of the first occurance of the specified element in this list; returns -1, if the element is not contained in this list.
      Throws:
      IndexOutOfBoundsException - if index does not denote a valid iteration position (valid: 0 - size()).
      Since:
      1.2
    • lastIndexOf

      int lastIndexOf(int c)
      Returns the index of the last occurance of a specified element in this list.
      Parameters:
      c - the element to find.
      Returns:
      the index of the last occurance of the specified element in this list; returns -1, if the element is not contained in this list.
    • lastIndexOf

      int lastIndexOf(int index, int c)
      Returns the index of the last occurance of a specified element in this list before a specified index.
      Parameters:
      c - the element to find.
      index - the index at which to start the search. Note that the element at index is not included in the search.
      Returns:
      the index of the last occurance of the specified element in this list; returns -1, if the element is not contained in this list.
      Throws:
      IndexOutOfBoundsException - if index does not denote a valid iteration position (valid: 0 - size()).
      Since:
      1.2
    • listIterator

      IntListIterator listIterator()
      Returns a list iterator over this list.
      Returns:
      a list iterator over this list.
    • listIterator

      IntListIterator listIterator(int index)
      Returns a list iterator over this list, starting from a specified index.
      Parameters:
      index - the index at which to begin the iteration.
      Returns:
      a list iterator over this list.
      Throws:
      IndexOutOfBoundsException - if index does not denote a valid iteration position (valid: 0 - size()).
    • removeElementAt

      int removeElementAt(int index)
      Removes the element at a specified index in this list. All elements following the removed element are pushed to their predecessor's indices.
      Parameters:
      index - the index of the element to remove.
      Returns:
      the value of the element removed.
      Throws:
      UnsupportedOperationException - if the operation is not supported by this list.
      IndexOutOfBoundsException - if index does not denote a valid element position (valid: 0 - size()-1).
    • set

      int set(int index, int v)
      Sets a specified element to a new value.
      Parameters:
      index - the index of the element whose value to set.
      v - the new value of the specified element.
      Returns:
      the previous value of the element.
      Throws:
      UnsupportedOperationException - if the operation is not supported by this list.
      IndexOutOfBoundsException - if index does not denote a valid element position (valid: 0 - size()-1).