Most visited

Recently visited

Added in API level 24

DoubleSummaryStatistics

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.

Summary

Public constructors

DoubleSummaryStatistics()

构建一个零计数,零和, Double.POSITIVE_INFINITY分钟, Double.NEGATIVE_INFINITY最大值和零平均值的空实例。

Public methods

void accept(double value)

在汇总信息中记录另一个值。

void combine(DoubleSummaryStatistics other)

将另一个 DoubleSummaryStatistics的状态组合到这个状态中。

final double getAverage()

返回记录值的算术平均值,如果未记录任何值,则返回0。

final long getCount()

返回记录值的计数。

final double getMax()

如果记录值为NaN,则返回最大记录值 Double.NaN如果未记录任何值,则返回 Double.NEGATIVE_INFINITY

final double getMin()

如果记录值为NaN,则返回最小记录值 Double.NaN如果未记录任何值,则返回 Double.POSITIVE_INFINITY

final double getSum()

返回记录值的总和,如果未记录任何值,则返回零。

String toString()

返回对象的字符串表示形式。 返回适合调试的此对象的非空字符串表示形式。

Inherited methods

From class java.lang.Object
From interface java.util.function.DoubleConsumer

Public constructors

DoubleSummaryStatistics

Added in API level 24
DoubleSummaryStatistics ()

构建一个零计数,零和, Double.POSITIVE_INFINITY分钟, Double.NEGATIVE_INFINITY最大值和零平均值的空实例。

Public methods

accept

Added in API level 24
void accept (double value)

在汇总信息中记录另一个值。

Parameters
value double: the input value

combine

Added in API level 24
void combine (DoubleSummaryStatistics other)

将另一个 DoubleSummaryStatistics的状态组合到这个状态中。

Parameters
other DoubleSummaryStatistics: another DoubleSummaryStatistics
Throws
NullPointerException if other is null

getAverage

Added in API level 24
double getAverage ()

返回记录值的算术平均值,如果未记录任何值,则返回0。 如果任何记录的值是NaN或总和在任何点NaN那么平均值将是代码NaN。

返回的平均值取决于记录值的顺序。 该方法可以使用补偿总和或其他技术来实现,以减少用于计算平均值的numerical sum的误差界限。

API Note:
  • Values sorted by increasing absolute magnitude tend to yield more accurate results.
Returns
double the arithmetic mean of values, or zero if none

getCount

Added in API level 24
long getCount ()

返回记录值的计数。

Returns
long the count of values

getMax

Added in API level 24
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

getMin

Added in API level 24
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

getSum

Added in API level 24
double getSum ()

返回记录值的总和,如果未记录任何值,则返回零。 如果任何记录的值是NaN或者总和在任何点NaN那么总和将是NaN。

浮点和的值既是输入值又是加法操作的顺序。 这种方法的附加操作的顺序是故意没有定义的,以允许实现的灵活性来提高计算结果的速度和准确性。 特别地,该方法可以使用补偿求和或其他技术来减少相比的简单求和在数值总和结合的误差来实现double值。

API Note:
  • Values sorted by increasing absolute magnitude tend to yield more accurate results.
Returns
double the sum of values, or zero if none

toString

Added in API level 24
String toString ()

返回对象的字符串表示形式。 通常, toString方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 
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.

Returns
String a string representation of the object.

Hooray!