Class TLcdIntArrayList

All Implemented Interfaces:
ILcdIntList, ILcdCloneable, Cloneable, Iterable<Integer>, Collection<Integer>, List<Integer>, SequencedCollection<Integer>

public class TLcdIntArrayList extends AbstractList<Integer> implements Cloneable, ILcdIntList
Array-based implementation of ILcdIntList.
Since:
9.0
  • Constructor Details

    • TLcdIntArrayList

      public TLcdIntArrayList()
      Creates a new, empty TLcdIntArrayList.
    • TLcdIntArrayList

      public TLcdIntArrayList(int aInitialCapacity)
      Creates a new, empty TLcdIntArrayList with the specified initial capacity.
      Parameters:
      aInitialCapacity - the initial capacity of this list.
  • Method Details

    • size

      public int size()
      Specified by:
      size in interface Collection<Integer>
      Specified by:
      size in interface List<Integer>
      Specified by:
      size in class AbstractCollection<Integer>
    • get

      public Integer get(int index)
      Specified by:
      get in interface List<Integer>
      Specified by:
      get in class AbstractList<Integer>
    • set

      public Integer set(int index, Integer element)
      Specified by:
      set in interface List<Integer>
      Overrides:
      set in class AbstractList<Integer>
    • add

      public void add(int index, Integer element)
      Specified by:
      add in interface List<Integer>
      Overrides:
      add in class AbstractList<Integer>
    • addAll

      public boolean addAll(Collection<? extends Integer> c)
      Specified by:
      addAll in interface Collection<Integer>
      Specified by:
      addAll in interface List<Integer>
      Overrides:
      addAll in class AbstractCollection<Integer>
    • addAll

      public boolean addAll(int index, Collection<? extends Integer> c)
      Specified by:
      addAll in interface List<Integer>
      Overrides:
      addAll in class AbstractList<Integer>
    • addAll

      public boolean addAll(int aIndex, int[] aValues, int aOffset, int aLength)
      Description copied from interface: ILcdIntList
      Adds aLength integer values from the given array to this list, starting from the given aOffset
      Specified by:
      addAll in interface ILcdIntList
      Parameters:
      aIndex - The position in this list where to start inserting the given integer values.
      aValues - The array containing the integer values to add to this list
      aOffset - The offset in aValues from where to start copying the integer values
      aLength - The number of integer values to copy from aValues to this list.
      Returns:
      Whether this list was modified as a result of this call.
    • remove

      public Integer remove(int index)
      Specified by:
      remove in interface List<Integer>
      Overrides:
      remove in class AbstractList<Integer>
    • getInt

      public int getInt(int aIndex)
      Description copied from interface: ILcdIntList
      Returns the value at the specified position in this list.
      Specified by:
      getInt in interface ILcdIntList
      Parameters:
      aIndex - index of the value to return
      Returns:
      the value at the specified position in this list
    • setInt

      public int setInt(int aIndex, int aValue)
      Description copied from interface: ILcdIntList
      Replaces the value at the specified position in this list with the specified value (optional operation).
      Specified by:
      setInt in interface ILcdIntList
      Parameters:
      aIndex - index of the value to replace
      aValue - value to be stored at the specified position
      Returns:
      the value previously at the specified position
    • addInt

      public boolean addInt(int aValue)
      Description copied from interface: ILcdIntList
      Appends the specified value to the end of this list (optional operation).
      Specified by:
      addInt in interface ILcdIntList
      Parameters:
      aValue - value to be appended to this list
      Returns:
      true
    • addInt

      public void addInt(int aIndex, int aValue)
      Description copied from interface: ILcdIntList
      Inserts the specified value at the specified position in this list (optional operation). Shifts the value currently at that position (if any) and any subsequent values to the right (adds one to their indices).
      Specified by:
      addInt in interface ILcdIntList
      Parameters:
      aIndex - index at which the specified value is to be inserted
      aValue - value to be inserted
    • removeIntValue

      public boolean removeIntValue(int aValue)
      Description copied from interface: ILcdIntList
      Removes the first occurrence of the specified value from this list, if it is present (optional operation). If this list does not contain the value, it is unchanged. Returns true if this list contained the specified value (or equivalently, if this list changed as a result of the call).
      Specified by:
      removeIntValue in interface ILcdIntList
      Parameters:
      aValue - value to be removed from this list, if present
      Returns:
      true if this list contained the specified value
    • removeInt

      public int removeInt(int aIndex)
      Description copied from interface: ILcdIntList
      Removes the value at the specified position in this list (optional operation). Shifts any subsequent values to the left (subtracts one from their indices). Returns the value that was removed from the list.
      Specified by:
      removeInt in interface ILcdIntList
      Parameters:
      aIndex - the index of the value to be removed
      Returns:
      the value previously at the specified position
    • toIntArray

      public int[] toIntArray()
      Description copied from interface: ILcdIntList
      Returns an array containing all of the values in this list in proper sequence (from first to last value). The returned array will be "safe" in that no references to it are maintained by this list. (In other words, this method must allocate a new array even if this list is backed by an array). The caller is thus free to modify the returned array.
      Specified by:
      toIntArray in interface ILcdIntList
      Returns:
      an array containing all of the values in this list in proper sequence
    • toIntArray

      public int[] toIntArray(int[] anArray)
      Description copied from interface: ILcdIntList
      Returns an array containing all of the values in this list in proper sequence (from first to last value); If the list fits in the specified array, t is returned therein. Otherwise, a new array is allocated with the size of this list. If the list fits in the specified array with room to spare (i.e., the array has more values than the list), the value in the array immediately following the end of the list is set to 0. (This is useful in determining the length of the list only if the caller knows that the list does not contain any 0 values.)
      Specified by:
      toIntArray in interface ILcdIntList
      Parameters:
      anArray - the array into which the values of this list are to be stored, if it is big enough; otherwise, a new array is allocated for this purpose.
      Returns:
      an array containing the values of this list
    • clear

      public void clear()
      Specified by:
      clear in interface Collection<Integer>
      Specified by:
      clear in interface List<Integer>
      Overrides:
      clear in class AbstractList<Integer>
    • binarySearch

      public int binarySearch(int aKey)
      Performs a binary search on this list. It behaves exactly like Collections.binarySearch(List, Object).

      The list must be sorted into ascending order according to the natural ordering of its elements (as by the Collections.sort(List) method) prior to making this call. If it is not sorted, the results are undefined. If the list contains multiple elements equal to the specified object, there is no guarantee which one will be found.

      Parameters:
      aKey - the value to search
      Returns:
      the index as defined on Collections.binarySearch(List, Object)
    • clone

      public TLcdIntArrayList clone()
      Description copied from interface: ILcdIntList
      Creates and returns a copy of this object.
      Specified by:
      clone in interface ILcdCloneable
      Specified by:
      clone in interface ILcdIntList
      Overrides:
      clone in class Object
      Returns:
      a copy of this object.
      See Also:
    • ensureCapacity

      public void ensureCapacity(int minCapacity)
      Increases the capacity of this list to the specified capacity. This method has no effect if the specified capacity is smaller than the current capacity.
      Parameters:
      minCapacity - the new capacity for this list.
    • trimToSize

      public void trimToSize()
      Trims the internal data array of this list to match the size of this list.
    • indexOf

      public int indexOf(Object aO)
      Specified by:
      indexOf in interface List<Integer>
      Overrides:
      indexOf in class AbstractList<Integer>
    • indexOfInt

      public int indexOfInt(int aValue)
      Description copied from interface: ILcdIntList
      Returns the index of the first occurrence of the specified value in this list, or -1 if this list does not contain the value.
      Specified by:
      indexOfInt in interface ILcdIntList
      Parameters:
      aValue - value to search for
      Returns:
      the index of the first occurrence of the specified value in this list, or -1 if this list does not contain the value
    • lastIndexOf

      public int lastIndexOf(Object aO)
      Specified by:
      lastIndexOf in interface List<Integer>
      Overrides:
      lastIndexOf in class AbstractList<Integer>
    • lastIndexOfInt

      public int lastIndexOfInt(int aValue)
      Description copied from interface: ILcdIntList
      Returns the index of the last occurrence of the specified value in this list, or -1 if this list does not contain the value.
      Specified by:
      lastIndexOfInt in interface ILcdIntList
      Parameters:
      aValue - value to search for
      Returns:
      the index of the last occurrence of the specified value in this list, or -1 if this list does not contain the value
    • containsInt

      public boolean containsInt(int aValue)
      Description copied from interface: ILcdIntList
      Returns true if this list contains the specified value.
      Specified by:
      containsInt in interface ILcdIntList
      Parameters:
      aValue - value whose presence in this list is to be tested
      Returns:
      true if this list contains the specified value
    • contains

      public boolean contains(Object aO)
      Specified by:
      contains in interface Collection<Integer>
      Specified by:
      contains in interface List<Integer>
      Overrides:
      contains in class AbstractCollection<Integer>
    • equals

      public boolean equals(Object o)
      Specified by:
      equals in interface Collection<Integer>
      Specified by:
      equals in interface List<Integer>
      Overrides:
      equals in class AbstractList<Integer>
    • hashCode

      public int hashCode()
      Specified by:
      hashCode in interface Collection<Integer>
      Specified by:
      hashCode in interface List<Integer>
      Overrides:
      hashCode in class AbstractList<Integer>
    • toString

      public String toString()
      Overrides:
      toString in class AbstractCollection<Integer>