speiger.src.collections.longs.lists

Interface LongList

All Superinterfaces:

java.util.Collection<java.lang.Long>, java.lang.Iterable<java.lang.Long>, java.util.List<java.lang.Long>, LongCollection, LongIterable

All Known Implementing Classes:

AbstractLongList, LongArrayList

public interface LongList
extends LongCollection, java.util.List<java.lang.Long>

A Type Specific List interface that reduces boxing/unboxing and adds a couple extra quality of life features

Method Summary

Modifier and Type	Method and Description
void	add(int index, long e) A Type-Specific add Function to reduce (un)boxing
boolean	add(long e) A Type-Specific add Function to reduce (un)boxing
default boolean	add(java.lang.Long e) Deprecated. Please use the corresponding type-specific function instead.
boolean	addAll(int index, LongCollection c) A Type-Specific addAll Function to reduce (un)boxing
boolean	addAll(int index, LongList c) A Type-Specific and optimized addAll function that allows a faster transfer of elements
boolean	addAll(LongList c) A Type-Specific and optimized addAll function that allows a faster transfer of elements
default void	addElements(int from, long... a) A function to fast add elements to the list
void	addElements(int from, long[] a, int offset, int length) A function to fast add elements to the list
default void	addElements(long... a) A function to fast add elements to the list
default boolean	contains(java.lang.Object o) Deprecated. Please use the corresponding type-specific function instead.
long[]	extractElements(int from, int to) A function to fast extract elements out of the list, this removes the elements that were fetched.
default java.lang.Long	get(int index) Deprecated. Please use the corresponding type-specific function instead.
default long[]	getElements(int from, long[] a) A function to fast fetch elements from the list
long[]	getElements(int from, long[] a, int offset, int length) A function to fast fetch elements from the list
long	getLong(int index) A Type-Specific get function to reduce (un)boxing
int	indexOf(long e) A Type-Specific indexOf function to reduce (un)boxing
default int	indexOf(java.lang.Object o) Deprecated. Please use the corresponding type-specific function instead.
int	lastIndexOf(long e) A Type-Specific lastIndexOf function to reduce (un)boxing
default int	lastIndexOf(java.lang.Object o) Deprecated. Please use the corresponding type-specific function instead.
LongListIterator	listIterator() A Type-Specific Iterator of listIterator
LongListIterator	listIterator(int index) A Type-Specific Iterator of listIterator
default java.lang.Long	remove(int index) Deprecated. Please use the corresponding type-specific function instead.
default boolean	remove(java.lang.Object o) Deprecated. Please use the corresponding type-specific function instead.
void	removeElements(int from, int to) a function to fast remove elements from the list.
long	removeLong(int index) A Type-Specific remove function to reduce (un)boxing
default void	replaceAll(java.util.function.UnaryOperator<java.lang.Long> o) Deprecated. Please use the corresponding type-specific function instead.
default void	replaceLongs(java.util.function.LongUnaryOperator o) A Type-Specific replace function to reduce (un)boxing
long	set(int index, long e) A Type-Specific set function to reduce (un)boxing
default java.lang.Long	set(int index, java.lang.Long e) Deprecated. Please use the corresponding type-specific function instead.
void	size(int size) A function to ensure the elements are within the requested size.
default void	sort(java.util.Comparator<? super java.lang.Long> c) Deprecated. Please use the corresponding type-specific function instead.
default void	sort(LongComparator c) Sorts the elements specified by the Natural order either by using the Comparator or the elements
default LongSplititerator	spliterator() A Type Specific Type Splititerator to reduce boxing/unboxing
LongList	subList(int from, int to) A Type-Specific List of subList
default void	unstableSort(java.util.Comparator<? super java.lang.Long> c) Deprecated. Please use the corresponding type-specific function instead.
default void	unstableSort(LongComparator c) Sorts the elements specified by the Natural order either by using the Comparator or the elements using a unstable sort

Methods inherited from interface speiger.src.collections.longs.collections.LongCollection

addAll, contains, containsAll, containsAny, containsAny, iterator, parallelPrimitiveStream, primitiveStream, remIf, remLong, removeAll, removeIf, retainAll, toLongArray, toLongArray

Methods inherited from interface speiger.src.collections.longs.collections.LongIterable

forEach, forEach

Methods inherited from interface java.util.List

add, addAll, addAll, clear, containsAll, equals, hashCode, isEmpty, iterator, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, stream

Method Detail

add

boolean add(long e)

A Type-Specific add Function to reduce (un)boxing

Specified by:

add in interface LongCollection

Parameters:

e - the element to add

Returns:

true if the list was modified

See Also:

List.add(Object)

add

void add(int index,
         long e)

A Type-Specific add Function to reduce (un)boxing

Parameters:

e - the element to add

index - index at which the specified element is to be inserted

See Also:

List.add(int, Object)

addAll

boolean addAll(int index,
               LongCollection c)

A Type-Specific addAll Function to reduce (un)boxing

Parameters:

c - the elements that need to be added

index - index at which the specified elements is to be inserted

Returns:

true if the list was modified

See Also:

List.addAll(int, java.util.Collection)

addAll

boolean addAll(LongList c)

A Type-Specific and optimized addAll function that allows a faster transfer of elements

Parameters:

c - the elements that need to be added

Returns:

true if the list was modified

addAll

boolean addAll(int index,
               LongList c)

A Type-Specific and optimized addAll function that allows a faster transfer of elements

Parameters:

c - the elements that need to be added

index - index at which the specified elements is to be inserted

Returns:

true if the list was modified

getLong

long getLong(int index)

A Type-Specific get function to reduce (un)boxing

Parameters:

index - the index of the value that is requested

Returns:

the value at the given index

Throws:

java.lang.IndexOutOfBoundsException - if the index is not within the list range

See Also:

List.get(int)

set

long set(int index,
         long e)

A Type-Specific set function to reduce (un)boxing

Parameters:

index - index of the element to replace

e - element to be stored at the specified position

Returns:

the element previously at the specified position

Throws:

java.lang.IndexOutOfBoundsException - if the index is not within the list range

See Also:

List.set(int, Object)

removeLong

long removeLong(int index)

A Type-Specific remove function to reduce (un)boxing

Parameters:

index - the index of the element to be removed

Returns:

the element previously at the specified position

See Also:

List.remove(int)

indexOf

int indexOf(long e)

A Type-Specific indexOf function to reduce (un)boxing

Parameters:

e - the element that is searched for

Returns:

the index of the element if found. (if not found then -1)

Note:

does not support null values

lastIndexOf

int lastIndexOf(long e)

A Type-Specific lastIndexOf function to reduce (un)boxing

Parameters:

e - the element that is searched for

Returns:

the lastIndex of the element if found. (if not found then -1)

Note:

does not support null values

replaceLongs

default void replaceLongs(java.util.function.LongUnaryOperator o)

A Type-Specific replace function to reduce (un)boxing

Parameters:

o - the action to replace the values

Throws:

java.lang.NullPointerException - if o is null

addElements

default void addElements(long... a)

A function to fast add elements to the list

Parameters:

a - the elements that should be added

Throws:

java.lang.IndexOutOfBoundsException - if from is outside of the lists range

addElements

default void addElements(int from,
                         long... a)

A function to fast add elements to the list

Parameters:

from - the index where the elements should be added into the list

a - the elements that should be added

Throws:

java.lang.IndexOutOfBoundsException - if from is outside of the lists range

addElements

void addElements(int from,
                 long[] a,
                 int offset,
                 int length)

A function to fast add elements to the list

Parameters:

from - the index where the elements should be added into the list

a - the elements that should be added

offset - the start index of the array should be read from

length - how many elements should be read from

Throws:

java.lang.IndexOutOfBoundsException - if from is outside of the lists range

java.lang.IllegalStateException - if offset or length are smaller then 0 or exceed the array length

getElements

default long[] getElements(int from,
                           long[] a)

A function to fast fetch elements from the list

Parameters:

from - index where the list should be fetching elements from

a - the array where the values should be inserted to

Returns:

the inputArray

Throws:

java.lang.NullPointerException - if the array is null

java.lang.IndexOutOfBoundsException - if from is outside of the lists range

java.lang.IllegalStateException - if offset or length are smaller then 0 or exceed the array length

getElements

long[] getElements(int from,
                   long[] a,
                   int offset,
                   int length)

A function to fast fetch elements from the list

Parameters:

from - index where the list should be fetching elements from

a - the array where the values should be inserted to

offset - the startIndex of where the array should be written to

length - the number of elements the values should be fetched from

Returns:

the inputArray

Throws:

java.lang.NullPointerException - if the array is null

java.lang.IndexOutOfBoundsException - if from is outside of the lists range

java.lang.IllegalStateException - if offset or length are smaller then 0 or exceed the array length

removeElements

