public class LongSummaryStatistics
extends Object
implements LongConsumer, IntConsumer
java.lang.Object | |
↳ | java.util.LongSummaryStatistics |
用于收集统计信息(如计数,最小值,最大值,总和和平均值)的状态对象。
本课程旨在与(但不要求) streams一起工作 。 例如,您可以使用以下代码计算多个长整数的汇总统计信息:
LongSummaryStatistics stats = longStream.collect(LongSummaryStatistics::new,
LongSummaryStatistics::accept,
LongSummaryStatistics::combine);
LongSummaryStatistics
可以用作一个collect(Collector)减少}目标为stream 。 例如:
LongSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingLong(Person::getAge));
This computes, in a single pass, the count of people, as well as the minimum, maximum, sum, and average of their ages.
Public constructors |
|
---|---|
LongSummaryStatistics() 构造一个零计数,零和, |
Public methods |
|
---|---|
void |
accept(int value) 将新的 |
void |
accept(long value) 将新的 |
void |
combine(LongSummaryStatistics other) 将另一个 |
final double |
getAverage() 返回记录值的算术平均值,如果未记录任何值,则返回0。 |
final long |
getCount() 返回记录值的计数。 |
final long |
getMax() 返回记录的最大值,或者如果未记录任何值,则返回 |
final long |
getMin() 返回记录的最小值,或者如果未记录任何值,则返回 |
final long |
getSum() 返回记录值的总和,如果未记录任何值,则返回零。 |
String |
toString() 返回对象的字符串表示形式。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface java.util.function.LongConsumer
|
|
From interface java.util.function.IntConsumer
|
LongSummaryStatistics ()
构造一个零计数,零和, Long.MAX_VALUE
分钟, Long.MIN_VALUE
最大值和零平均值的空实例。
void accept (int value)
将新的 int
值记录到摘要信息中。
Parameters | |
---|---|
value |
int : the input value |
void accept (long value)
将新的 long
值记录到汇总信息中。
Parameters | |
---|---|
value |
long : the input value |
void combine (LongSummaryStatistics other)
将另一个 LongSummaryStatistics
的状态组合到这个状态中。
Parameters | |
---|---|
other |
LongSummaryStatistics : another LongSummaryStatistics |
Throws | |
---|---|
NullPointerException |
if other is null |
double getAverage ()
返回记录值的算术平均值,如果未记录任何值,则返回0。
Returns | |
---|---|
double |
The arithmetic mean of values, or zero if none |
long getMax ()
返回记录的最大值,或者如果未记录任何值,则返回 Long.MIN_VALUE
Returns | |
---|---|
long |
the maximum value, or Long.MIN_VALUE if none |
long getMin ()
返回记录的最小值,或者如果未记录任何值,则返回 Long.MAX_VALUE
。
Returns | |
---|---|
long |
the minimum value, or Long.MAX_VALUE if none |
long getSum ()
返回记录值的总和,如果未记录任何值,则返回零。
Returns | |
---|---|
long |
the sum of values, or zero if none |
String toString ()
返回对象的字符串表示形式。 通常, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |