us.hebi.quickbuf

Class RepeatedLong

java.lang.Object

us.hebi.quickbuf.RepeatedLong

All Implemented Interfaces:

Iterable<Long>

public final class RepeatedLong
extends Object

Class that represents the data for a repeated long field.

Since:

09 Aug 2019

Author:

Florian Enner

Field Summary

Fields

Modifier and Type	Field and Description
protected int	length

Method Summary

Modifier and Type	Method and Description
RepeatedLong	add(long value)
RepeatedLong	addAll(long[] values)
RepeatedLong	addAll(long[] buffer, int offset, int length)
void	addAll(RepeatedLong values)
int	addLength(int length) Sets the length to length + offset and returns the previous length.
long[]	array() Provides access to the internal storage array.
int	capacity()
protected void	checkIndex(int index)
RepeatedType	clear() Sets the output length to zero and performs any necessary cleanup of the content.
RepeatedLong	copyFrom(long[] buffer)
RepeatedLong	copyFrom(long[] buffer, int offset, int length)
void	copyFrom(RepeatedLong other)
boolean	equals(Object o)
protected void	extendCapacityTo(int desiredSize)
long	get(int index)
protected Long	getValueAt(int index)
int	hashCode() Repeated fields have no immutable state and should not be used in hashing structures.
us.hebi.quickbuf.RepeatedField.GenericIterator	iterator()
int	length()
static RepeatedLong	newEmptyInstance()
static RepeatedLong	newInstance(long[] initialValue)
int	remainingCapacity()
RepeatedType	reserve(int count) Makes sure that the internal storage capacity has space for at least the requested number of entries.
RepeatedLong	set(int index, long value)
RepeatedLong	setInternalArray(long[] array) Gifts ownership of the supplied array and uses it as the internal storage array.
RepeatedLong	setInternalArray(long[] array, int length)
RepeatedLong	setLength(int length) Sets the absolute length of the data that can be serialized.
long[]	toArray() Creates a copy of the valid data contained in the internal storage.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

length

protected int length

Method Detail

newEmptyInstance

public static RepeatedLong newEmptyInstance()

newInstance

public static RepeatedLong newInstance(long[] initialValue)

extendCapacityTo

protected void extendCapacityTo(int desiredSize)

getValueAt

protected Long getValueAt(int index)

get

public long get(int index)

set

public RepeatedLong set(int index,
                        long value)

add

public RepeatedLong add(long value)

addAll

public RepeatedLong addAll(long[] values)

addAll

public RepeatedLong addAll(long[] buffer,
                           int offset,
                           int length)

copyFrom

public RepeatedLong copyFrom(long[] buffer)

copyFrom

public RepeatedLong copyFrom(long[] buffer,
                             int offset,
                             int length)

addAll

public void addAll(RepeatedLong values)

copyFrom

public void copyFrom(RepeatedLong other)

setInternalArray

public RepeatedLong setInternalArray(long[] array)

Gifts ownership of the supplied array and uses it as the internal storage array. Subsequent write actions may change the contents, and append actions may replace the internal storage array with something else.

Parameters:

array - array with valid data from zero to length

Returns:

this

setInternalArray

public RepeatedLong setInternalArray(long[] array,
                                     int length)

capacity

public int capacity()

Returns:

total capacity of the internal storage array

toArray

public final long[] toArray()

Creates a copy of the valid data contained in the internal storage.

Returns:

copy of only valid data

array

public final long[] array()

Provides access to the internal storage array. Do not hold on to this reference as it can change during a resize.

The array may be larger than the amount of contained data, but the data is only valid between index 0 and length.

Returns:

internal storage array

setLength

public final RepeatedLong setLength(int length)

Sets the absolute length of the data that can be serialized. The internal storage array may get extended to accommodate at least the desired length.

This does not change the underlying data, so setting a length longer than the current one may result in arbitrary data being serialized.

Parameters:

length - desired length

Returns:

this

addLength

public final int addLength(int length)

Sets the length to length + offset and returns the previous length. The internal storage array may get extended to accommodate at least the desired length.

It is expected that users don't know the exact desired size, so the growth rate is the same as a generic ArrayList.

See setLength(int)

Parameters:

length - added to the current length

Returns:

previous length

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

length

public final int length()

remainingCapacity

public final int remainingCapacity()

iterator

public us.hebi.quickbuf.RepeatedField.GenericIterator iterator()

Specified by:

iterator in interface Iterable<GenericType>

reserve

public final RepeatedType reserve(int count)

Makes sure that the internal storage capacity has space for at least the requested number of entries. This method will increase the internal capacity if needed.

Parameters:

count - number of entries to be added

clear

public RepeatedType clear()

Sets the output length to zero and performs any necessary cleanup of the content. Does not release the internal buffer.

checkIndex

protected final void checkIndex(int index)

hashCode

public final int hashCode()

Repeated fields have no immutable state and should not be used in hashing structures. This method returns a constant value.

Overrides:

hashCode in class Object

Returns:

0