An immutable array of double values, with an API resembling List.

Advantages compared to double[]:

All the many well-known advantages of immutability (read Effective Java, third edition, Item 17).
Has the value-based (not identity-based) equals, hashCode, and toString behavior you expect.
Offers useful operations beyond just get and length, so you don't have to hunt through classes like Arrays and Doubles for them.
Supports a copy-free subArray view, so methods that accept this type don't need to add overloads that accept start and end indexes.
Can be streamed without "breaking the chain": foo.getBarDoubles().stream()....
Access to all collection-based utilities via asList (though at the cost of allocating garbage).

Disadvantages compared to double[]:

Memory footprint has a fixed overhead (about 24 bytes per instance).
Some construction use cases force the data to be copied (though several construction APIs are offered that don't).
Can't be passed directly to methods that expect double[] (though the most common utilities do have replacements here).
Dependency on com.google.common / Guava.

Advantages compared to ImmutableList<Double>:

Improved memory compactness and locality.
Can be queried without allocating garbage.
Access to DoubleStream features (like DoubleStream#sum) using stream() instead of the awkward stream().mapToDouble(v -> v).

Disadvantages compared to ImmutableList<Double>:

Can't be passed directly to methods that expect Iterable, Collection, or List (though the most common utilities do have replacements here, and there is a lazy asList view).

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv static class	ImmutableDoubleArray.AsList
public static class	ImmutableDoubleArray.Builder A builder for `ImmutableDoubleArray` instances; obtained using `ImmutableDoubleArray#builder`.

Modifier and Type	Field and Description
private final double[]	array
private static final ImmutableDoubleArray	EMPTY
private final int	end
private final transient int	start

Access	Constructor and Description
private	ImmutableDoubleArray(double[] array)
private	ImmutableDoubleArray(double[] array, int start, int end)

Method Summary

Modifier and Type	Method and Description
private static boolean	areEqual(double a, double b)
public List<Double>	asList() Returns an immutable view of this array's values as a `List`; note that `double` values are boxed into `Double` instances on demand, which can be very expensive.
public static ImmutableDoubleArray.Builder	builder(int initialCapacity) Returns a new, empty builder for `ImmutableDoubleArray` instances, sized to hold up to `initialCapacity` values without resizing.
public static ImmutableDoubleArray.Builder	builder() Returns a new, empty builder for `ImmutableDoubleArray` instances, with a default initial capacity.
public boolean	contains(double target) Returns `true` if `target` is present at any index in this array.
public static ImmutableDoubleArray	copyOf(double[] values) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	copyOf(Collection<Double> values) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	copyOf(Iterable<Double> values) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	copyOf(DoubleStream stream) Returns an immutable array containing all the values from `stream`, in order.
public boolean	equals(Object the reference object with which to compare. object) Overrides java.lang.Object.equals. Returns `true` if `object` is an `ImmutableDoubleArray` containing the same values as this one, in the same order.
public void	forEach(DoubleConsumer consumer) Invokes `consumer` for each value contained in this array, in order.
public double	get(int index) Returns the `double` value present at the given index.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns an unspecified hash code for the contents of this immutable array.
public int	indexOf(double target) Returns the smallest index for which `get` returns `target`, or `-1` if no such index exists.
public boolean	isEmpty() Returns `true` if there are no values in this array (`length` is zero).
private boolean	isPartialView()
public int	lastIndexOf(double target) Returns the largest index for which `get` returns `target`, or `-1` if no such index exists.
public int	length() Returns the number of values in this array.
public static ImmutableDoubleArray	of() Returns the empty array.
public static ImmutableDoubleArray	of(double e0) Returns an immutable array containing a single value.
public static ImmutableDoubleArray	of(double e0, double e1) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	of(double e0, double e1, double e2) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	of(double e0, double e1, double e2, double e3) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	of(double e0, double e1, double e2, double e3, double e4) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	of(double e0, double e1, double e2, double e3, double e4, double e5) Returns an immutable array containing the given values, in order.
public static ImmutableDoubleArray	of(double first, double... rest) Returns an immutable array containing the given values, in order.
pack-priv Object	readResolve()
private Spliterator.OfDouble	spliterator()
public DoubleStream	stream() Returns a stream over the values in this array, in order.
public ImmutableDoubleArray	subArray(int startIndex, int endIndex) Returns a new immutable array containing the values in the specified range.
public double[]	toArray() Returns a new, mutable copy of this array's values, as a primitive `double[]`.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of this array in the same form as `Arrays#toString(double[])`, for example `"[1, 2, 3]"`.
public ImmutableDoubleArray	trimmed() Returns an immutable array containing the same values as `this` array.
pack-priv Object	writeReplace()

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

array	back to summary
private final double[] array Annotations @SuppressWarnings:Immutable

EMPTY	back to summary
private static final ImmutableDoubleArray EMPTY

end	back to summary
private final int end

start	back to summary
private final transient int start

ImmutableDoubleArray	back to summary
private ImmutableDoubleArray(double[] array)

ImmutableDoubleArray	back to summary
private ImmutableDoubleArray(double[] array, int start, int end)

Method Detail

areEqual	back to summary
private static boolean areEqual(double a, double b)

asList	back to summary
public List<Double> asList() Returns an immutable view of this array's values as a `List`; note that `double` values are boxed into `Double` instances on demand, which can be very expensive. The returned list should be used once and discarded. For any usages beyond that, pass the returned list to `ImmutableList.copyOf` and use that list instead.

builder back to summary

builder	back to summary
public static ImmutableDoubleArray.Builder builder(int initialCapacity) Returns a new, empty builder for `ImmutableDoubleArray` instances, sized to hold up to `initialCapacity` values without resizing. The returned builder is not thread-safe. Performance note: When feasible, `initialCapacity` should be the exact number of values that will be added, if that knowledge is readily available. It is better to guess a value slightly too high than slightly too low. If the value is not exact, the `ImmutableDoubleArray` that is built will very likely occupy more memory than strictly necessary; to trim memory usage, build using `builder.build().trimmed()`.

public static ImmutableDoubleArray.Builder builder(int initialCapacity)

Returns a new, empty builder for ImmutableDoubleArray instances, sized to hold up to initialCapacity values without resizing. The returned builder is not thread-safe.

Performance note: When feasible, initialCapacity should be the exact number of values that will be added, if that knowledge is readily available. It is better to guess a value slightly too high than slightly too low. If the value is not exact, the ImmutableDoubleArray that is built will very likely occupy more memory than strictly necessary; to trim memory usage, build using builder.build().trimmed().

builder back to summary

builder	back to summary
public static ImmutableDoubleArray.Builder builder() Returns a new, empty builder for `ImmutableDoubleArray` instances, with a default initial capacity. The returned builder is not thread-safe. Performance note: The `ImmutableDoubleArray` that is built will very likely occupy more memory than necessary; to trim memory usage, build using `builder.build().trimmed()`.

public static ImmutableDoubleArray.Builder builder()

Returns a new, empty builder for ImmutableDoubleArray instances, with a default initial capacity. The returned builder is not thread-safe.

Performance note: The ImmutableDoubleArray that is built will very likely occupy more memory than necessary; to trim memory usage, build using builder.build().trimmed().

contains	back to summary
public boolean contains(double target) Returns `true` if `target` is present at any index in this array. Values are compared as if by `Double#equals`. Equivalent to `asList().contains(target)`.

copyOf	back to summary
public static ImmutableDoubleArray copyOf(double[] values) Returns an immutable array containing the given values, in order.

copyOf	back to summary
public static ImmutableDoubleArray copyOf(Collection<Double> values) Returns an immutable array containing the given values, in order.

copyOf back to summary

copyOf	back to summary
public static ImmutableDoubleArray copyOf(Iterable<Double> values) Returns an immutable array containing the given values, in order. Performance note: this method delegates to `copyOf(Collection)` if `values` is a `Collection`. Otherwise it creates a `builder` and uses `Builder#addAll(Iterable)`, with all the performance implications associated with that.

public static ImmutableDoubleArray copyOf(Iterable<Double> values)

Returns an immutable array containing the given values, in order.

Performance note: this method delegates to copyOf(Collection) if values is a Collection. Otherwise it creates a builder and uses Builder#addAll(Iterable), with all the performance implications associated with that.

copyOf	back to summary
public static ImmutableDoubleArray copyOf(DoubleStream stream) Returns an immutable array containing all the values from `stream`, in order.

equals back to summary

equals	back to summary
public boolean equals(Object object) Overrides java.lang.Object.equals. Returns `true` if `object` is an `ImmutableDoubleArray` containing the same values as this one, in the same order. Values are compared as if by `Double#equals`. Parameters object:Object Doc from java.lang.Object.equals. the reference object with which to compare. Returns:boolean Doc from java.lang.Object.equals. `true` if this object is the same as the obj argument; `false` otherwise. Annotations @Override

public boolean equals(Object object)

Overrides java.lang.Object.equals.

Returns true if object is an ImmutableDoubleArray containing the same values as this one, in the same order. Values are compared as if by Double#equals.

Parameters

object:Object

Doc from java.lang.Object.equals.

the reference object with which to compare.

Returns:boolean

Doc from java.lang.Object.equals.

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

forEach	back to summary
public void forEach(DoubleConsumer consumer) Invokes `consumer` for each value contained in this array, in order.

get back to summary

get	back to summary
public double get(int index) Returns the `double` value present at the given index. Exceptions IndexOutOfBoundsException: if `index` is negative, or greater than or equal to `length`

public double get(int index)

Returns the double value present at the given index.

Exceptions

IndexOutOfBoundsException:: if index is negative, or greater than or equal to length

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Returns an unspecified hash code for the contents of this immutable array. Returns:int Doc from java.lang.Object.hashCode. a hash code value for this object. Annotations @Override

hashCode

back to summary

public int hashCode()

Overrides java.lang.Object.hashCode.

Returns an unspecified hash code for the contents of this immutable array.

Returns:int

Doc from java.lang.Object.hashCode.

a hash code value for this object.

Annotations

@Override

indexOf	back to summary
public int indexOf(double target) Returns the smallest index for which `get` returns `target`, or `-1` if no such index exists. Values are compared as if by `Double#equals`. Equivalent to `asList().indexOf(target)`.

isEmpty	back to summary
public boolean isEmpty() Returns `true` if there are no values in this array (`length` is zero).

isPartialView	back to summary
private boolean isPartialView()

lastIndexOf	back to summary
public int lastIndexOf(double target) Returns the largest index for which `get` returns `target`, or `-1` if no such index exists. Values are compared as if by `Double#equals`. Equivalent to `asList().lastIndexOf(target)`.

length	back to summary
public int length() Returns the number of values in this array.

of	back to summary
public static ImmutableDoubleArray of() Returns the empty array.

of	back to summary
public static ImmutableDoubleArray of(double e0) Returns an immutable array containing a single value.

of	back to summary
public static ImmutableDoubleArray of(double e0, double e1) Returns an immutable array containing the given values, in order.

of	back to summary
public static ImmutableDoubleArray of(double e0, double e1, double e2) Returns an immutable array containing the given values, in order.

of	back to summary
public static ImmutableDoubleArray of(double e0, double e1, double e2, double e3) Returns an immutable array containing the given values, in order.

of	back to summary
public static ImmutableDoubleArray of(double e0, double e1, double e2, double e3, double e4) Returns an immutable array containing the given values, in order.

of	back to summary
public static ImmutableDoubleArray of(double e0, double e1, double e2, double e3, double e4, double e5) Returns an immutable array containing the given values, in order.

of back to summary

of	back to summary
public static ImmutableDoubleArray of(double first, double... rest) Returns an immutable array containing the given values, in order. The array `rest` must not be longer than `Integer.MAX_VALUE - 1`.

public static ImmutableDoubleArray of(double first, double... rest)

Returns an immutable array containing the given values, in order.

The array rest must not be longer than Integer.MAX_VALUE - 1.

readResolve	back to summary
pack-priv Object readResolve()

spliterator	back to summary
private Spliterator.OfDouble spliterator()

stream	back to summary
public DoubleStream stream() Returns a stream over the values in this array, in order.

subArray back to summary

subArray	back to summary
public ImmutableDoubleArray subArray(int startIndex, int endIndex) Returns a new immutable array containing the values in the specified range. Performance note: The returned array has the same full memory footprint as this one does (no actual copying is performed). To reduce memory usage, use `subArray(start, end).trimmed()`.

public ImmutableDoubleArray subArray(int startIndex, int endIndex)

Returns a new immutable array containing the values in the specified range.

Performance note: The returned array has the same full memory footprint as this one does (no actual copying is performed). To reduce memory usage, use subArray(start, end).trimmed().

toArray	back to summary
public double[] toArray() Returns a new, mutable copy of this array's values, as a primitive `double[]`.

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Returns a string representation of this array in the same form as `Arrays#toString(double[])`, for example `"[1, 2, 3]"`. Returns:String Doc from java.lang.Object.toString. a string representation of the object. Annotations @Override

public String toString()

Overrides java.lang.Object.toString.

Returns a string representation of this array in the same form as Arrays#toString(double[]), for example "[1, 2, 3]".

Returns:String

Doc from java.lang.Object.toString.

a string representation of the object.

Annotations

@Override

trimmed	back to summary
public ImmutableDoubleArray trimmed() Returns an immutable array containing the same values as `this` array. This is logically a no-op, and in some circumstances `this` itself is returned. However, if this instance is a `subArray` view of a larger array, this method will copy only the appropriate range of values, resulting in an equivalent array with a smaller memory footprint.

writeReplace	back to summary
pack-priv Object writeReplace()

com.google.common.primitives back to summary

pack-priv Class ImmutableDoubleArray.AsList

Class Inheritance

extends AbstractList<Double>
implements RandomAccess, Serializable

java.lang.Object
java.util.AbstractCollection
java.util.AbstractList
com.google.common.primitives.ImmutableDoubleArray.AsList

All Implemented Interfaces

java.io.Serializable, java.util.RandomAccess

Field Summary

Modifier and Type	Field and Description
private final ImmutableDoubleArray	parent

Inherited from java.util.AbstractList:: modCount

Constructor Summary

Access	Constructor and Description
private	AsList(ImmutableDoubleArray parent)

Method Summary

Modifier and Type	Method and Description
public boolean	contains(Object element whose presence in this list is to be tested target) Overrides java.util.AbstractCollection.contains. Implements java.util.List.contains, java.util.Collection.contains. Returns `true` if this list contains the specified element.
public boolean	equals(Object the object to be compared for equality with this list object) Overrides java.util.AbstractList.equals. Implements java.util.List.equals, java.util.Collection.equals. Compares the specified object with this list for equality.
public Double	get(int index of the element to return index) Implements abstract java.util.AbstractList.get. Implements java.util.List.get. Returns the element at the specified position in this list.
public int	hashCode() Overrides java.util.AbstractList.hashCode. Implements java.util.List.hashCode, java.util.Collection.hashCode. Returns the hash code value for this list.
public int	indexOf(Object element to search for target) Overrides java.util.AbstractList.indexOf. Implements java.util.List.indexOf. Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
public int	lastIndexOf(Object element to search for target) Overrides java.util.AbstractList.lastIndexOf. Implements java.util.List.lastIndexOf. Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
public int	size() Implements abstract java.util.AbstractCollection.size. Implements java.util.List.size, java.util.Collection.size. Returns the number of elements in this list.
public Spliterator<Double>	spliterator() Overrides default java.util.List.spliterator, java.util.Collection.spliterator. Creates a `Spliterator` over the elements in this list.
public List<Double>	subList(int low endpoint (inclusive) of the subList fromIndex, int high endpoint (exclusive) of the subList toIndex) Overrides java.util.AbstractList.subList. Implements java.util.List.subList. Returns a view of the portion of this list between the specified `fromIndex`, inclusive, and `toIndex`, exclusive.
public String	toString() Overrides java.util.AbstractCollection.toString. Returns a string representation of this collection.

Inherited from java.util.AbstractList:: add add addAll clear iterator listIterator listIterator remove removeRange set

Field Detail

parent	back to summary
private final ImmutableDoubleArray parent

Constructor Detail

AsList	back to summary
private AsList(ImmutableDoubleArray parent)

Method Detail

contains back to summary

contains	back to summary
public boolean contains(Object target) Overrides java.util.AbstractCollection.contains. Implements java.util.List.contains, java.util.Collection.contains. Doc from java.util.List.contains. Returns `true` if this list contains the specified element. More formally, returns `true` if and only if this list contains at least one element `e` such that `Objects.equals(o, e)`. Parameters target:Object element whose presence in this list is to be tested Returns:boolean `true` if this list contains the specified element Annotations @Override

public boolean contains(Object target)

Overrides java.util.AbstractCollection.contains.

Implements java.util.List.contains, java.util.Collection.contains.

Doc from java.util.List.contains.

Returns true if this list contains the specified element. More formally, returns true if and only if this list contains at least one element e such that Objects.equals(o, e).

Parameters

target:Object: element whose presence in this list is to be tested

Returns:boolean

true if this list contains the specified element

Annotations

@Override

equals back to summary

public boolean equals(Object object)

Overrides java.util.AbstractList.equals.

Implements java.util.List.equals, java.util.Collection.equals.

Doc from java.util.AbstractList.equals.

Compares the specified object with this list for equality. Returns true if and only if the specified object is also a list, both lists have the same size, and all corresponding pairs of elements in the two lists are equal. (Two elements e1 and e2 are equal if (e1==null ? e2==null : e1.equals(e2)).) In other words, two lists are defined to be equal if they contain the same elements in the same order.

Parameters

object:Object: the object to be compared for equality with this list

Returns:boolean

true if the specified object is equal to this list

Annotations

@Override

get

back to summary

public Double get(int index)

Implements abstract java.util.AbstractList.get.

Implements java.util.List.get.

Doc from java.util.AbstractList.get.

Returns the element at the specified position in this list.

Parameters

index:int

Doc from java.util.List.get.

index of the element to return

Returns:Double

Doc from java.util.List.get.

the element at the specified position in this list

Annotations

@Override

hashCode

back to summary

public int hashCode()

Overrides java.util.AbstractList.hashCode.

Implements java.util.List.hashCode, java.util.Collection.hashCode.

Doc from java.util.AbstractList.hashCode.

Returns the hash code value for this list.

Returns:int

the hash code value for this list

Annotations

@Override

indexOf back to summary

public int indexOf(Object target)

Overrides java.util.AbstractList.indexOf.

Implements java.util.List.indexOf.

Doc from java.util.AbstractList.indexOf.

Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element. More formally, returns the lowest index i such that Objects.equals(o, get(i)), or -1 if there is no such index.

Parameters

target:Object

Doc from java.util.List.indexOf.

element to search for

Returns:int

Doc from java.util.List.indexOf.

the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element

Annotations

@Override

lastIndexOf back to summary

public int lastIndexOf(Object target)

Overrides java.util.AbstractList.lastIndexOf.

Implements java.util.List.lastIndexOf.

Doc from java.util.AbstractList.lastIndexOf.

Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element. More formally, returns the highest index i such that Objects.equals(o, get(i)), or -1 if there is no such index.

Parameters

target:Object

Doc from java.util.List.lastIndexOf.

element to search for

Returns:int

Doc from java.util.List.lastIndexOf.

the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element

Annotations

@Override

size back to summary

public int size()

Implements abstract java.util.AbstractCollection.size.

Implements java.util.List.size, java.util.Collection.size.

Doc from java.util.List.size.

Returns the number of elements in this list. If this list contains more than Integer.MAX_VALUE elements, returns Integer.MAX_VALUE.

Returns:int

the number of elements in this list

Annotations

@Override

spliterator back to summary

public Spliterator<Double> spliterator()

Overrides default java.util.List.spliterator, java.util.Collection.spliterator.

Doc from java.util.List.spliterator.

Creates a Spliterator over the elements in this list.

The Spliterator reports Spliterator#SIZED and Spliterator#ORDERED. Implementations should document the reporting of additional characteristic values.

Returns:Spliterator<Double>

a Spliterator over the elements in this list

Annotations

@Override

subList back to summary

public List<Double> subList(int fromIndex, int toIndex)

Overrides java.util.AbstractList.subList.

Implements java.util.List.subList.

Doc from java.util.AbstractList.subList.

Returns a view of the portion of this list between the specified fromIndex, inclusive, and toIndex, exclusive. (If fromIndex and toIndex are equal, the returned list is empty.) The returned list is backed by this list, so non-structural changes in the returned list are reflected in this list, and vice-versa. The returned list supports all of the optional list operations supported by this list.

This method eliminates the need for explicit range operations (of the sort that commonly exist for arrays). Any operation that expects a list can be used as a range operation by passing a subList view instead of a whole list. For example, the following idiom removes a range of elements from a list:

list.subList(from, to).clear();

Similar idioms may be constructed for indexOf and lastIndexOf, and all of the algorithms in the Collections class can be applied to a subList.

The semantics of the list returned by this method become undefined if the backing list (i.e., this list) is structurally modified in any way other than via the returned list. (Structural modifications are those that change the size of this list, or otherwise perturb it in such a fashion that iterations in progress may yield incorrect results.)

Parameters

fromIndex:int

Doc from java.util.List.subList.

low endpoint (inclusive) of the subList

toIndex:int

Doc from java.util.List.subList.

high endpoint (exclusive) of the subList

Returns:List<Double>

Doc from java.util.List.subList.

a view of the specified range within this list

Annotations

@Override

toString back to summary

public String toString()

Overrides java.util.AbstractCollection.toString.

Doc from java.util.AbstractCollection.toString.

Returns a string representation of this collection. The string representation consists of a list of the collection's elements in the order they are returned by its iterator, enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space). Elements are converted to strings as by String#valueOf(Object).

Returns:String

a string representation of this collection

Annotations

@Override

com.google.common.primitives back to summary

public final Class ImmutableDoubleArray.Builder

Class Inheritance

extends Object

java.lang.Object
com.google.common.primitives.ImmutableDoubleArray.Builder

A builder for ImmutableDoubleArray instances; obtained using ImmutableDoubleArray#builder.

Field Summary

Modifier and Type	Field and Description
private double[]	array
private int	count

Constructor Summary

Access	Constructor and Description
pack-priv	Builder(int initialCapacity)

Method Summary

Modifier and Type	Method and Description
public ImmutableDoubleArray.Builder	add(double value) Appends `value` to the end of the values the built `ImmutableDoubleArray` will contain.
public ImmutableDoubleArray.Builder	addAll(double[] values) Appends `values`, in order, to the end of the values the built `ImmutableDoubleArray` will contain.
public ImmutableDoubleArray.Builder	addAll(Iterable<Double> values) Appends `values`, in order, to the end of the values the built `ImmutableDoubleArray` will contain.
public ImmutableDoubleArray.Builder	addAll(Collection<Double> values) Appends `values`, in order, to the end of the values the built `ImmutableDoubleArray` will contain.
public ImmutableDoubleArray.Builder	addAll(DoubleStream stream) Appends all values from `stream`, in order, to the end of the values the built `ImmutableDoubleArray` will contain.
public ImmutableDoubleArray.Builder	addAll(ImmutableDoubleArray values) Appends `values`, in order, to the end of the values the built `ImmutableDoubleArray` will contain.
public ImmutableDoubleArray	build() Returns a new immutable array.
private void	ensureRoomFor(int numberToAdd)
private static int	expandedCapacity(int oldCapacity, int minCapacity)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

array	back to summary
private double[] array

count	back to summary
private int count

Constructor Detail

Builder	back to summary
pack-priv Builder(int initialCapacity)

Method Detail

add back to summary

public ImmutableDoubleArray.Builder add(double value)

Appends value to the end of the values the built ImmutableDoubleArray will contain.

Annotations

@CanIgnoreReturnValue

addAll back to summary

public ImmutableDoubleArray.Builder addAll(double[] values)

Appends values, in order, to the end of the values the built ImmutableDoubleArray will contain.

Annotations

@CanIgnoreReturnValue

addAll back to summary

public ImmutableDoubleArray.Builder addAll(Iterable<Double> values)

Appends values, in order, to the end of the values the built ImmutableDoubleArray will contain.

Annotations

@CanIgnoreReturnValue

addAll back to summary

public ImmutableDoubleArray.Builder addAll(Collection<Double> values)

Appends values, in order, to the end of the values the built ImmutableDoubleArray will contain.

Annotations

@CanIgnoreReturnValue

addAll back to summary

public ImmutableDoubleArray.Builder addAll(DoubleStream stream)

Appends all values from stream, in order, to the end of the values the built ImmutableDoubleArray will contain.

Annotations

@CanIgnoreReturnValue

addAll back to summary

public ImmutableDoubleArray.Builder addAll(ImmutableDoubleArray values)

Appends values, in order, to the end of the values the built ImmutableDoubleArray will contain.

Annotations

@CanIgnoreReturnValue

build back to summary

public ImmutableDoubleArray build()

Returns a new immutable array. The builder can continue to be used after this call, to append more values and build again.

Performance note: the returned array is backed by the same array as the builder, so no data is copied as part of this step, but this may occupy more memory than strictly necessary. To copy the data to a right-sized backing array, use .build().trimmed().

ensureRoomFor	back to summary
private void ensureRoomFor(int numberToAdd)

expandedCapacity	back to summary
private static int expandedCapacity(int oldCapacity, int minCapacity)