One or more variables that together maintain an initially zero double sum. When updates (method add) are contended across threads, the set of variables may grow dynamically to reduce contention. Method sum (or, equivalently doubleValue) returns the current total combined across the variables maintaining the sum. The order of accumulation within or across threads is not guaranteed. Thus, this class may not be applicable if numerical stability is required, especially when combining values of substantially different orders of magnitude.

This class is usually preferable to alternatives when multiple threads update a common value that is used for purposes such as summary statistics that are frequently updated but less frequently read.

This class extends Number, but does not define methods such as equals, hashCode and compareTo because instances are expected to be mutated, and so are not useful as collection keys.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	DoubleAdder.SerializationProxy Serialization proxy, used to avoid reference to the non-public Striped64 superclass in serialized forms.

Field Summary

Modifier and Type	Field and Description
private static final long	serialVersionUID Hides java.lang.Number.serialVersionUID.

Inherited from java.util.concurrent.atomic.Striped64:: base cells cellsBusy NCPU

Constructor Summary

Access	Constructor and Description
public	DoubleAdder() Creates a new adder with initial sum of zero.

Method Summary

Modifier and Type	Method and Description
public void	add(double the value to add x) Adds the given value.
public double	Returns: the sum doubleValue() Implements abstract java.lang.Number.doubleValue. Equivalent to `sum`.
public float	floatValue() Implements abstract java.lang.Number.floatValue. Returns the `sum` as a `float` after a narrowing primitive conversion.
public int	intValue() Implements abstract java.lang.Number.intValue. Returns the `sum` as an `int` after a narrowing primitive conversion.
public long	longValue() Implements abstract java.lang.Number.longValue. Returns the `sum` as a `long` after a narrowing primitive conversion.
private void	readObject(ObjectInputStream the stream s)
public void	reset() Resets variables maintaining the sum to zero.
public double	Returns: the sum sum() Returns the current sum.
public double	Returns: the sum sumThenReset() Equivalent in effect to `sum` followed by `reset`.
public String	Returns: the String representation of the `sum` toString() Overrides java.lang.Object.toString. Returns the String representation of the `sum`.
private Object	Returns: a `SerializationProxy` representing the state of this instance writeReplace() Returns a SerializationProxy representing the state of this instance.

Inherited from java.util.concurrent.atomic.Striped64:: advanceProbe casBase casCellsBusy doubleAccumulate getAndSetBase getProbe longAccumulate

Field Detail

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.lang.Number.serialVersionUID.

Constructor Detail

DoubleAdder	back to summary
public DoubleAdder() Creates a new adder with initial sum of zero.

Method Detail

add	back to summary
public void add(double x) Adds the given value. Parameters x:double the value to add

add

back to summary

public void add(double x)

Adds the given value.

Parameters

x:double: the value to add

doubleValue back to summary

doubleValue	back to summary
public double doubleValue() Implements abstract java.lang.Number.doubleValue. Equivalent to `sum`. Returns:double the sum

public double doubleValue()

Implements abstract java.lang.Number.doubleValue.

Equivalent to sum.

Returns:double: the sum

floatValue back to summary

floatValue	back to summary
public float floatValue() Implements abstract java.lang.Number.floatValue. Returns the `sum` as a `float` after a narrowing primitive conversion.

public float floatValue()

Implements abstract java.lang.Number.floatValue.

Returns the sum as a float after a narrowing primitive conversion.

intValue back to summary

intValue	back to summary
public int intValue() Implements abstract java.lang.Number.intValue. Returns the `sum` as an `int` after a narrowing primitive conversion.

public int intValue()

Implements abstract java.lang.Number.intValue.

Returns the sum as an int after a narrowing primitive conversion.

longValue back to summary

longValue	back to summary
public long longValue() Implements abstract java.lang.Number.longValue. Returns the `sum` as a `long` after a narrowing primitive conversion.

public long longValue()

