compact1, compact2, compact3

java.util

Class DoubleSummaryStatistics

java.lang.Object

java.util.DoubleSummaryStatistics

All Implemented Interfaces:

DoubleConsumer

public class DoubleSummaryStatistics
extends Object
implements DoubleConsumer

统计数据的收集状态，如count，min，max，sum和average。

这个课程旨在与（但不要求）工作（ streams） 。 例如，您可以使用以下方式计算双精度流的汇总统计信息：

   DoubleSummaryStatistics stats = doubleStream.collect(DoubleSummaryStatistics::new, DoubleSummaryStatistics::accept, DoubleSummaryStatistics::combine);  

DoubleSummaryStatistics可用作reduction目标为stream 。 例如：

   DoubleSummaryStatistics stats = people.stream() .collect(Collectors.summarizingDouble(Person::getWeight));  

这样一来，就可以计算出人数，以及其权重的最小值，最大值，总和和平均值。

Implementation Note:

这个实现不是线程安全的。 但是，它是安全的使用Collectors.toDoubleStatistics()上并行流，因为并行执行Stream.collect()提供了必要的隔离，隔离和结果安全，高效的并行执行的合并。

从以下版本开始：

1.8

构造方法摘要

构造方法

Constructor and Description
DoubleSummaryStatistics() 用零计数，零和， Double.POSITIVE_INFINITY分钟， Double.NEGATIVE_INFINITY最大和零平均值构造一个空实例。

方法摘要

Modifier and Type	Method and Description
void	accept(double value) 在摘要信息中记录另一个值。
void	combine(DoubleSummaryStatistics other) 将另一个 DoubleSummaryStatistics的状态 DoubleSummaryStatistics到这一个中。
double	getAverage() 返回记录的值的算术平均值，如果没有记录值，则返回零。
long	getCount() 返回记录的值的计数。
double	getMax() 如果任何记录值为NaN，则返回最大记录值 Double.NaN如果没有记录值，则返回 Double.NEGATIVE_INFINITY 。
double	getMin() 如果任何记录值为NaN，则返回最小记录值 Double.NaN如果没有记录值，则返回 Double.POSITIVE_INFINITY 。
double	getSum() 返回记录的值的总和，如果没有记录值，则返回零。
String	toString() 返回对象的字符串表示形式。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.function.DoubleConsumer

andThen

构造方法详细信息

DoubleSummaryStatistics

public DoubleSummaryStatistics()

用零计数，零和， Double.POSITIVE_INFINITY分钟， Double.NEGATIVE_INFINITY最大和零平均值构造一个空实例。

方法详细信息

accept

public void accept(double value)

在摘要信息中记录另一个值。

Specified by:

accept在界面 DoubleConsumer

参数

value - 输入值

combine

public void combine(DoubleSummaryStatistics other)

将另一个 DoubleSummaryStatistics的状态 DoubleSummaryStatistics到一个。

参数

other - 另一个 DoubleSummaryStatistics

异常

NullPointerException - 如果 other为空

getCount

public final long getCount()

返回记录的值的计数。

结果

数值计数

getSum

public final double getSum()

返回记录的值的总和，如果没有记录值，则返回零。 如果任何记录的值是NaN，或者总和在任何时候，NaN则总和将为NaN。

浮点和的值是输入值以及加法运算顺序的函数。 该方法的加法运算顺序有意未被定义为允许实现灵活性来提高计算结果的速度和精度。 特别地，该方法可以使用补偿求和或其他技术来减少相比的简单求和在数值总和结合的误差来实现double值。

API Note:

按绝对数量增加排列的数值往往会产生更准确的结果。

结果

值的总和，否则为零

getMin

public final double getMin()

如果任何记录值为NaN，则返回最小记录值Double.NaN如果没有记录值，则返回Double.POSITIVE_INFINITY 。 与数值比较运算符不同，该方法认为负零严格小于正零。

结果

最低记录值 Double.NaN如果任何记录值为NaN或 Double.POSITIVE_INFINITY如果没有记录值

getMax

public final double getMax()

如果任何记录值为NaN，则返回最大记录值Double.NaN如果没有记录值，则返回Double.NEGATIVE_INFINITY 。 与数值比较运算符不同，该方法认为负零严格小于正零。

结果

最高记录值 Double.NaN如果任何记录值为NaN或 Double.NEGATIVE_INFINITY如果没有记录值

getAverage

public final double getAverage()

返回记录的值的算术平均值，如果没有记录值，则返回零。 如果任何记录的值是NaN，或者总和在任何时候，NaN则平均值将代入NaN。

返回的平均值可能会根据记录值的顺序而有所不同。 该方法可以使用补偿求和或其他技术来实现，以减少用于计算平均值的numerical sum中的误差界限。

API Note:

按绝对数量增加排列的数值往往会产生更准确的结果。

结果

值的算术平均值，如果没有值则为零

toString

public String toString()

返回对象的字符串表示形式。 一般来说， toString方法返回一个“textually代表”这个对象的字符串。 结果应该是一个简明扼要的表达，容易让人阅读。 建议所有子类覆盖此方法。

类Object的toString方法返回一个字符串，该字符串由对象为实例的类的名称，标记字符“ @ ”以及对象的哈希码的无符号十六进制表示组成。 换句话说，这个方法返回一个等于下列值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

返回适用于调试的此对象的非空字符串表示形式。 准确的表示格式是未指定的，可能会在实现和版本之间变化。

重写：

toString在类别 Object

结果

对象的字符串表示形式。