LongArrayList (Agrona)

java.lang.Object
- java.util.AbstractCollection<E>
- - java.util.AbstractList<Long>
  - - org.agrona.collections.LongArrayList

All Implemented Interfaces:

Iterable<Long>, Collection<Long>, List<Long>, RandomAccess
```
public class LongArrayList
extends AbstractList<Long>
implements List<Long>, RandomAccess
```
A List implementation that stores long values with the ability to not have them boxed.

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`DEFAULT_NULL_VALUE` The default value that will be used in place of null for an element.
`static int`	`INITIAL_CAPACITY` Initial capacity to which the array will be sized.

Fields inherited from class java.util.AbstractList
modCount

Constructor Summary

Constructors
Constructor and Description
`LongArrayList()` Constructs a new list with the `INITIAL_CAPACITY` using `DEFAULT_NULL_VALUE`.
`LongArrayList(int initialCapacity, long nullValue)` Construct a new list.
`LongArrayList(long[] initialElements, int initialSize, long nullValue)` Create a new list that wraps an existing arrays without copying it.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(int index, Long element)`
`boolean`	`add(Long element)`
`void`	`addLong(int index, long element)` Add an element without boxing at a given index.
`boolean`	`addLong(long element)` Add an element without boxing.
`int`	`capacity()` The current capacity for the collection.
`void`	`clear()`
`boolean`	`containsLong(long value)` Does the list contain this element value.
`void`	`ensureCapacity(int requiredCapacity)` Ensure the backing array has a required capacity.
`boolean`	`equals(LongArrayList that)` Type-safe overload of the `equals(Object)` method.
`boolean`	`equals(Object other)`
`long`	`fastUnorderedRemove(int index)` Removes element at index, but instead of copying all elements to the left, it replaces the item in the slot with the last item in the list.
`boolean`	`fastUnorderedRemoveLong(long value)` Remove the first instance of a value if found in the list and replaces it with the last item in the list.
`void`	`forEach(Consumer<? super Long> action)`
`void`	`forEachLong(LongConsumer action)` Iterate over the collection without boxing.
`void`	`forEachOrderedLong(LongConsumer action)` For each element in order provide the long value to a `LongConsumer`.
`Long`	`get(int index)`
`long`	`getLong(int index)` Get the element at a given index without boxing.
`int`	`hashCode()`
`int`	`indexOf(long value)` Index of the first element with this value.
`int`	`lastIndexOf(long value)` Index of the last element with this value.
`LongStream`	`longStream()` Create a `LongStream` over the elements of underlying array.
`long`	`nullValue()` The value representing a null element.
`long`	`popLong()` Pop a value off the end of the array as a stack operation.
`void`	`pushLong(long element)` Push an element onto the end of the array like a stack.
`Long`	`remove(int index)` Remove at a given index.
`boolean`	`removeLong(long value)` Remove the first instance of a value if found in the list.
`Long`	`set(int index, Long element)`
`long`	`setLong(int index, long element)` Set an element at a given index without boxing.
`int`	`size()`
`long[]`	`toLongArray()` Create a new array that is a copy of the elements.
`long[]`	`toLongArray(long[] dst)` Create a new array that is a copy of the elements.
`String`	`toString()`
`void`	`trimToSize()` Trim the underlying array to be the current size, or `INITIAL_CAPACITY` if size is less.
`void`	`wrap(long[] initialElements, int initialSize)` Wrap an existing array without copying it.

Methods inherited from class java.util.AbstractList
addAll, indexOf, iterator, lastIndexOf, listIterator, listIterator, removeRange, subList

Methods inherited from class java.util.AbstractCollection
addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List
addAll, addAll, contains, containsAll, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, removeAll, replaceAll, retainAll, sort, spliterator, subList, toArray, toArray

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

- Field Detail
  - DEFAULT_NULL_VALUE
```
public static final long DEFAULT_NULL_VALUE
```
    The default value that will be used in place of null for an element.
    
    See Also:
    
    Constant Field Values
  - INITIAL_CAPACITY
```
public static final int INITIAL_CAPACITY
```
    Initial capacity to which the array will be sized.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - LongArrayList
```
public LongArrayList()
```
    Constructs a new list with the INITIAL_CAPACITY using DEFAULT_NULL_VALUE.
  - LongArrayList
```
public LongArrayList(int initialCapacity,
                     long nullValue)
