LongSummaryStatistics
java.lang.Object
|—java.util.LongSummaryStatistics
public class LongSummaryStatistics
extends Object
implements LongConsumer, IntConsumer
用于收集计数、最小值、最大值、总和和平均值等统计信息的状态对象。
此类设计用于(尽管不需要)流。 例如,您可以使用以下命令计算 long 流的汇总统计信息:
LongSummaryStatistics stats = longStream.collect(LongSummaryStatistics::new,
LongSummaryStatistics::accept,
LongSummaryStatistics::combine);
LongSummaryStatistics 可以用作流的 Stream.collect(Collector) reduction} 目标。 例如:
LongSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingLong(Person::getAge));
这可以一次性计算人数,以及他们年龄的最小值、最大值、总和和平均值。
构造函数摘要
构造函数 | 描述 |
---|---|
LongSummaryStatistics() | 构造一个具有零计数、零和、Long.MAX_VALUE 最小值、Long.MIN_VALUE 最大值和零平均值的空实例。 |
方法总结
修饰符和类型 | 方法 | 描述 |
---|---|---|
void | accept(int value) | 将新的 int 值记录到摘要信息中。 |
void | accept(long value) | 在摘要信息中记录一个新的 long 值。 |
void | combine(LongSummaryStatistics other) | 将另一个 LongSummaryStatistics 的状态合并到这个中。 |
double | getAverage() | 返回记录值的算术平均值,如果没有记录值,则返回零。 |
long | getCount() | 返回记录的值的计数。 |
long | getMax() | 返回记录的最大值,如果没有记录值,则返回 Long.MIN_VALUE |
long | getMin() | 返回记录的最小值,如果没有记录任何值,则返回 Long.MAX_VALUE。 |
long | getSum() | 返回记录值的总和,如果没有记录值,则返回零。 |
String | toString() | 返回对象的字符串表示形式。 |
从接口 java.util.function.IntConsumer 继承的方法 |
---|
andThen |
从接口 java.util.function.LongConsumer 继承的方法 |
---|
andThen |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
构造函数详细信息
LongSummaryStatistics
public LongSummaryStatistics()
构造一个具有零计数、零和、Long.MAX_VALUE 最小值、Long.MIN_VALUE 最大值和零平均值的空实例。
方法详情
accept
public void accept(int value)
将新的 int 值记录到摘要信息中。
指定者:
在接口 IntConsumer 中接受
参数:
参数名称 | 参数描述 |
---|---|
value | 输入值 |
accept
public void accept(long value)
在摘要信息中记录一个新的 long 值。
指定者:
在接口 LongConsumer 中接受
参数:
参数名称 | 参数描述 |
---|---|
value | 输入值 |
combine
public void combine(LongSummaryStatistics other)
将另一个 LongSummaryStatistics 的状态合并到这个中。
参数:
参数名称 | 参数描述 |
---|---|
other | 另一个 LongSummaryStatistics |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果 other 为空 |
getCount
public final long getCount()
返回记录的值的计数。
返回:
值的计数
getSum
public final long getSum()
返回记录值的总和,如果没有记录值,则返回零。
返回:
值的总和,如果没有则为零
getMin
public final long getMin()
返回记录的最小值,如果没有记录任何值,则返回 Long.MAX_VALUE。
返回:
最小值,如果没有,则为 Long.MAX_VALUE
getMax
public final long getMax()
返回记录的最大值,如果没有记录值,则返回 Long.MIN_VALUE
返回:
最大值,如果没有,则为 Long.MIN_VALUE
getAverage
public final double getAverage()
返回记录值的算术平均值,如果没有记录值,则返回零。
返回:
值的算术平均值,如果没有则为零
toString
public String toString()
从类复制的描述:对象
返回对象的字符串表示形式。 通常,toString 方法返回一个“以文本方式表示”该对象的字符串。 结果应该是一个简洁但信息丰富的表示,易于人们阅读。 建议所有子类重写此方法。
Object 类的 toString 方法返回一个字符串,该字符串由对象作为实例的类的名称、at 符号字符“@”和对象的哈希码的无符号十六进制表示形式组成。 换句话说,此方法返回一个等于以下值的字符串:
getClass().getName() + '@' + Integer.toHexString(hashCode())
覆盖:
类 Object 中的 toString
返回:
对象的字符串表示形式。