鸿蒙OS DoubleSummaryStatistics
DoubleSummaryStatistics
java.lang.Object
|---java.util.DoubleSummaryStatistics
public class DoubleSummaryStatistics
extends Object
implements DoubleConsumer
用于收集计数、最小值、最大值、总和和平均值等统计信息的状态对象。
此类设计用于(尽管不需要)流。 例如,您可以使用以下方法计算双精度流的汇总统计信息:
DoubleSummaryStatistics stats = doubleStream.collect(DoubleSummaryStatistics::new,
DoubleSummaryStatistics::accept,
DoubleSummaryStatistics::combine);
DoubleSummaryStatistics 可用作流的缩减目标。 例如:
DoubleSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingDouble(Person::getWeight));
这会在一次通过中计算人数,以及他们的权重的最小值、最大值、总和和平均值。
构造函数摘要
构造函数 | 描述 |
---|---|
DoubleSummaryStatistics() | 构造一个具有零计数、零和、Double.POSITIVE_INFINITY 最小值、Double.NEGATIVE_INFINITY 最大值和零平均值的空实例。 |
方法总结
修饰符和类型 | 方法 | 描述 |
---|---|---|
void | accept(double value) | 将另一个值记录到摘要信息中。 |
void | combine(DoubleSummaryStatistics other) | 将另一个 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() | 返回对象的字符串表示形式。 |
从接口 java.util.function.DoubleConsumer 继承的方法 |
---|
andThen |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
构造函数详细信息
DoubleSummaryStatistics
public DoubleSummaryStatistics()
构造一个具有零计数、零和、Double.POSITIVE_INFINITY 最小值、Double.NEGATIVE_INFINITY 最大值和零平均值的空实例。
方法详情
accept
public void accept(double value)
将另一个值记录到摘要信息中。
指定者:
在接口 DoubleConsumer 中接受
参数:
参数名称 | 参数描述 |
---|---|
value | 输入值 |
combine
public void combine(DoubleSummaryStatistics other)
将另一个 DoubleSummaryStatistics 的状态合并到这个中。
参数:
参数名称 | 参数描述 |
---|---|
other | 另一个 DoubleSummaryStatistics |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果其他为空 |
getCount
public final long getCount()
返回记录的值的计数。
返回:
值的计数
getSum
public final double getSum()
返回记录值的总和,如果没有记录值,则返回零。 如果任何记录的值是 NaN 或总和在任何点都是 NaN,则总和将为 NaN。
浮点和的值是输入值和加法运算顺序的函数。 故意不定义此方法的加法运算顺序,以允许实现灵活性以提高计算结果的速度和准确性。 特别地,与双值的简单求和相比,该方法可以使用补偿求和或其他技术来实现以减少数值求和中的误差界限。
返回:
值的总和,如果没有则为零
getMin
public final double getMin()
返回最小记录值,如果任何记录值为 NaN,则返回 Double.NaN;如果没有记录值,则返回 Double.POSITIVE_INFINITY。 与数值比较运算符不同,此方法认为负零严格小于正零。
返回:
最小记录值,如果任何记录值为 NaN,则为 Double.NaN;如果未记录任何值,则为 Double.POSITIVE_INFINITY
getMax
public final double getMax()
返回最大记录值,如果任何记录值为 NaN,则返回 Double.NaN;如果没有记录值,则返回 Double.NEGATIVE_INFINITY。 与数值比较运算符不同,此方法认为负零严格小于正零。
返回:
最大记录值,如果任何记录值为 NaN,则为 Double.NaN;如果未记录任何值,则为 Double.NEGATIVE_INFINITY
getAverage
public final double getAverage()
返回记录值的算术平均值,如果没有记录值,则返回零。 如果任何记录的值是 NaN 或总和在任何点都是 NaN,则平均值将为代码 NaN。
返回的平均值可能因记录值的顺序而异。 该方法可以使用补偿求和或其他技术来实现,以减少用于计算平均值的数值和中的误差界限。
返回:
值的算术平均值,如果没有则为零
toString
public String toString()
返回对象的字符串表示形式。 通常,toString 方法返回一个“以文本方式表示”该对象的字符串。 结果应该是一个简洁但信息丰富的表示,易于人们阅读。 建议所有子类重写此方法。
Object 类的 toString 方法返回一个字符串,该字符串由对象作为其实例的类的名称、at 符号字符“@”和对象哈希码的无符号十六进制表示形式组成。 换句话说,此方法返回一个等于以下值的字符串:
getClass().getName() + '@' + Integer.toHexString(hashCode())
返回此对象的适合调试的非空字符串表示形式。 确切的表示格式未指定,并且可能因实现和版本而异。
覆盖:
类 Object 中的 toString
返回:
对象的字符串表示形式。
更多建议: