compact1, compact2, compact3

java.util.concurrent.atomic

Class DoubleAdder

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.DoubleAdder

All Implemented Interfaces:

Serializable

public class DoubleAdder
extends Number
implements Serializable

一个或多个变量一起保持最初的零 double总和。当更新（方法 add(double)）主张跨线程、变量的设置可以动态增长以减少争用。方法 sum()（或者，等价地 doubleValue()）返回当前的总变量之间保持的总和。在或跨线程内的积累的顺序是不保证。因此，这个类可能不适用，如果需要的数值稳定性，特别是当结合的值的基本上不同的数量级。

这个类通常是最好的替代方案时，多个线程更新一个共同的价值，是用来的目的，如汇总统计，经常更新，但不经常阅读。

这类Number延伸，但不定义方法如equals，hashCode和compareTo因为情况预计将发生突变，而不是用作收集钥匙。

从以下版本开始：

一点八

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
DoubleAdder() 创建一个新的加法器，初始和为零。

方法摘要

Modifier and Type	Method and Description
void	add(double x) 添加给定值。
double	doubleValue() 相当于 sum()。
float	floatValue() 作为一个窄化转换后 float返回 sum()。
int	intValue() 作为一个窄化转换后， int返回 sum()。
long	longValue() 作为一个窄化转换后 long返回 sum()。
void	reset() 重置变量保持总和为零。
double	sum() 返回当前的和。
double	sumThenReset() 相当的效果 sum()随后 reset()。
String	toString() 返回的字符串表示形式的 sum()。

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

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

Constructor Detail

DoubleAdder

public DoubleAdder()

创建一个新的加法器，初始和为零。

方法详细信息

add

public void add(double x)

添加给定值。

参数

x -价值增加

sum

public double sum()

返回当前的和。返回的值不是一个原子快照；调用在并发更新的情况下返回一个准确的结果，但同时发生的更新，而正在计算的总和可能不被纳入。此外，由于浮点算术是不严格关联的，返回的结果不需要是相同的值，将获得在一个连续的一系列更新到一个单一的变量。

结果

的总和

reset

public void reset()

重置变量保持总和为零。此方法可能是一个有用的替代，以创建一个新的加法器，但只有有效的，如果有没有并发更新。因为这种方法本质上是活泼的，只能当它是已知的，没有线程同时更新。

sumThenReset

public double sumThenReset()

相当的效果 sum()随后 reset()。此方法可以应用于多线程计算之间的静态点时的例子。如果有更新并发的这种方法，返回的值不保证是在复位之前发生的最终值。

结果

的总和

toString

public String toString()

返回的字符串表示形式的 sum()。

重写：

toString 方法重写，继承类 Object

结果

sum()的字符串表示形式

doubleValue

public double doubleValue()

相当于 sum()。

Specified by:

doubleValue 方法重写，继承类 Number

结果

的总和

longValue

public long longValue()

作为一个窄化转换后 long返回 sum()。

Specified by:

longValue 方法重写，继承类 Number

结果

这代表的对象转换为数值型 long后。

intValue

public int intValue()

作为一个窄化转换后， int返回 sum()。

Specified by:

intValue 方法重写，继承类 Number

结果

这代表的对象转换为数值型 int后。

floatValue

public float floatValue()

作为一个窄化转换后 float返回 sum()。

Specified by:

floatValue 方法重写，继承类 Number

结果

这代表的对象转换为数值型 float后。