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