ObjectList (Primitive-Collections 0.2.0 API)

Type Parameters:

T - the type of elements maintained by this Collection

All Superinterfaces:

java.util.Collection<T>, java.lang.Iterable<T>, java.util.List<T>, ObjectCollection<T>, ObjectIterable<T>

All Known Implementing Classes:

AbstractObjectList, ObjectArrayList
```
public interface ObjectList<T>
extends ObjectCollection<T>, java.util.List<T>
```
A Type Specific List interface that reduces boxing/unboxing and adds a couple extra quality of life features

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`boolean`	`addAll(int index, ObjectCollection<T> c)` A Type-Specific addAll Function to reduce (un)boxing
`boolean`	`addAll(int index, ObjectList<T> c)` A Type-Specific and optimized addAll function that allows a faster transfer of elements
`boolean`	`addAll(ObjectList<T> c)` A Type-Specific and optimized addAll function that allows a faster transfer of elements
`default void`	`addElements(int from, T... a)` A function to fast add elements to the list
`void`	`addElements(int from, T[] a, int offset, int length)` A function to fast add elements to the list
`default void`	`addElements(T... a)` A function to fast add elements to the list
`<K> K[]`	`extractElements(int from, int to, java.lang.Class<K> type)` A function to fast extract elements out of the list, this removes the elements that were fetched.
`default T[]`	`getElements(int from, T[] a)` A function to fast fetch elements from the list
`T[]`	`getElements(int from, T[] a, int offset, int length)` A function to fast fetch elements from the list
`ObjectListIterator<T>`	`listIterator()` A Type-Specific Iterator of listIterator
`ObjectListIterator<T>`	`listIterator(int index)` A Type-Specific Iterator of listIterator
`void`	`removeElements(int from, int to)` a function to fast remove elements from the list.
`default void`	`replaceAll(java.util.function.UnaryOperator<T> o)` A function to replace all values in the list
`void`	`size(int size)` A function to ensure the elements are within the requested size.
`default void`	`sort(java.util.Comparator<? super T> c)` Sorts the elements specified by the Natural order either by using the Comparator or the elements
`default ObjectSplititerator<T>`	`spliterator()` A Type Specific Type Splititerator to reduce boxing/unboxing
`ObjectList<T>`	`subList(int from, int to)` A Type-Specific List of subList
`default void`	`unstableSort(java.util.Comparator<? super T> 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.objects.collections.ObjectCollection
addAll, containsAll, containsAny, containsAny, iterator, removeAll, retainAll

Methods inherited from interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, remove, remove, removeAll, retainAll, set, size, toArray, toArray

Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable
forEach

- Method Detail
  - addAll
```
boolean addAll(int index,
               ObjectCollection<T> 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(ObjectList<T> 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,
               ObjectList<T> 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
  - replaceAll
```
default void replaceAll(java.util.function.UnaryOperator<T> o)
```
    A function to replace all values in the list
    
    Specified by:
    
    replaceAll in interface java.util.List<T>
    
    Parameters:
    
    o - the action to replace the values
    
    Throws:
    
    java.lang.NullPointerException - if o is null
  - addElements
```
default void addElements(T... 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,
                         T... 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,
                 T[] 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 T[] getElements(int from,
                        T[] 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
```
T[] getElements(int from,
                T[] 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
```
<K> K[] extractElements(int from,
                        int to,
                        java.lang.Class<K> type)
```
    A function to fast extract elements out of the list, this removes the elements that were fetched.
    
    Type Parameters:
    
    K - the type of elements maintained by this Collection
    
    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)
    
    type - the type of the OutputArray
    
    Returns:
    
    a array of the elements that were fetched
  - sort
```
default void sort(java.util.Comparator<? super T> c)
```
    Sorts the elements specified by the Natural order either by using the Comparator or the elements
    
    Specified by:
    
    sort in interface java.util.List<T>
    
    See Also:
    
    List.sort(Comparator)
  - unstableSort
```
default void unstableSort(java.util.Comparator<? super T> 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)
  - listIterator
```
ObjectListIterator<T> listIterator()
```
    A Type-Specific Iterator of listIterator
    
    Specified by:
    
    listIterator in interface java.util.List<T>
    
    See Also:
    
    List.listIterator()
  - listIterator
```
ObjectListIterator<T> listIterator(int index)
```
    A Type-Specific Iterator of listIterator
    
    Specified by:
    
    listIterator in interface java.util.List<T>
    
    See Also:
    
    List.listIterator(int)
  - subList
```
ObjectList<T> subList(int from,
                      int to)
```
    A Type-Specific List of subList
    
    Specified by:
    
    subList in interface java.util.List<T>
    
    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
  - spliterator
```
default ObjectSplititerator<T> spliterator()
```
    A Type Specific Type Splititerator to reduce boxing/unboxing
    
    Specified by:
    
    spliterator in interface java.util.Collection<T>
    
    Specified by:
    
    spliterator in interface java.lang.Iterable<T>
    
    Specified by:
    
    spliterator in interface java.util.List<T>
    
    Specified by:
    
    spliterator in interface ObjectCollection<T>
    
    Specified by:
    
    spliterator in interface ObjectIterable<T>
    
    Returns:
    
    type specific splititerator

Interface ObjectList<T>

Method Summary

Methods inherited from interface speiger.src.collections.objects.collections.ObjectCollection

Methods inherited from interface java.util.List

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Method Detail

addAll

addAll

addAll

replaceAll

addElements

addElements

addElements

getElements

getElements

removeElements

extractElements

sort

unstableSort

listIterator

listIterator

subList

size

spliterator