鴻蒙OS DoubleSummaryStatistics

DoubleSummaryStatistics

java.lang.Object

|---java.util.DoubleSummaryStatistics

public class DoubleSummaryStatistics
extends Object
implements DoubleConsumer

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

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

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

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

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

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

構造函數摘要

方法總結

構造函數詳細信息

DoubleSummaryStatistics

public DoubleSummaryStatistics()

構造一個具有零計數、零和、Double.POSITIVE_INFINITY 最小值、Double.NEGATIVE_INFINITY 最大值和零平均值的空實例。

方法詳情

accept

public void accept(double value)

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

指定者：

在接口 DoubleConsumer 中接受

參數：

combine

public void combine(DoubleSummaryStatistics other)

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

參數：

Throws:

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

返回:

對象的字符串表示形式。