com.luciad.util.collections

LuciadLightspeedInterface ILcdLongList

All Superinterfaces:

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

All Known Implementing Classes:

TLcdLongArrayList

public interface ILcdLongList
extends List<Long>, ILcdCloneable

A List interface that is optimized for longs. It provides extra methods using long primitives, instead of Long objects.

Since:

9.0

Method Summary

Modifier and Type	Method and Description
default boolean	addAll(int aStartIndex, long[] aValues) Equivalent to addAll(aStartIndex, aValues, 0, aValues.length.
default boolean	addAll(int aStartIndex, long[] aValues, int aOffset, int aLength) Adds aLength boolean values from the given array to this list, starting from the given aOffset
default boolean	addAll(long[] aValues) Equivalent to addAll(size(), aValues, 0, aValues.length.
default boolean	addAll(long[] aValues, int aOffset, int aLength) Equivalent to addAll(size(), aValues, aOffset, aLength.
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).
ILcdLongList	clone() Creates and returns a copy of this object.
boolean	containsLong(long aValue) Returns true if this list contains the specified value.
long	getLong(int aIndex) Returns the value at the specified position in this list.
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	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	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	setLong(int aIndex, long aValue) Replaces the value at the specified position in this list with the specified value (optional operation).
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.

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Method Detail

getLong

long getLong(int aIndex)

Returns the value at the specified position in this list.

Parameters:

aIndex - index of the value to return

Returns:

the value at the specified position in this list

Throws:

IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size()).

setLong

long setLong(int aIndex,
             long aValue)

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

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

Throws:

UnsupportedOperationException - if the set operation is not supported by this list

IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())

addLong

boolean addLong(long aValue)

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

Parameters:

aValue - value to be appended to this list

Returns:

true

Throws:

UnsupportedOperationException - if the add operation is not supported by this list

addLong

void addLong(int aIndex,
             long aValue)

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).

Parameters:

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

aValue - value to be inserted

Throws:

UnsupportedOperationException - if the add operation is not supported by this list

IndexOutOfBoundsException - if the index is out of range (index < 0 || index > size())

addAll

default boolean addAll(long[] aValues)

Equivalent to addAll(size(), aValues, 0, aValues.length.

Since:

2018.0

See Also:

addAll(int, long[], int, int)

addAll

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

Equivalent to addAll(size(), aValues, aOffset, aLength.

Since:

2018.0

See Also:

addAll(int, long[], int, int)

addAll

default boolean addAll(int aStartIndex,
                       long[] aValues)

Equivalent to addAll(aStartIndex, aValues, 0, aValues.length.

Since:

2018.0

See Also:

addAll(int, long[], int, int)

addAll

default boolean addAll(int aStartIndex,
                       long[] aValues,
                       int aOffset,
                       int aLength)

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

Parameters:

aStartIndex - 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.

Throws:

IndexOutOfBoundsException - if aStartIndex is less than zero or larger than the current size of this list.

IndexOutOfBoundsException - if aOffset + aLength exceeds the length of aValues

IndexOutOfBoundsException - if aOffset is negative

IndexOutOfBoundsException - if aLength is negative

Since:

2018.0

removeLong

boolean removeLong(long aValue)

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).

Parameters:

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

Returns:

true if this list contained the specified value

Throws:

UnsupportedOperationException - if the remove operation is not supported by this list

removeLong

long removeLong(int aIndex)

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.

Parameters:

aIndex - the index of the value to be removed

Returns:

the value previously at the specified position

Throws:

UnsupportedOperationException - if the remove operation is not supported by this list

IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())

toLongArray

long[] toLongArray()

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.

Returns:

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

toLongArray

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. 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.)

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

Throws:

NullPointerException - if the specified array is null

containsLong

boolean containsLong(long aValue)

Returns true if this list contains the specified value.

Parameters:

aValue - value whose presence in this list is to be tested

Returns:

true if this list contains the specified value

indexOfLong

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.

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

lastIndexOfLong

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.

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

clone

ILcdLongList clone()

Creates and returns a copy of this object.

Specified by:

clone in interface ILcdCloneable

Returns:

a copy of this object.

See Also:

Object.clone()