模块 java.base
包 java.util.concurrent.atomic

类 DoubleAdder

java.lang.Object
java.lang.Number
java.util.concurrent.atomic.DoubleAdder
所有已实现的接口：
Serializable
public class DoubleAdder extends Number implements Serializable
一个或多个变量一起保持最初为零的 double 总和。当更新（方法 add(double) ）在线程之间发生争用时，变量集可能会动态增长以减少争用。方法 sum() （或等同于 doubleValue() ）返回维护总和的变量的当前总和。不能保证线程内或跨线程的累积顺序。因此，如果需要数值稳定性，则此类可能不适用，尤其是在组合数量级大不相同的值时。

当多个线程更新一个公共值时，该类通常比备选方案更可取，该公共值用于诸如经常更新但读取频率较低的摘要统计信息之类的目的。

此类扩展了 Number ，但 not 定义了诸如 equals、hashCode 和 compareTo 之类的方法，因为实例预计会发生变异，因此不能用作集合键。

自从：
1.8
参见：

  • 构造方法详细信息

    • DoubleAdder

      public DoubleAdder()
      创建一个初始和为零的新加法器。

  • 方法详情

    • add

      public void add(double x)
      添加给定的值。
      参数：
      x - 要添加的值

    • sum

      public double sum()
      返回当前总和。返回值为NOT一个原子快照；在没有并发更新的情况下调用会返回准确的结果，但在计算总和时发生的并发更新可能不会被合并。此外，由于浮点运算不是严格关联的，因此返回的结果不必与在对单个变量的一系列顺序更新中获得的值相同。
      返回：
      总和

    • reset

      public void reset()
      重置保持总和为零的变量。此方法可能是创建新加法器的有用替代方法，但仅在没有并发更新时才有效。因为这种方法本质上是活泼的，所以只应在已知没有线程同时更新时使用它。

    • sumThenReset

      public double sumThenReset()
      等效于 sum() 后跟 reset() 。该方法可以应用于例如多线程计算之间的静止点期间。如果有与此方法并发的更新，则返回值not保证是重置前发生的最终值。
      返回：
      总和

    • toString

      public String  toString()
      返回 sum() 的字符串表示形式。
      重写：
      toString 在类 Object 中
      返回：
      sum() 的字符串表示形式

    • doubleValue

      public double doubleValue()
      相当于 sum() 。
      指定者：
      doubleValue 在类 Number 中
      返回：
      总和

    • longValue

      public long longValue()
      在缩小基元转换后将 sum() 作为 long 返回。
      指定者：
      longValue 在类 Number 中
      返回：
      转换为类型 long 后此对象表示的数值。

    • intValue

      public int intValue()
      在缩小基元转换后将 sum() 作为 int 返回。
      指定者：
      intValue 在类 Number 中
      返回：
      转换为类型 int 后此对象表示的数值。

    • floatValue

      public float floatValue()
      在缩小基元转换后将 sum() 作为 float 返回。
      指定者：
      floatValue 在类 Number 中
      返回：
      转换为类型 float 后此对象表示的数值。