```
    Construct a new list.
    
    Parameters:
    
    initialCapacity - for the backing array.
    
    nullValue - to be used to represent a null element.
  - LongArrayList
```
public LongArrayList(long[] initialElements,
                     int initialSize,
                     long nullValue)
```
    Create a new list that wraps an existing arrays without copying it.
    
    Parameters:
    
    initialElements - to be wrapped.
    
    initialSize - of the array to wrap.
    
    nullValue - to be used to represent a null element.
- Method Detail
  - wrap
```
public void wrap(long[] initialElements,
                 int initialSize)
```
    Wrap an existing array without copying it.
    
    Parameters:
    
    initialElements - to be wrapped.
    
    initialSize - of the array to wrap.
    
    Throws:
    
    IllegalArgumentException - if the initialSize is less than 0 or greater than the length of the initial array.
  - nullValue
```
public long nullValue()
```
    The value representing a null element.
    
    Returns:
    
    value representing a null element.
  - 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>
  - capacity
```
public int capacity()
```
    The current capacity for the collection.
    
    Returns:
    
    the current capacity for the collection.
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Collection<Long>
    
    Specified by:
    
    clear in interface List<Long>
    
    Overrides:
    
    clear in class AbstractList<Long>
  - trimToSize
```
public void trimToSize()
```
    Trim the underlying array to be the current size, or INITIAL_CAPACITY if size is less.
  - get
```
public Long get(int index)
```
    Specified by:
    
    get in interface List<Long>
    
    Specified by:
    
    get in class AbstractList<Long>
  - getLong
```
public long getLong(int index)
```
    Get the element at a given index without boxing.
    
    Parameters:
    
    index - to get.
    
    Returns:
    
    the unboxed element.
  - add
```
public boolean add(Long element)
```
    Specified by:
    
    add in interface Collection<Long>
    
    Specified by:
    
    add in interface List<Long>
    
    Overrides:
    
    add in class AbstractList<Long>
  - addLong
```
public boolean addLong(long element)
```
    Add an element without boxing.
    
    Parameters:
    
    element - to be added.
    
    Returns:
    
    true
  - add
```
public void add(int index,
                Long element)
```
    Specified by:
    
    add in interface List<Long>
    
    Overrides:
    
    add in class AbstractList<Long>
  - addLong
```
public void addLong(int index,
                    long element)
```
    Add an element without boxing at a given index.
    
    Parameters:
    
    index - at which the element should be added.
    
    element - to be added.
  - set
```
public Long set(int index,
                Long element)
```
    Specified by:
    
    set in interface List<Long>
    
    Overrides:
    
    set in class AbstractList<Long>
  - setLong
```
public long setLong(int index,
                    long element)
