mikera.vectorz

Class GrowableVector

java.lang.Object

mikera.vectorz.AVector

mikera.vectorz.ArrayVector

mikera.vectorz.GrowableVector

All Implemented Interfaces:

Serializable, Cloneable, Comparable<AVector>, Iterable<Double>, IVector

public final class GrowableVector
extends ArrayVector

Implements a growable vector, intended for incrementally building vectors Note that getting the underlying array or a subVector is unsafe, since the underlying array may be discarded as the vector is grown.

Author:

Mike

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GrowableVector()
GrowableVector(AVector v)

Method Summary

Methods

Modifier and Type	Method and Description
void	append(AVector v)
void	append(double v)
AVector	build() Function to build a fixed-size vector containing a copy of data once the GrowableVector is constructed
void	clear()
GrowableVector	clone() Clones the vector, creating a new copy of all data.
int	currentCapacity()
void	ensureCapacity(int capacity)
double	get(int i)
double[]	getArray() Gets the current underlying array of the GrowableVector.
int	getArrayOffset()
boolean	isReference() Returns true if this vector is of a type that references other vectors / data.
int	length()
static GrowableVector	ofInitialCapacity(int capacity) Returns a new, empty GrowableVector with the specified initial capacity
void	set(int i, double value)

Methods inherited from class mikera.vectorz.ArrayVector

add, add, addMultiple, copy, copy, copyTo, divide, divide, divideTo, fillRange, magnitude, magnitudeSquared, multiply, multiply, multiplyTo, set, set, subVector

Methods inherited from class mikera.vectorz.AVector

absolute, add, add, addMultiple, addMultiple, addProduct, addProduct, addWeighted, angle, asList, clamp, clampMax, clampMin, compareTo, copyTo, distance, distanceL1, distanceLinf, distanceSquared, divide, dotProduct, dotProduct, epsilonEquals, epsilonEquals, equals, fill, hashCode, interpolate, interpolate, isFullyMutable, isMutable, isUnitLengthVector, isZeroVector, iterator, join, maxAbsComponent, multiply, negate, normalise, normaliseMaxAbsComponent, projectToPlane, scale, scale, scaleAdd, scaleToMagnitude, set, set, setValues, sub, subMultiple, toArray, toList, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GrowableVector

public GrowableVector(AVector v)

GrowableVector

public GrowableVector()

Method Detail

ofInitialCapacity

public static GrowableVector ofInitialCapacity(int capacity)

Returns a new, empty GrowableVector with the specified initial capacity

getArray

public double[] getArray()

Gets the current underlying array of the GrowableVector. Since this array may be discarded by the GrowableVector, it is not safe to assume that it will continue to be a valid reference if the GrowableVector is changed.

Specified by:

getArray in class ArrayVector

getArrayOffset

public int getArrayOffset()

Specified by:

getArrayOffset in class ArrayVector

length

public int length()

Specified by:

length in interface IVector

Specified by:

length in class AVector

currentCapacity

public int currentCapacity()

ensureCapacity

public void ensureCapacity(int capacity)

get

public double get(int i)

Specified by:

get in interface IVector

Specified by:

get in class AVector

set

public void set(int i,
       double value)

Specified by:

set in interface IVector

Specified by:

set in class AVector

isReference

public boolean isReference()

Description copied from class: AVector

Returns true if this vector is of a type that references other vectors / data.

Overrides:

isReference in class AVector

Returns:

append

public void append(double v)

append

public void append(AVector v)

build

public AVector build()

Function to build a fixed-size vector containing a copy of data once the GrowableVector is constructed

Returns:

clone

public GrowableVector clone()

Description copied from class: AVector

Clones the vector, creating a new copy of all data. The clone is: - not guaranteed to be of the same type. - guaranteed to be fully mutable - guaranteed not to contain a reference (i.e. is a full deep copy)

Overrides:

clone in class AVector

clear

public void clear()