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

返回：

对象的字符串表示形式。