DoubleSummaryStatistics (Java Platform SE 8 )

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
    
    结果
    
    对象的字符串表示形式。

Class DoubleSummaryStatistics

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.function.DoubleConsumer

构造方法详细信息

DoubleSummaryStatistics

方法详细信息

accept

combine

getCount

getSum

getMin

getMax

getAverage

toString