Класс 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/IntSummaryStatistics.html