IntSummaryStatistics

java.lang.Object

|---java.util.IntSummaryStatistics

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

这可以一次性计算人数，以及他们的家属人数的最小值、最大值、总和和平均值。

构造函数摘要

构造函数	描述
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.util.function.IntConsumer 继承的方法
andThen

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造函数详细信息

IntSummaryStatistics

public IntSummaryStatistics()

构造一个具有零计数、零和、Integer.MAX_VALUE 最小值、Integer.MIN_VALUE 最大值和零平均值的空实例。

方法详情

accept

public void accept(int value)

将新值记录到摘要信息中

指定者：

在接口 IntConsumer 中接受

参数：

参数名称	参数描述
value	输入值

combine

public void combine(IntSummaryStatistics other)

将另一个 IntSummaryStatistics 的状态合并到这个中。

参数：

参数名称	参数描述
other	另一个 IntSummaryStatistics

Throws:

Throw名称	Throw描述
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 类的 toString 方法返回一个字符串，该字符串由对象作为实例的类的名称、at 符号字符“@”和对象的哈希码的无符号十六进制表示形式组成。 换句话说，此方法返回一个等于以下值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode()) 

覆盖：

类 Object 中的 toString

返回：

对象的字符串表示形式。