Класс LongSummaryStatistics

java.lang.Object
- java.util.LongSummaryStatistics

Все реализованные интерфейсы:: IntConsumer, LongConsumer

public class LongSummaryStatistics
extends Object
implements LongConsumer, IntConsumer

Объект состояния для сбора статистических данных, таких как количество, минимум, максимум, сумма и среднее значение.

Этот класс разработан для работы с (хотя и не требует) потоками. Например, вы можете вычислить сводные статистические данные по потоку long с помощью:

LongSummaryStatistics stats = longStream.collect(LongSummaryStatistics::new,
                                                  LongSummaryStatistics::accept,
                                                  LongSummaryStatistics::combine);

LongSummaryStatistics может использоваться в качестве цели агрегации Stream.collect(Collector) для потока. Например:

LongSummaryStatistics stats = people.stream()
                                     .collect(Collectors.summarizingLong(Person::getAge));

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

Примечание по реализации:: Эта реализация не потокобезопасна. Однако, ее безопасно использовать с Collectors.toLongStatistics() в параллельном потоке, так как параллельная реализация Stream.collect() обеспечивает необходимое разделение, изоляцию и объединение результатов для безопасной и эффективной параллельной обработки.
Эта реализация не проверяет переполнение суммы.
С момента:: 1.8

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

Конструктор и описание
`LongSummaryStatistics()` Создаёт пустой экземпляр с нулевым количеством, нулевой суммой, `Long.MAX_VALUE` минимальным значением, `Long.MIN_VALUE` максимальным значением и нулевым средним значением.

Методы

Модификатор и тип	Метод и описание
`void`	`accept(int value)` Записывает новое `int` значение в сводную информацию.
`void`	`accept(long value)` Записывает новое `long` значение в сводную информацию.
`void`	`combine(LongSummaryStatistics other)` Объединяет состояние другого `LongSummaryStatistics` в этот.
`double`	`getAverage()` Возвращает среднее арифметическое записанных значений или ноль, если значения не были записаны.
`long`	`getCount()` Возвращает количество записанных значений.
`long`	`getMax()` Возвращает максимальное записанное значение или `Long.MIN_VALUE` , если значения не были записаны.
`long`	`getMin()` Возвращает минимальное записанное значение или `Long.MAX_VALUE` , если значения не были записаны.
`long`	`getSum()` Возвращает сумму записанных значений или ноль, если значения не были записаны.
`String`	`toString()` Возвращает строковое представление объекта.

Методы, унаследованные от класса java.lang.Object

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

Методы, унаследованные от интерфейса java.util.function.LongConsumer

andThen

Методы, унаследованные от интерфейса java.util.function.IntConsumer

andThen

Подробное описание конструкторов

LongSummaryStatistics

public LongSummaryStatistics()

Создаёт пустой экземпляр с нулевым количеством, нулевой суммой, Long.MAX_VALUE минимальным значением, Long.MIN_VALUE максимальным значением и нулевым средним значением.

Подробное описание методов

accept

public void accept(int value)

Записывает новое int значение в сводную информацию.

Указано в:: accept в интерфейсе IntConsumer
Параметры:: value - входное значение

accept

public void accept(long value)

Записывает новое long значение в сводную информацию.

Указано в:: accept в интерфейсе LongConsumer
Параметры:: value - входное значение

combine

public void combine(LongSummaryStatistics other)

Объединяет состояние другого LongSummaryStatistics в этот.

Параметры:: other - другое LongSummaryStatistics
Исключения:: NullPointerException - если other равно null

getCount

public final long getCount()

Возвращает количество записанных значений.

Возвращает:: количество значений

getSum

public final long getSum()

Возвращает сумму записанных значений или ноль, если значения не были записаны.

Возвращает:: сумма значений, или ноль, если нет

getMin

public final long getMin()

Возвращает минимальное записанное значение или Long.MAX_VALUE , если значения не были записаны.

Возвращает:: минимальное значение, или Long.MAX_VALUE , если нет

getMax

public final long getMax()

Возвращает максимальное записанное значение или Long.MIN_VALUE , если значения не были записаны

Возвращает:: максимальное значение, или Long.MIN_VALUE , если нет

getAverage

public final double getAverage()

Возвращает среднее арифметическое записанных значений или ноль, если значения не были записаны.

Возвращает:: Среднее арифметическое значений, или ноль, если нет

toString

public String toString()

Описание скопировано из класса: Object

Возвращает строковое представление объекта. В общем случае, метод toString возвращает строку, которая "текстово представляет" этот объект. Результат должен быть лаконичным, но информативным представлением, удобным для чтения человеком. Рекомендуется всем подклассам переопределять этот метод.

Метод toString для класса Object возвращает строку, состоящую из имени класса, экземпляром которого является объект, символа `@', и неозначенного шестнадцатеричного представления хэш-кода объекта. Другими словами, этот метод возвращает строку, равную значению:

getClass().getName() + '@' + Integer.toHexString(hashCode())

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.