Класс 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.toIntStatistics() в параллельном потоке, потому что параллельная реализация Stream.collect() обеспечивает необходимое разделение, изоляцию и объединение результатов для безопасного и эффективного выполнения в параллельном режиме.
Эта реализация не проверяет переполнение суммы.
С:: 1.8

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

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

Методы

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

Методы

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()

Описание скопировано из класса: 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.