com.luciad.util.collections

LuciadLightspeedClass TLcdLongArrayList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<Long>

com.luciad.util.collections.TLcdLongArrayList

All Implemented Interfaces:

ILcdLongList, ILcdCloneable, Cloneable, Iterable<Long>, Collection<Long>, List<Long>

public class TLcdLongArrayList
extends AbstractList<Long>
implements Cloneable, ILcdLongList

Array-based implementation of ILcdLongList.

Since:

9.0

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
TLcdLongArrayList() Creates a new, empty TLcdLongArrayList.
TLcdLongArrayList(int aInitialCapacity) Creates a new, empty TLcdLongArrayList with the specified initial capacity.

Method Summary

Modifier and Type	Method and Description
void	add(int index, Long element)
boolean	addAll(Collection<? extends Long> c)
boolean	addAll(int index, Collection<? extends Long> c)
boolean	addAll(int aIndex, long[] aValues, int aOffset, int aLength) Adds aLength boolean values from the given array to this list, starting from the given aOffset
void	addLong(int aIndex, long aValue) Inserts the specified value at the specified position in this list (optional operation).
boolean	addLong(long aValue) Appends the specified value to the end of this list (optional operation).
int	binarySearch(long aKey) Performs a binary search on this list.
void	clear()
TLcdLongArrayList	clone() Creates and returns a copy of this object.
boolean	contains(Object aO)
boolean	containsLong(long aValue) Returns true if this list contains the specified value.
void	ensureCapacity(int minCapacity) Increases the capacity of this list to the specified capacity.
Long	get(int index)
long	getLong(int aIndex) Returns the value at the specified position in this list.
int	indexOf(Object aO)
int	indexOfLong(long 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	lastIndexOfLong(long 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.
Long	remove(int index)
long	removeLong(int aIndex) Removes the value at the specified position in this list (optional operation).
boolean	removeLong(long aValue) Removes the first occurrence of the specified value from this list, if it is present (optional operation).
Long	set(int index, Long element)
long	setLong(int aIndex, long aValue) Replaces the value at the specified position in this list with the specified value (optional operation).
int	size()
long[]	toLongArray() Returns an array containing all of the values in this list in proper sequence (from first to last value).
long[]	toLongArray(long[] 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.
void	trimToSize() Trims the internal data array of this list to match the size of this list.

Methods inherited from class java.util.AbstractList

add, equals, hashCode, iterator, listIterator, listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection

containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.luciad.util.collections.ILcdLongList

addAll, addAll, addAll

Methods inherited from interface java.util.List

add, containsAll, equals, hashCode, isEmpty, iterator, listIterator, listIterator, remove, removeAll, replaceAll, retainAll, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

TLcdLongArrayList

public TLcdLongArrayList()

Creates a new, empty TLcdLongArrayList.

TLcdLongArrayList

public TLcdLongArrayList(int aInitialCapacity)

Creates a new, empty TLcdLongArrayList with the specified initial capacity.

Parameters:

aInitialCapacity - the initial capacity of this list.

Method Detail

size

public int size()

Specified by:

size in interface Collection<Long>

Specified by:

size in interface List<Long>

Specified by:

size in class AbstractCollection<Long>

get

public Long get(int index)

Specified by:

get in interface List<Long>

Specified by:

get in class AbstractList<Long>

set

public Long set(int index,
                Long element)

Specified by:

set in interface List<Long>

Overrides:

set in class AbstractList<Long>

add

public void add(int index,
                Long element)

Specified by:

add in interface List<Long>

Overrides:

add in class AbstractList<Long>

addAll

public boolean addAll(Collection<? extends Long> c)

Specified by:

addAll in interface Collection<Long>

Specified by:

addAll in interface List<Long>

Overrides:

addAll in class AbstractCollection<Long>

addAll

public boolean addAll(int index,
                      Collection<? extends Long> c)

Specified by:

addAll in interface List<Long>

Overrides:

addAll in class AbstractList<Long>

addAll

public boolean addAll(int aIndex,
                      long[] aValues,
                      int aOffset,
                      int aLength)

Description copied from interface: ILcdLongList

Adds aLength boolean values from the given array to this list, starting from the given aOffset

Specified by:

addAll in interface ILcdLongList

Parameters:

aIndex - The position in this list where to start inserting the given boolean values.

aValues - The array containing the boolean values to add to this list

aOffset - The offset in aValues from where to start copying the boolean values

aLength - The number of boolean values to copy from aValues to this list.

Returns:

Whether this list was modified as a result of this call.

remove

public Long remove(int index)

Specified by:

remove in interface List<Long>

Overrides:

remove in class AbstractList<Long>

getLong

public long getLong(int aIndex)

Description copied from interface: ILcdLongList

Returns the value at the specified position in this list.

Specified by:

getLong in interface ILcdLongList

Parameters:

aIndex - index of the value to return

Returns:

the value at the specified position in this list

setLong

public long setLong(int aIndex,
                    long aValue)

Description copied from interface: ILcdLongList

Replaces the value at the specified position in this list with the specified value (optional operation).

Specified by:

setLong in interface ILcdLongList

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

addLong

public boolean addLong(long aValue)

Description copied from interface: ILcdLongList

Appends the specified value to the end of this list (optional operation).

Specified by:

addLong in interface ILcdLongList

Parameters:

aValue - value to be appended to this list

Returns:

true

addLong

public void addLong(int aIndex,
                    long aValue)

Description copied from interface: ILcdLongList

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:

addLong in interface ILcdLongList

Parameters:

aIndex - index at which the specified value is to be inserted

aValue - value to be inserted

removeLong

public boolean removeLong(long aValue)

Description copied from interface: ILcdLongList

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:

removeLong in interface ILcdLongList

Parameters:

aValue - value to be removed from this list, if present

Returns:

true if this list contained the specified value

removeLong

public long removeLong(int aIndex)

Description copied from interface: ILcdLongList

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:

removeLong in interface ILcdLongList

Parameters:

aIndex - the index of the value to be removed

Returns:

the value previously at the specified position

toLongArray

public long[] toLongArray()

Description copied from interface: ILcdLongList

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:

toLongArray in interface ILcdLongList

Returns:

an array containing all of the values in this list in proper sequence

toLongArray

public long[] toLongArray(long[] anArray)

Description copied from interface: ILcdLongList

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:

toLongArray in interface ILcdLongList

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<Long>

Specified by:

clear in interface List<Long>

Overrides:

clear in class AbstractList<Long>

binarySearch

public int binarySearch(long 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 TLcdLongArrayList clone()

Description copied from interface: ILcdLongList

Creates and returns a copy of this object.

Specified by:

clone in interface ILcdLongList

Specified by:

clone in interface ILcdCloneable

Overrides:

clone in class Object

Returns:

a copy of this object.

See Also:

Object.clone()

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<Long>

Overrides:

indexOf in class AbstractList<Long>

indexOfLong

public int indexOfLong(long aValue)

Description copied from interface: ILcdLongList

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:

indexOfLong in interface ILcdLongList

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<Long>

Overrides:

lastIndexOf in class AbstractList<Long>

lastIndexOfLong

public int lastIndexOfLong(long aValue)

Description copied from interface: ILcdLongList

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:

lastIndexOfLong in interface ILcdLongList

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

containsLong

public boolean containsLong(long aValue)

Description copied from interface: ILcdLongList

Returns true if this list contains the specified value.

Specified by:

containsLong in interface ILcdLongList

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<Long>

Specified by:

contains in interface List<Long>

Overrides:

contains in class AbstractCollection<Long>