compact1, compact2, compact3

java.util.concurrent.atomic

Класс DoubleAdder

java.lang. Объект

java.lang. Число

java.util.concurrent.atomic. DoubleAdder

Все Реализованные Интерфейсы:

Сериализуемый

public class DoubleAdder
extends Number
implements Serializable

Одна или более переменных, которые вместе поддерживают первоначально нуль double сумма. Когда обновления (метод add(double)) спорятся через потоки, набор переменных может вырасти динамически, чтобы уменьшить конкуренцию. Метод sum() (или, эквивалентно doubleValue()) возвращает текущее общее количество, объединенное через переменные, поддерживающие сумму. Порядок накопления в пределах или через потоки не гарантируется. Таким образом этот class, возможно, не применим, если числовая устойчивость требуется, особенно комбинируя значения существенно различных порядков величины.

Этот class обычно предпочтителен для альтернатив, когда многократные потоки обновляют общую ценность, которая используется в целях, таких как сводные статистические данные, которые часто обновляются, но менее часто читаются.

Этот class расширяется Number, но не определяет методы такой как equals, hashCode и compareTo потому что экземпляры, как ожидают, будут видоизменены, и так не полезны как ключи набора.

С тех пор:

1.8

См. Также:

Сериализированная Форма

Сводка конструктора

Конструкторы

Конструктор и Описание
DoubleAdder() Создает новый сумматор с начальной суммой нуля.

Сводка метода

Модификатор и Тип	Метод и Описание
void	add(double x) Добавляет данное значение.
double	doubleValue() Эквивалентный sum().
float	floatValue() Возвраты sum() как a float после сужающегося примитивного преобразования.
int	intValue() Возвраты sum() как int после сужающегося примитивного преобразования.
long	longValue() Возвраты sum() как a long после сужающегося примитивного преобразования.
void	reset() Переменные сбросов, поддерживающие сумму, чтобы обнулить.
double	sum() Возвращает текущую сумму.
double	sumThenReset() Эквивалентный в действительности sum() сопровождаемый reset().
Строка	toString() Возвращает Строковое представление sum().

Методы, наследованные от class java.lang. Число

byteValue, shortValue

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

DoubleAdder

public DoubleAdder()

Создает новый сумматор с начальной суммой нуля.

Деталь метода

добавить

public void add(double x)

Добавляет данное значение.

Параметры:

x - значение, чтобы добавить

сумма

public double sum()

Возвращает текущую сумму. Возвращенное значение НЕ является атомарным снимком; вызов в отсутствие параллельных обновлений возвращает точный результат, но параллельные обновления, которые происходят, в то время как сумма вычисляется, не могли бы быть включены. Кроме того, потому что арифметика с плавающей точкой не строго ассоциативна, возвращенный результат не должен быть идентичным значению, которое было бы получено в последовательном ряде обновлений к единственной переменной.

Возвраты:

сумма

сброс

public void reset()

Переменные сбросов, поддерживающие сумму, чтобы обнулить. Этот метод может быть полезной альтернативой созданию нового сумматора, но только эффективен, если нет никаких параллельных обновлений. Поскольку этот метод является свойственно колоритным, он должен только использоваться, когда известно, что никакие потоки одновременно не обновляют.

sumThenReset

public double sumThenReset()

Эквивалентный в действительности sum() сопровождаемый reset(). Этот метод может применяться например во время статических точек между многопоточными вычислениями. Если будут обновления, параллельные с этим методом, то возвращенное значение, как гарантируют, не будет заключительным значением, происходящим перед сбросом.

Возвраты:

сумма

toString

public String toString()

Возвращает Строковое представление sum().

Переопределения:

toString в class Object

Возвраты:

Строковое представление sum()

doubleValue

public double doubleValue()

Эквивалентный sum().

Определенный:

doubleValue в class Number

Возвраты:

сумма

longValue

public long longValue()

Возвраты sum() как a long после сужающегося примитивного преобразования.

Определенный:

longValue в class Number

Возвраты:

числовое значение, представленное этим объектом после преобразования в тип long.

intValue

public int intValue()

Возвраты sum() как int после сужающегося примитивного преобразования.

Определенный:

intValue в class Number

Возвраты:

числовое значение, представленное этим объектом после преобразования в тип int.

floatValue

public float floatValue()

Возвраты sum() как a float после сужающегося примитивного преобразования.

Определенный:

floatValue в class Number

Возвраты:

числовое значение, представленное этим объектом после преобразования в тип float.