java.lang.Object
java.util.DoubleSummaryStatistics
- 所有已实现的接口:
DoubleConsumer
用于收集计数、最小值、最大值、总和和平均值等统计信息的状态对象。
此类旨在与(尽管不需要) streams 一起使用。例如,您可以使用以下方法计算双打流的摘要统计信息:
DoubleSummaryStatistics stats = doubleStream.collect(DoubleSummaryStatistics::new,
DoubleSummaryStatistics::accept,
DoubleSummaryStatistics::combine);
DoubleSummaryStatistics
可用作 stream 的 减少 目标。例如:
DoubleSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingDouble(Person::getWeight));
这一次计算出人数,以及他们体重的最小值、最大值、总和和平均值。
- 实现注意事项:
-
此实现不是线程安全的。但是,在并行流上使用
Collectors.summarizingDouble()
是安全的,因为Stream.collect()
的并行实现为安全高效的并行执行提供了必要的分区、隔离和结果合并。此实现不检查计数是否溢出。
- 自从:
- 1.8
-
构造方法总结
构造方法描述构造一个具有零计数、零和、Double.POSITIVE_INFINITY
min、Double.NEGATIVE_INFINITY
max 和零平均值的空实例。DoubleSummaryStatistics
(long count, double min, double max, double sum) 构造具有指定count
、min
、max
和sum
的非空实例。 -
方法总结
修饰符和类型方法描述void
accept
(double value) 将另一个值记录到摘要信息中。void
combine
(DoubleSummaryStatistics other) 将另一个DoubleSummaryStatistics
的状态组合到这个中。final double
返回记录值的算术平均值,如果没有记录值则返回零。final long
getCount()
返回记录值的计数。final double
getMax()
返回最大记录值,Double.NaN
(如果任何记录值为 NaN)或Double.NEGATIVE_INFINITY
(如果未记录任何值)。final double
getMin()
返回最小记录值,Double.NaN
(如果任何记录值为 NaN)或Double.POSITIVE_INFINITY
(如果未记录任何值)。final double
getSum()
返回记录值的总和,如果没有记录值则返回零。toString()
返回此对象适合调试的非空字符串表示形式。在类 java.lang.Object 中声明的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
在接口 java.util.function.DoubleConsumer 中声明的方法
andThen
-
构造方法详细信息
-
DoubleSummaryStatistics
public DoubleSummaryStatistics()构造一个具有零计数、零和、Double.POSITIVE_INFINITY
min、Double.NEGATIVE_INFINITY
max 和零平均值的空实例。 -
DoubleSummaryStatistics
public DoubleSummaryStatistics(long count, double min, double max, double sum) throws IllegalArgumentException 构造具有指定count
、min
、max
和sum
的非空实例。如果
count
为零,则忽略其余参数并构造一个空实例。如果参数不一致,则抛出
IllegalArgumentException
。必要的一致参数条件是:count >= 0
(min <= max && !isNaN(sum)) || (isNaN(min) && isNaN(max) && isNaN(sum))
- API 注意:
-
参数正确性的实施意味着从
DoubleSummaryStatistics
源实例获得的检索记录值集可能不是该构造函数的合法参数集,因为源记录值计数的算术溢出。一致的参数条件不足以防止创建内部不一致的实例。这种状态的一个例子是一个实例:count
= 2、min
= 1、max
= 2 和sum
= 0。 - 参数:
count
- 值的计数min
- 最小值max
- 最大值sum
- 所有值的总和- 抛出:
IllegalArgumentException
- 如果参数不一致- 自从:
- 10
-
-
方法详情
-
accept
public void accept(double value) 将另一个值记录到摘要信息中。- 指定者:
accept
在接口DoubleConsumer
中- 参数:
value
- 输入值
-
combine
将另一个DoubleSummaryStatistics
的状态组合到这个中。- 参数:
other
- 另一个DoubleSummaryStatistics
- 抛出:
NullPointerException
- 如果other
为空
-
getCount
public final long getCount()返回记录值的计数。- 返回:
- 值的计数
-
getSum
public final double getSum()返回记录值的总和,如果没有记录值则返回零。浮点和的值是输入值和加法运算顺序的函数。此方法的加法操作顺序未有意定义,以允许实现灵活性以提高计算结果的速度和准确性。特别地,与
double
值的简单求和相比,可以使用补偿求和或其他技术来实现该方法以减少数字求和中的误差范围。由于未指定操作顺序和使用不同求和方案的可能性,此方法的输出可能因相同的输入值而异。各种条件都可能导致计算非有限和。即使求和的所有记录值都是有限的,也会发生这种情况。如果任何记录的值是非有限的,则总和将是非有限的:
- 如果任何记录值是 NaN,则最终总和将为 NaN。
- 如果记录的值包含一个或多个无穷大,则总和将为无穷大或 NaN。
- 如果记录的值包含相反符号的无穷大,则总和将为 NaN。
- 如果记录的值包含一个符号的无穷大并且中间和溢出到相反符号的无穷大,则该和可能是 NaN。
- API 注意:
- 按绝对幅度递增排序的值往往会产生更准确的结果。
- 返回:
- 值的总和,如果没有则为零
-
getMin
public final double getMin()返回最小记录值,Double.NaN
(如果任何记录值为 NaN)或Double.POSITIVE_INFINITY
(如果未记录任何值)。与数值比较运算符不同,此方法认为负零严格小于正零。- 返回:
-
最小记录值,
Double.NaN
如果任何记录值为 NaN 或Double.POSITIVE_INFINITY
如果没有值被记录
-
getMax
public final double getMax()返回最大记录值,Double.NaN
(如果任何记录值为 NaN)或Double.NEGATIVE_INFINITY
(如果未记录任何值)。与数值比较运算符不同,此方法认为负零严格小于正零。- 返回:
-
最大记录值,
Double.NaN
如果任何记录值为 NaN 或Double.NEGATIVE_INFINITY
如果没有值被记录
-
getAverage
public final double getAverage()返回记录值的算术平均值,如果没有记录值则返回零。计算出的平均值可能在数值上有所不同,并且在计算总和时具有特殊情况行为;有关详细信息,请参阅
getSum()
。- API 注意:
- 按绝对幅度递增排序的值往往会产生更准确的结果。
- 返回:
- 值的算术平均值,如果没有则为零
-
toString
返回此对象适合调试的非空字符串表示形式。确切的表示格式未指定,并且可能因实现和版本而异。
-