us.hebi.quickbuf

Class RepeatedDouble

java.lang.Object

us.hebi.quickbuf.RepeatedDouble

All Implemented Interfaces:

Iterable<Double>

public final class RepeatedDouble
extends Object

Class that represents the data for a repeated double 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
RepeatedDouble	add(double value)
RepeatedDouble	addAll(double[] values)
RepeatedDouble	addAll(double[] buffer, int offset, int length)
void	addAll(RepeatedDouble values)
int	addLength(int length) Sets the length to length + offset and returns the previous length.
double[]	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.
RepeatedDouble	copyFrom(double[] buffer)
RepeatedDouble	copyFrom(double[] buffer, int offset, int length)
void	copyFrom(RepeatedDouble other)
boolean	equals(Object o)
protected void	extendCapacityTo(int desiredSize)
double	get(int index)
protected Double	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 RepeatedDouble	newEmptyInstance()
static RepeatedDouble	newInstance(double[] initialValue)
int	remainingCapacity()
RepeatedType	reserve(int count) Makes sure that the internal storage capacity has space for at least the requested number of entries.
RepeatedDouble	set(int index, double value)
RepeatedDouble	setInternalArray(double[] array) Gifts ownership of the supplied array and uses it as the internal storage array.
RepeatedDouble	setInternalArray(double[] array, int length)
RepeatedDouble	setLength(int length) Sets the absolute length of the data that can be serialized.
double[]	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 RepeatedDouble newEmptyInstance()

newInstance

public static RepeatedDouble newInstance(double[] initialValue)

extendCapacityTo

protected void extendCapacityTo(int desiredSize)

getValueAt

protected Double getValueAt(int index)

get

public double get(int index)

set

public RepeatedDouble set(int index,
                          double value)

add

public RepeatedDouble add(double value)

addAll

public RepeatedDouble addAll(double[] values)

addAll

public RepeatedDouble addAll(double[] buffer,
                             int offset,
                             int length)

copyFrom

public RepeatedDouble copyFrom(double[] buffer)

copyFrom

public RepeatedDouble copyFrom(double[] buffer,
                               int offset,
                               int length)

addAll

public void addAll(RepeatedDouble values)

copyFrom

public void copyFrom(RepeatedDouble other)

setInternalArray

public RepeatedDouble setInternalArray(double[] 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 RepeatedDouble setInternalArray(double[] array,
                                       int length)

capacity

public int capacity()

Returns:

total capacity of the internal storage array

toArray

public final double[] toArray()

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

Returns:

copy of only valid data

array

public final double[] 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 RepeatedDouble 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