Implements abstract java.lang.Number.longValue.

Returns the sum as a long after a narrowing primitive conversion.

readObject	back to summary
private void readObject(ObjectInputStream s) throws InvalidObjectException Parameters s:ObjectInputStream the stream Exceptions InvalidObjectException: always

reset	back to summary
public void reset() Resets variables maintaining the sum to zero. This method may be a useful alternative to creating a new adder, but is only effective if there are no concurrent updates. Because this method is intrinsically racy, it should only be used when it is known that no threads are concurrently updating.

sum	back to summary
public double sum() Returns the current sum. The returned value is NOT an atomic snapshot; invocation in the absence of concurrent updates returns an accurate result, but concurrent updates that occur while the sum is being calculated might not be incorporated. Also, because floating-point arithmetic is not strictly associative, the returned result need not be identical to the value that would be obtained in a sequential series of updates to a single variable. Returns:double the sum

sum

back to summary

public double sum()

Returns the current sum. The returned value is NOT an atomic snapshot; invocation in the absence of concurrent updates returns an accurate result, but concurrent updates that occur while the sum is being calculated might not be incorporated. Also, because floating-point arithmetic is not strictly associative, the returned result need not be identical to the value that would be obtained in a sequential series of updates to a single variable.

Returns:double: the sum

sumThenReset back to summary

sumThenReset	back to summary
public double sumThenReset() Equivalent in effect to `sum` followed by `reset`. This method may apply for example during quiescent points between multithreaded computations. If there are updates concurrent with this method, the returned value is not guaranteed to be the final value occurring before the reset. Returns:double the sum

public double sumThenReset()

Equivalent in effect to sum followed by reset. This method may apply for example during quiescent points between multithreaded computations. If there are updates concurrent with this method, the returned value is not guaranteed to be the final value occurring before the reset.

Returns:double: the sum

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Returns the String representation of the `sum`. Returns:String the String representation of the `sum`

public String toString()

Overrides java.lang.Object.toString.

Returns the String representation of the sum.

Returns:String: the String representation of the sum

writeReplace back to summary

writeReplace	back to summary
private Object writeReplace() Returns a SerializationProxy representing the state of this instance. Returns:Object a `SerializationProxy` representing the state of this instance

private Object writeReplace()

Returns a SerializationProxy representing the state of this instance.

Returns:Object: a SerializationProxy representing the state of this instance

java.util.concurrent.atomic back to summary

private Class DoubleAdder.SerializationProxy

Class Inheritance

extends Object
implements Serializable

java.lang.Object
java.util.concurrent.atomic.DoubleAdder.SerializationProxy

All Implemented Interfaces

java.io.Serializable

Serialization proxy, used to avoid reference to the non-public Striped64 superclass in serialized forms.

Field Summary

Modifier and Type	Field and Description
private static final long	serialVersionUID
private final double	value The current value returned by sum().

Constructor Summary

Access	Constructor and Description
pack-priv	SerializationProxy(DoubleAdder a)

Method Summary

Modifier and Type	Method and Description
private Object	Returns: a `DoubleAdder` object with initial state held by this proxy readResolve() Returns a `DoubleAdder` object with initial state held by this proxy.

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

Field Detail

serialVersionUID	back to summary
private static final long serialVersionUID

value	back to summary
private final double value The current value returned by sum().

Constructor Detail

SerializationProxy	back to summary
pack-priv SerializationProxy(DoubleAdder a)

Method Detail

readResolve back to summary

readResolve	back to summary
private Object readResolve() Returns a `DoubleAdder` object with initial state held by this proxy. Returns:Object a `DoubleAdder` object with initial state held by this proxy

private Object readResolve()

Returns a DoubleAdder object with initial state held by this proxy.

Returns:Object: a DoubleAdder object with initial state held by this proxy

public Class DoubleAdder

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DoubleAdder.SerializationProxy

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail