Package io.opentelemetry.sdk.internal

Class DynamicPrimitiveLongList

java.lang.Object

java.util.AbstractCollection<Long>

java.util.AbstractList<Long>

io.opentelemetry.sdk.internal.DynamicPrimitiveLongList

All Implemented Interfaces:

Iterable<Long>, Collection<Long>, List<Long>, SequencedCollection<Long>

public class DynamicPrimitiveLongList
extends AbstractList<Long>

A resizable list for storing primitive `long` values.

This class implements a dynamically resizable list specifically for primitive long values. The values are stored in a chain of arrays (named sub-array), so it can grow efficiently, by adding more sub-arrays per its defined size. The backing array also helps avoid auto-boxing and helps provide access to values as primitives without boxing.

The list is designed to minimize memory allocations, by:

1. Adding sub-arrays and not creating new arrays and copying.
2. When the size is changing to a smaller size, arrays are not removed.

Supported List<Long> methods:

• get(int) - Retrieves the element at the specified position in this list as a Long object.
• set(int, Long) - Replaces the element at the specified position in this list with the specified Long object.
• size() - Returns the number of elements in this list.

Additional utility methods:

• getLong(int) - Retrieves the element at the specified position in this list as a primitive long.
• setLong(int, long) - Replaces the element at the specified position in this list with the specified primitive long element.
• resizeAndClear(int) - Resizes the list to the specified size, resetting all elements to zero.

This class is internal and is hence not for public use. Its APIs are unstable and can change at any time.

This class is not thread-safe.

Field Summary

Fields

Modifier and Type	Field	Description
private int	arrayCount
private long[][]	arrays
private static final int	DEFAULT_SUBARRAY_CAPACITY
private int	size
private final int	subarrayCapacity

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
DynamicPrimitiveLongList()
DynamicPrimitiveLongList(int subarrayCapacity)

Method Summary

Modifier and Type	Method	Description
static DynamicPrimitiveLongList	empty()
private void	ensureCapacity(int minCapacity)
Long	get(int index)
long	getLong(int index)
static DynamicPrimitiveLongList	of(long... values)
static DynamicPrimitiveLongList	ofSubArrayCapacity(int subarrayCapacity)
private String	outOfBoundsMsg(int index)
private void	rangeCheck(int index)
void	resizeAndClear(int newSize)
Long	set(int index, Long element)
long	setLong(int index, long element)
int	size()

Methods inherited from class java.util.AbstractList

add, add, addAll, clear, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, removeRange, subList

Methods inherited from class java.util.AbstractCollection

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

addAll, addFirst, addLast, contains, containsAll, getFirst, getLast, isEmpty, remove, removeAll, removeFirst, removeLast, replaceAll, retainAll, reversed, sort, spliterator, toArray, toArray

Field Details

DEFAULT_SUBARRAY_CAPACITY

private static final int DEFAULT_SUBARRAY_CAPACITY

See Also:

• Constant Field Values

subarrayCapacity

private final int subarrayCapacity

arrays

private long[][] arrays

size

private int size

arrayCount

private int arrayCount

Constructor Details

DynamicPrimitiveLongList

DynamicPrimitiveLongList()

DynamicPrimitiveLongList

DynamicPrimitiveLongList(int subarrayCapacity)

Method Details

of

public static DynamicPrimitiveLongList of(long... values)

ofSubArrayCapacity

public static DynamicPrimitiveLongList ofSubArrayCapacity(int subarrayCapacity)

empty

public static DynamicPrimitiveLongList empty()

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)

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)

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>

resizeAndClear

public void resizeAndClear(int newSize)

ensureCapacity

private void ensureCapacity(int minCapacity)

rangeCheck

private void rangeCheck(int index)

outOfBoundsMsg

private String outOfBoundsMsg(int index)