模块 java.base
包 java.util

类 IntSummaryStatistics

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

此类旨在与（尽管不需要） streams 一起使用。例如，您可以使用以下方法计算整数流的摘要统计信息：

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

IntSummaryStatistics 可用作 stream 的 减少 目标。例如：

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

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

自从：
1.8

  • 构造方法总结

    构造方法
    构造方法
    描述
    IntSummaryStatistics()
    构造一个具有零计数、零和、Integer.MAX_VALUEmin、Integer.MIN_VALUEmax 和零平均值的空实例。
    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_VALUEmin、Integer.MIN_VALUEmax 和零平均值的空实例。

    • 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 为空

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