鴻蒙OS DoubleSummaryStatistics

DoubleSummaryStatistics

java.lang.Object

|---java.util.DoubleSummaryStatistics

public class DoubleSummaryStatistics
extends Object
implements DoubleConsumer

用于收集計數(shù)、最小值、最大值、總和和平均值等統(tǒng)計信息的狀態(tài)對象。

此類設(shè)計用于（盡管不需要）流。 例如，您可以使用以下方法計算雙精度流的匯總統(tǒng)計信息：

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

DoubleSummaryStatistics 可用作流的縮減目標。 例如：

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

這會在一次通過中計算人數(shù)，以及他們的權(quán)重的最小值、最大值、總和和平均值。

構(gòu)造函數(shù)摘要

方法總結(jié)

構(gòu)造函數(shù)詳細信息

DoubleSummaryStatistics

public DoubleSummaryStatistics()

構(gòu)造一個具有零計數(shù)、零和、Double.POSITIVE_INFINITY 最小值、Double.NEGATIVE_INFINITY 最大值和零平均值的空實例。

方法詳情

accept

public void accept(double value)

將另一個值記錄到摘要信息中。

指定者：

在接口 DoubleConsumer 中接受

參數(shù)：

combine

public void combine(DoubleSummaryStatistics other)

將另一個 DoubleSummaryStatistics 的狀態(tài)合并到這個中。

參數(shù)：

Throws:

getCount

public final long getCount()

返回記錄的值的計數(shù)。

返回:

值的計數(shù)

getSum

public final double getSum()

返回記錄值的總和，如果沒有記錄值，則返回零。 如果任何記錄的值是 NaN 或總和在任何點都是 NaN，則總和將為 NaN。

浮點和的值是輸入值和加法運算順序的函數(shù)。 故意不定義此方法的加法運算順序，以允許實現(xiàn)靈活性以提高計算結(jié)果的速度和準確性。 特別地，與雙值的簡單求和相比，該方法可以使用補償求和或其他技術(shù)來實現(xiàn)以減少數(shù)值求和中的誤差界限。

返回:

值的總和，如果沒有則為零

getMin

public final double getMin()

返回最小記錄值，如果任何記錄值為 NaN，則返回 Double.NaN；如果沒有記錄值，則返回 Double.POSITIVE_INFINITY。 與數(shù)值比較運算符不同，此方法認為負零嚴格小于正零。

返回:

最小記錄值，如果任何記錄值為 NaN，則為 Double.NaN；如果未記錄任何值，則為 Double.POSITIVE_INFINITY

getMax

public final double getMax()

返回最大記錄值，如果任何記錄值為 NaN，則返回 Double.NaN；如果沒有記錄值，則返回 Double.NEGATIVE_INFINITY。 與數(shù)值比較運算符不同，此方法認為負零嚴格小于正零。

返回:

最大記錄值，如果任何記錄值為 NaN，則為 Double.NaN；如果未記錄任何值，則為 Double.NEGATIVE_INFINITY

getAverage

public final double getAverage()

返回記錄值的算術(shù)平均值，如果沒有記錄值，則返回零。 如果任何記錄的值是 NaN 或總和在任何點都是 NaN，則平均值將為代碼 NaN。

返回的平均值可能因記錄值的順序而異。 該方法可以使用補償求和或其他技術(shù)來實現(xiàn)，以減少用于計算平均值的數(shù)值和中的誤差界限。

返回:

值的算術(shù)平均值，如果沒有則為零

toString

public String toString()

返回對象的字符串表示形式。 通常，toString 方法返回一個“以文本方式表示”該對象的字符串。 結(jié)果應(yīng)該是一個簡潔但信息豐富的表示，易于人們閱讀。 建議所有子類重寫此方法。

Object 類的 toString 方法返回一個字符串，該字符串由對象作為其實例的類的名稱、at 符號字符“@”和對象哈希碼的無符號十六進制表示形式組成。 換句話說，此方法返回一個等于以下值的字符串：

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

返回此對象的適合調(diào)試的非空字符串表示形式。 確切的表示格式未指定，并且可能因?qū)崿F(xiàn)和版本而異。

覆蓋：

類 Object 中的 toString

返回:

對象的字符串表示形式。