void removeElements(int from,
                    int to)

a function to fast remove elements from the list.

Parameters:

from - the start index of where the elements should be removed from (inclusive)

to - the end index of where the elements should be removed to (exclusive)

extractElements

long[] extractElements(int from,
                       int to)

A function to fast extract elements out of the list, this removes the elements that were fetched.

Parameters:

from - the start index of where the elements should be fetched from (inclusive)

to - the end index of where the elements should be fetched to (exclusive)

Returns:

a array of the elements that were fetched

sort

@Deprecated
default void sort(java.util.Comparator<? super java.lang.Long> c)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

sort in interface java.util.List<java.lang.Long>

sort

default void sort(LongComparator c)

Sorts the elements specified by the Natural order either by using the Comparator or the elements

Parameters:

c - the sorter of the elements, can be null

See Also:

List.sort(Comparator), LongArrays.stableSort(long[], LongComparator)

unstableSort

@Deprecated
default void unstableSort(java.util.Comparator<? super java.lang.Long> c)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Parameters:

c - the sorter of the elements, can be null

unstableSort

default void unstableSort(LongComparator c)

Sorts the elements specified by the Natural order either by using the Comparator or the elements using a unstable sort

Parameters:

c - the sorter of the elements, can be null

See Also:

List.sort(Comparator), LongArrays.unstableSort(long[], LongComparator)

listIterator

LongListIterator listIterator()

A Type-Specific Iterator of listIterator

Specified by:

listIterator in interface java.util.List<java.lang.Long>

See Also:

List.listIterator()

listIterator

LongListIterator listIterator(int index)

A Type-Specific Iterator of listIterator

Specified by:

listIterator in interface java.util.List<java.lang.Long>

See Also:

List.listIterator(int)

subList

LongList subList(int from,
                 int to)

A Type-Specific List of subList

Specified by:

subList in interface java.util.List<java.lang.Long>

See Also:

List.subList(int, int)

size

void size(int size)

A function to ensure the elements are within the requested size. If smaller then the stored elements they get removed as needed. If bigger it is ensured that enough room is provided depending on the implementation

Parameters:

size - the requested amount of elements/room for elements

add

@Deprecated
default boolean add(java.lang.Long e)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

This default implementation delegates to the corresponding type-specific function.

Specified by:

add in interface java.util.Collection<java.lang.Long>

Specified by:

add in interface java.util.List<java.lang.Long>

Specified by:

add in interface LongCollection

get

@Deprecated
default java.lang.Long get(int index)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

get in interface java.util.List<java.lang.Long>

set

@Deprecated
default java.lang.Long set(int index,
                                        java.lang.Long e)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

set in interface java.util.List<java.lang.Long>

indexOf

@Deprecated
default int indexOf(java.lang.Object o)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

indexOf in interface java.util.List<java.lang.Long>

lastIndexOf

@Deprecated
default int lastIndexOf(java.lang.Object o)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

lastIndexOf in interface java.util.List<java.lang.Long>

contains

@Deprecated
default boolean contains(java.lang.Object o)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

This default implementation delegates to the corresponding type-specific function.

Specified by:

contains in interface java.util.Collection<java.lang.Long>

Specified by:

contains in interface java.util.List<java.lang.Long>

Specified by:

contains in interface LongCollection

remove

@Deprecated
default boolean remove(java.lang.Object o)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

This default implementation delegates to the corresponding type-specific function.

Specified by:

remove in interface java.util.Collection<java.lang.Long>

Specified by:

remove in interface java.util.List<java.lang.Long>

Specified by:

remove in interface LongCollection

remove

@Deprecated
default java.lang.Long remove(int index)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

remove in interface java.util.List<java.lang.Long>

replaceAll

@Deprecated
default void replaceAll(java.util.function.UnaryOperator<java.lang.Long> o)

Deprecated. Please use the corresponding type-specific function instead.

This default implementation delegates to the corresponding type-specific function.

Specified by:

replaceAll in interface java.util.List<java.lang.Long>

spliterator

default LongSplititerator spliterator()

A Type Specific Type Splititerator to reduce boxing/unboxing

Specified by:

spliterator in interface java.util.Collection<java.lang.Long>

Specified by:

spliterator in interface java.lang.Iterable<java.lang.Long>

Specified by:

spliterator in interface java.util.List<java.lang.Long>

Specified by:

spliterator in interface LongCollection

Specified by:

spliterator in interface LongIterable

Returns:

type specific splititerator