org.sellcom.core.collection

Class SparseDoubleArray

java.lang.Object

org.sellcom.core.collection.SparseDoubleArray

All Implemented Interfaces:

Cloneable

public class SparseDoubleArray
extends Object
implements Cloneable

Sparse array mapping integers to doubles.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
SparseDoubleArray() Creates an empty sparse array.
SparseDoubleArray(int initialCapacity) Creates an empty sparse array with the given capacity.

Method Summary

Modifier and Type	Method and Description
void	clear() Removes all elements from this array.
SparseDoubleArray	clone()
boolean	containsElement(double element, double tolerance) Checks whether this array contains the given element.
boolean	containsIndex(int index) Checks whether this array contains the given index.
void	ensureCapacity(int minCapacity) Increases the capacity of this array, if necessary, to ensure that it can hold at least the given number of elements.
void	forEach(BiConsumer<Integer,Double> action) Performs the given action for each element in this array until all elements have been processed or the action throws an exception.
double	getOrDefault(int index, double defaultValue) Returns the element at the given index in this array.
int	indexOf(double element, double tolerance) Returns the index of the first occurrence of the specified element in this array.
boolean	isEmpty() Checks whether this array is empty.
int	lastIndexOf(double element, double tolerance) Returns the index of the last occurrence of the specified element in this array.
double	remove(int index, double defaultValue) Removes and returns the element at the given index in this array.
void	set(int index, double value) Sets the element at the given index in this array to the given value.
void	setIfAbsent(int index, double value) If there is no element in this array at the given index, sets it to the given value.
int	size() Returns the number of elements in this array.
String	toString()
void	trimToSize() Trims the capacity of this array to its current size.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SparseDoubleArray

public SparseDoubleArray()

Creates an empty sparse array.

Since:

1.0

SparseDoubleArray

public SparseDoubleArray(int initialCapacity)

Creates an empty sparse array with the given capacity.

Since:

1.0

Method Detail

clear

public void clear()

Removes all elements from this array.

Since:

1.0

clone

public SparseDoubleArray clone()

Overrides:

clone in class Object

containsElement

public boolean containsElement(double element,
                               double tolerance)

Checks whether this array contains the given element.

Throws:

IllegalArgumentException - if tolerance is negative

Since:

1.0

containsIndex

public boolean containsIndex(int index)

Checks whether this array contains the given index.

Throws:

IllegalArgumentException - if index is negative

Since:

1.0

ensureCapacity

public void ensureCapacity(int minCapacity)

Increases the capacity of this array, if necessary, to ensure that it can hold at least the given number of elements.

Throws:

IllegalArgumentException - if minCapacity is negative

Since:

1.0

forEach

public void forEach(BiConsumer<Integer,Double> action)

Performs the given action for each element in this array until all elements have been processed or the action throws an exception. Actions are performed in the order of the element indices. Exceptions thrown by the action are relayed to the caller.

Throws:

IllegalArgumentException - if action is null

Since:

1.0

getOrDefault

public double getOrDefault(int index,
                           double defaultValue)

Returns the element at the given index in this array. Returns the given default value if there is no element in this array at the given index.

Throws:

IllegalArgumentException - if index is negative

Since:

1.0

indexOf

public int indexOf(double element,
                   double tolerance)

Returns the index of the first occurrence of the specified element in this array. Returns -1 if this array does not contain the element.

Throws:

IllegalArgumentException - if tolerance is negative

Since:

1.0

isEmpty

public boolean isEmpty()

Checks whether this array is empty.

Since:

1.0

lastIndexOf

public int lastIndexOf(double element,
                       double tolerance)

Returns the index of the last occurrence of the specified element in this array. Returns -1 if this array does not contain the element.

Throws:

IllegalArgumentException - if tolerance is negative

Since:

1.0

remove

public double remove(int index,
                     double defaultValue)

Removes and returns the element at the given index in this array. Returns the given default value if there is no element in this array at the given index.

Throws:

IllegalArgumentException - if index is negative

Since:

1.0

set

public void set(int index,
                double value)

Sets the element at the given index in this array to the given value.

Throws:

IllegalArgumentException - if index is negative

Since:

1.0

setIfAbsent

public void setIfAbsent(int index,
                        double value)

If there is no element in this array at the given index, sets it to the given value.

Throws:

IllegalArgumentException - if index is negative

Since:

1.0

size

public int size()

Returns the number of elements in this array.

Since:

1.0

toString

public String toString()

Overrides:

toString in class Object

trimToSize

public void trimToSize()

Trims the capacity of this array to its current size.

Since:

1.0