Package com.luciad.util.collections
Class TLcdIntArrayList
- All Implemented Interfaces:
ILcdIntList
,ILcdCloneable
,Cloneable
,Iterable<Integer>
,Collection<Integer>
,List<Integer>
,SequencedCollection<Integer>
Array-based implementation of
ILcdIntList
.- Since:
- 9.0
-
Field Summary
Fields inherited from class java.util.AbstractList
modCount
-
Constructor Summary
ConstructorDescriptionCreates a new, emptyTLcdIntArrayList
.TLcdIntArrayList
(int aInitialCapacity) Creates a new, emptyTLcdIntArrayList
with the specified initial capacity. -
Method Summary
Modifier and TypeMethodDescriptionvoid
boolean
addAll
(int aIndex, int[] aValues, int aOffset, int aLength) AddsaLength
integer values from the given array to this list, starting from the givenaOffset
boolean
addAll
(int index, Collection<? extends Integer> c) boolean
addAll
(Collection<? extends Integer> c) boolean
addInt
(int aValue) Appends the specified value to the end of this list (optional operation).void
addInt
(int aIndex, int aValue) Inserts the specified value at the specified position in this list (optional operation).int
binarySearch
(int aKey) Performs a binary search on this list.void
clear()
clone()
Creates and returns a copy of this object.boolean
boolean
containsInt
(int aValue) Returnstrue
if this list contains the specified value.void
ensureCapacity
(int minCapacity) Increases the capacity of this list to the specified capacity.boolean
get
(int index) int
getInt
(int aIndex) Returns the value at the specified position in this list.int
hashCode()
int
int
indexOfInt
(int aValue) Returns the index of the first occurrence of the specified value in this list, or -1 if this list does not contain the value.int
lastIndexOf
(Object aO) int
lastIndexOfInt
(int aValue) Returns the index of the last occurrence of the specified value in this list, or -1 if this list does not contain the value.remove
(int index) int
removeInt
(int aIndex) Removes the value at the specified position in this list (optional operation).boolean
removeIntValue
(int aValue) Removes the first occurrence of the specified value from this list, if it is present (optional operation).int
setInt
(int aIndex, int aValue) Replaces the value at the specified position in this list with the specified value (optional operation).int
size()
int[]
Returns an array containing all of the values in this list in proper sequence (from first to last value).int[]
toIntArray
(int[] anArray) 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.toString()
void
Trims the internal data array of this list to match the size of this list.Methods inherited from class java.util.AbstractList
add, iterator, listIterator, listIterator, removeRange, subList
Methods inherited from class java.util.AbstractCollection
containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream, toArray
Methods inherited from interface com.luciad.util.collections.ILcdIntList
addAll, addAll, addAll
Methods inherited from interface java.util.List
add, addFirst, addLast, containsAll, getFirst, getLast, isEmpty, iterator, listIterator, listIterator, remove, removeAll, removeFirst, removeLast, replaceAll, retainAll, reversed, sort, spliterator, subList, toArray, toArray
-
Constructor Details
-
TLcdIntArrayList
public TLcdIntArrayList()Creates a new, emptyTLcdIntArrayList
. -
TLcdIntArrayList
public TLcdIntArrayList(int aInitialCapacity) Creates a new, emptyTLcdIntArrayList
with the specified initial capacity.- Parameters:
aInitialCapacity
- the initial capacity of this list.
-
-
Method Details
-
size
public int size()- Specified by:
size
in interfaceCollection<Integer>
- Specified by:
size
in interfaceList<Integer>
- Specified by:
size
in classAbstractCollection<Integer>
-
get
-
set
-
add
-
addAll
- Specified by:
addAll
in interfaceCollection<Integer>
- Specified by:
addAll
in interfaceList<Integer>
- Overrides:
addAll
in classAbstractCollection<Integer>
-
addAll
-
addAll
public boolean addAll(int aIndex, int[] aValues, int aOffset, int aLength) Description copied from interface:ILcdIntList
AddsaLength
integer values from the given array to this list, starting from the givenaOffset
- Specified by:
addAll
in interfaceILcdIntList
- 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 listaOffset
- The offset inaValues
from where to start copying the integer valuesaLength
- The number of integer values to copy fromaValues
to this list.- Returns:
- Whether this list was modified as a result of this call.
-
remove
-
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 interfaceILcdIntList
- 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 interfaceILcdIntList
- Parameters:
aIndex
- index of the value to replaceaValue
- 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 interfaceILcdIntList
- 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 interfaceILcdIntList
- Parameters:
aIndex
- index at which the specified value is to be insertedaValue
- 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. Returnstrue
if this list contained the specified value (or equivalently, if this list changed as a result of the call).- Specified by:
removeIntValue
in interfaceILcdIntList
- 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 interfaceILcdIntList
- 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 interfaceILcdIntList
- 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 interfaceILcdIntList
- 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 interfaceCollection<Integer>
- Specified by:
clear
in interfaceList<Integer>
- Overrides:
clear
in classAbstractList<Integer>
-
binarySearch
public int binarySearch(int aKey) Performs a binary search on this list. It behaves exactly likeCollections.binarySearch(List, Object)
. The list must be sorted into ascending order according to the natural ordering of its elements (as by theCollections.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
Description copied from interface:ILcdIntList
Creates and returns a copy of this object.- Specified by:
clone
in interfaceILcdCloneable
- Specified by:
clone
in interfaceILcdIntList
- Overrides:
clone
in classObject
- 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
-
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 interfaceILcdIntList
- 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
- Specified by:
lastIndexOf
in interfaceList<Integer>
- Overrides:
lastIndexOf
in classAbstractList<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 interfaceILcdIntList
- 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
Returnstrue
if this list contains the specified value.- Specified by:
containsInt
in interfaceILcdIntList
- Parameters:
aValue
- value whose presence in this list is to be tested- Returns:
true
if this list contains the specified value
-
contains
- Specified by:
contains
in interfaceCollection<Integer>
- Specified by:
contains
in interfaceList<Integer>
- Overrides:
contains
in classAbstractCollection<Integer>
-
equals
- Specified by:
equals
in interfaceCollection<Integer>
- Specified by:
equals
in interfaceList<Integer>
- Overrides:
equals
in classAbstractList<Integer>
-
hashCode
public int hashCode()- Specified by:
hashCode
in interfaceCollection<Integer>
- Specified by:
hashCode
in interfaceList<Integer>
- Overrides:
hashCode
in classAbstractList<Integer>
-
toString
- Overrides:
toString
in classAbstractCollection<Integer>
-