Класс IntSummaryStatistics

java.lang.Object

java.util.IntSummaryStatistics

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

public class IntSummaryStatistics extends Object implements IntConsumer

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

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

 
 IntSummaryStatistics stats = intStream.collect(IntSummaryStatistics::new,
                                                IntSummaryStatistics::accept,
                                                IntSummaryStatistics::combine);

IntSummaryStatistics может быть использован как целевой объект редукции для потока. Например:

 
 IntSummaryStatistics stats = people.stream()
                                    .collect(Collectors.summarizingInt(Person::getDependents));

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

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

Краткое описание конструкторов

Конструктор	Описание
`IntSummaryStatistics()`	Создаёт пустой экземпляр с нулевым количеством, нулевой суммой, `Integer.MAX_VALUE` минимальным значением, `Integer.MIN_VALUE` максимальным значением и нулевым средним значением.
`IntSummaryStatistics(long count, int min, int max, long sum)`	Создаёт непустой экземпляр со значением `count`, `min`, `max`, и `sum`.

Краткое описание методов

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

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

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

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

andThen

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

IntSummaryStatistics

public IntSummaryStatistics()

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

IntSummaryStatistics

public IntSummaryStatistics(long count, int min, int max, long sum) throws IllegalArgumentException

Создаёт непустой экземпляр со значением count, min, max, и sum.

Если count равно нулю, то остальные аргументы игнорируются, и создаётся пустой экземпляр.

Если аргументы несовместимы, выбрасывается IllegalArgumentException . Необходимые условия согласованности аргументов:

count >= 0
min <= max

Примечание API:: Обеспечение корректности аргументов означает, что полученный набор записанных значений от экземпляра источника IntSummaryStatistics может не быть допустимым набором аргументов для этого конструктора из-за арифметического переполнения записанного количества значений источника. Условия согласованности аргументов недостаточны для предотвращения создания внутренне несовместимого экземпляра. Примером такого состояния может быть экземпляр с: count = 2, min = 1, max = 2, и sum = 0.
Параметры:: count - количество значений; min - минимальное значение; max - максимальное значение; sum - сумма всех значений
Исключения:: IllegalArgumentException - если аргументы несовместимы
С:: 10

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

accept

public void accept(int value)

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

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

combine

public void combine(IntSummaryStatistics other)

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

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

getCount

public final long getCount()

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

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

getSum

public final long getSum()

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

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

getMin

public final int getMin()

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

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

getMax

public final int getMax()

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

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

getAverage

public final double getAverage()

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

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

toString

public String toString()

Возвращает непустое строковое представление этого объекта, пригодное для отладки. Точный формат представления не определён и может отличаться в разных реализациях и версиях.

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

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/IntSummaryStatistics.html