public class DoubleSummaryStatistics
extends Object
implements DoubleConsumer
java.lang.Object | |
↳ | java.util.DoubleSummaryStatistics |
用于收集统计信息(如计数,最小值,最大值,总和和平均值)的状态对象。
本课程旨在与(但不要求) streams一起使用 。 例如,您可以使用以下命令计算双打流的汇总统计信息:
DoubleSummaryStatistics stats = doubleStream.collect(DoubleSummaryStatistics::new,
DoubleSummaryStatistics::accept,
DoubleSummaryStatistics::combine);
DoubleSummaryStatistics
可以用作一个reduction目标为stream 。 例如:
DoubleSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingDouble(Person::getWeight));
This computes, in a single pass, the count of people, as well as the minimum, maximum, sum, and average of their weights.
Public constructors |
|
---|---|
DoubleSummaryStatistics() 构建一个零计数,零和, |
Public methods |
|
---|---|
void |
accept(double value) 在汇总信息中记录另一个值。 |
void |
combine(DoubleSummaryStatistics other) 将另一个 |
final double |
getAverage() 返回记录值的算术平均值,如果未记录任何值,则返回0。 |
final long |
getCount() 返回记录值的计数。 |
final double |
getMax() 如果记录值为NaN,则返回最大记录值 |
final double |
getMin() 如果记录值为NaN,则返回最小记录值 |
final double |
getSum() 返回记录值的总和,如果未记录任何值,则返回零。 |
String |
toString() 返回对象的字符串表示形式。 返回适合调试的此对象的非空字符串表示形式。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface java.util.function.DoubleConsumer
|
DoubleSummaryStatistics ()
构建一个零计数,零和, Double.POSITIVE_INFINITY
分钟, Double.NEGATIVE_INFINITY
最大值和零平均值的空实例。
void accept (double value)
在汇总信息中记录另一个值。
Parameters | |
---|---|
value |
double : the input value |
void combine (DoubleSummaryStatistics other)
将另一个 DoubleSummaryStatistics
的状态组合到这个状态中。
Parameters | |
---|---|
other |
DoubleSummaryStatistics : another DoubleSummaryStatistics |
Throws | |
---|---|
NullPointerException |
if other is null |
double getAverage ()
返回记录值的算术平均值,如果未记录任何值,则返回0。 如果任何记录的值是NaN或总和在任何点NaN那么平均值将是代码NaN。
返回的平均值取决于记录值的顺序。 该方法可以使用补偿总和或其他技术来实现,以减少用于计算平均值的numerical sum
的误差界限。
Returns | |
---|---|
double |
the arithmetic mean of values, or zero if none |
double getMax ()
如果记录值为NaN,则返回最大记录值Double.NaN
如果未记录任何值,则返回Double.NEGATIVE_INFINITY
。 与数值比较运算符不同,此方法将负零视为严格小于正零。
Returns | |
---|---|
double |
the maximum recorded value, Double.NaN if any recorded value was NaN or Double.NEGATIVE_INFINITY if no values were recorded |
double getMin ()
如果记录值为NaN,则返回最小记录值Double.NaN
如果未记录任何值,则返回Double.POSITIVE_INFINITY
。 与数值比较运算符不同,此方法将负零视为严格小于正零。
Returns | |
---|---|
double |
the minimum recorded value, Double.NaN if any recorded value was NaN or Double.POSITIVE_INFINITY if no values were recorded |
double getSum ()
返回记录值的总和,如果未记录任何值,则返回零。 如果任何记录的值是NaN或者总和在任何点NaN那么总和将是NaN。
浮点和的值既是输入值又是加法操作的顺序。 这种方法的附加操作的顺序是故意没有定义的,以允许实现的灵活性来提高计算结果的速度和准确性。 特别地,该方法可以使用补偿求和或其他技术来减少相比的简单求和在数值总和结合的误差来实现double
值。
Returns | |
---|---|
double |
the sum of values, or zero if none |
String toString ()
返回对象的字符串表示形式。 通常, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
Returns a non-empty string representation of this object suitable for debugging. The exact presentation format is unspecified and may vary between implementations and versions.getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |