鴻蒙OS DoubleSummaryStatistics

DoubleSummaryStatistics

java.lang.Object

|---java.util.DoubleSummaryStatistics

public class DoubleSummaryStatistics
extends Object
implements DoubleConsumer

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

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

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

DoubleSummaryStatistics 可用作流的縮減目標(biāo)。 例如：

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

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

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

方法總結(jié)

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

DoubleSummaryStatistics

public DoubleSummaryStatistics()

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

方法詳情

accept

public void accept(double value)

將另一個(gè)值記錄到摘要信息中。

指定者：

在接口 DoubleConsumer 中接受

參數(shù)：

combine

public void combine(DoubleSummaryStatistics other)

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

參數(shù)：

Throws:

getCount

public final long getCount()

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

返回:

值的計(jì)數(shù)

getSum

public final double getSum()

返回記錄值的總和，如果沒(méi)有記錄值，則返回零。 如果任何記錄的值是 NaN 或總和在任何點(diǎn)都是 NaN，則總和將為 NaN。

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

返回:

值的總和，如果沒(méi)有則為零

getMin

public final double getMin()

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

返回:

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

getMax

public final double getMax()

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

返回:

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

getAverage

public final double getAverage()

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

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

返回:

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

toString

public String toString()

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

Object 類的 toString 方法返回一個(gè)字符串，該字符串由對(duì)象作為其實(shí)例的類的名稱、at 符號(hào)字符“@”和對(duì)象哈希碼的無(wú)符號(hào)十六進(jìn)制表示形式組成。 換句話說(shuō)，此方法返回一個(gè)等于以下值的字符串：

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

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

覆蓋：

類 Object 中的 toString

返回:

對(duì)象的字符串表示形式。