```
    Set an element at a given index without boxing.
    
    Parameters:
    
    index - at which to set the element.
    
    element - to be added.
    
    Returns:
    
    the previous element at the index.
  - containsLong
```
public boolean containsLong(long value)
```
    Does the list contain this element value.
    
    Parameters:
    
    value - of the element.
    
    Returns:
    
    true if present otherwise false.
  - indexOf
```
public int indexOf(long value)
```
    Index of the first element with this value.
    
    Parameters:
    
    value - for the element.
    
    Returns:
    
    the index if found otherwise -1.
  - lastIndexOf
```
public int lastIndexOf(long value)
```
    Index of the last element with this value.
    
    Parameters:
    
    value - for the element.
    
    Returns:
    
    the index if found otherwise -1.
  - remove
```
public Long remove(int index)
```
    Remove at a given index.
    
    Specified by:
    
    remove in interface List<Long>
    
    Overrides:
    
    remove in class AbstractList<Long>
    
    Parameters:
    
    index - of the element to be removed.
    
    Returns:
    
    the existing value at this index.
  - fastUnorderedRemove
```
public long fastUnorderedRemove(int index)
```
    Removes element at index, but instead of copying all elements to the left, it replaces the item in the slot with the last item in the list. This avoids the copy costs at the expense of preserving list order. If index is the last element it is just removed.
    
    Parameters:
    
    index - of the element to be removed.
    
    Returns:
    
    the existing value at this index.
    
    Throws:
    
    IndexOutOfBoundsException - if index is out of bounds.
  - removeLong
```
public boolean removeLong(long value)
```
    Remove the first instance of a value if found in the list.
    
    Parameters:
    
    value - to be removed.
    
    Returns:
    
    true if successful otherwise false.
  - fastUnorderedRemoveLong
```
public boolean fastUnorderedRemoveLong(long value)
```
    Remove the first instance of a value if found in the list and replaces it with the last item in the list. This saves a copy down of all items at the expense of not preserving list order.
    
    Parameters:
    
    value - to be removed.
    
    Returns:
    
    true if successful otherwise false.
  - pushLong
```
public void pushLong(long element)
```
    Push an element onto the end of the array like a stack.
    
    Parameters:
    
    element - to be pushed onto the end of the array.
  - popLong
```
public long popLong()
```
    Pop a value off the end of the array as a stack operation.
    
    Returns:
    
    the value at the end of the array.
    
    Throws:
    
    NoSuchElementException - if the array is empty.
  - forEachOrderedLong
```
public void forEachOrderedLong(LongConsumer action)
```
    For each element in order provide the long value to a LongConsumer.
    
    Parameters:
    
    action - to be taken for each element.
  - longStream
```
public LongStream longStream()
```
    Create a LongStream over the elements of underlying array.
    
    Returns:
    
    a LongStream over the elements of underlying array.
  - toLongArray
```
public long[] toLongArray()
```
    Create a new array that is a copy of the elements.
    
    Returns:
    
    a copy of the elements.
  - toLongArray
```
public long[] toLongArray(long[] dst)
```
    Create a new array that is a copy of the elements.
    
    Parameters:
    
    dst - destination array for the copy if it is the correct size.
    
    Returns:
    
    a copy of the elements.
  - ensureCapacity
```
public void ensureCapacity(int requiredCapacity)
```
    Ensure the backing array has a required capacity.
    
    Parameters:
    
    requiredCapacity - for the backing array.
  - equals
```
public boolean equals(LongArrayList that)
```
    Type-safe overload of the equals(Object) method.
    
    Parameters:
    
    that - other list.
    
    Returns:
    
    true if lists are equal.
  - equals
```
public boolean equals(Object other)
```
    Specified by:
    
    equals in interface Collection<Long>
    
    Specified by:
    
    equals in interface List<Long>
    
    Overrides:
    
    equals in class AbstractList<Long>
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Collection<Long>
    
    Specified by:
    
    hashCode in interface List<Long>
    
    Overrides:
    
    hashCode in class AbstractList<Long>
  - forEach
```
public void forEach(Consumer<? super Long> action)
```
    Specified by:
    
    forEach in interface Iterable<Long>
  - forEachLong
```
public void forEachLong(LongConsumer action)
```
    Iterate over the collection without boxing.
    
    Parameters:
    
    action - to be taken for each element.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class AbstractCollection<Long>

Class LongArrayList

Field Summary

Fields inherited from class java.util.AbstractList

Constructor Summary

Method Summary

Methods inherited from class java.util.AbstractList

Methods inherited from class java.util.AbstractCollection

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.List

Methods inherited from interface java.util.Collection

Field Detail

DEFAULT_NULL_VALUE

INITIAL_CAPACITY

Constructor Detail

LongArrayList

LongArrayList

LongArrayList

Method Detail

wrap

nullValue

size

capacity

clear

trimToSize

get

getLong

add

addLong

add

addLong

set

setLong

containsLong

indexOf

lastIndexOf

remove

fastUnorderedRemove

removeLong

fastUnorderedRemoveLong

pushLong

popLong

forEachOrderedLong

longStream

toLongArray

toLongArray

ensureCapacity

equals

equals

hashCode

forEach

forEachLong

toString