Module java.base
Package java.util

Class IntSummaryStatistics

java.lang.Object
java.util.IntSummaryStatistics
所有已实现的接口:
IntConsumer
public class IntSummaryStatistics extends Object implements IntConsumer
用于收集统计信息（如计数、最小值、最大值、总和和平均值）的状态对象。

此类设计用于与（尽管不需要）流一起使用。例如，您可以使用以下方式计算int流的摘要统计信息：

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

IntSummaryStatistics可以用作流的目标。例如：

 
 IntSummaryStatistics stats = people.stream()
                                    .collect(Collectors.summarizingInt(Person::getDependents));
这在单次遍历中计算了人数，以及其依赖人数的最小值、最大值、总和和平均值。
实现注意事项:
此实现不是线程安全的。但是，在并行流上使用Collectors.summarizingInt()是安全的，因为Stream.collect()的并行实现提供了必要的分区、隔离和结果合并，以实现安全和高效的并行执行。

此实现不检查计数或总和的溢出。

自 JDK 版本:
1.8

  • Constructor Summary

    Constructors
    Constructor
    Description
    IntSummaryStatistics()
    用零计数、零总和、Integer.MAX_VALUE最小值、Integer.MIN_VALUE最大值和零平均值构造一个空实例。
    IntSummaryStatistics(long count, int min, int max, long sum)
    用指定的计数、最小值、最大值和总和构造一个非空实例。

  • Method Summary

    Modifier and Type
    Method
    Description
    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()
    返回适用于调试的此对象的非空字符串表示。

    Methods declared in class java.lang.Object

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

    Methods declared in interface java.util.function.IntConsumer

    andThen

  • Constructor Details

    • IntSummaryStatistics

      public IntSummaryStatistics()
      用零计数、零总和、Integer.MAX_VALUE最小值、Integer.MIN_VALUE最大值和零平均值构造一个空实例。

    • IntSummaryStatistics

      public IntSummaryStatistics(long count, int min, int max, long sum) throws IllegalArgumentException
      用指定的计数、最小值、最大值和总和构造一个非空实例。

      如果计数为零，则忽略剩余参数并构造一个空实例。

      如果参数不一致，则抛出IllegalArgumentException。必要的一致参数条件为：

      • 计数 >= 0
      • 最小值 <= 最大值
      API 注意事项:
      参数正确性的强制执行意味着从IntSummaryStatistics源实例获取的记录值集合可能不是此构造函数的合法参数集，因为源记录的值计数可能会发生算术溢出。一致的参数条件不足以防止创建内部不一致的实例。这种状态的一个示例是：计数 = 2，最小值 = 1，最大值 = 2，总和 = 0。
      参数:
      计数 - 值的计数
      最小值 - 最小值
      最大值 - 最大值
      总和 - 所有值的总和
      抛出:
      IllegalArgumentException - 如果参数不一致
      自 JDK 版本:
      10

  • Method Details

    • 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中
      返回:
      对象的字符串表示。