鴻蒙OS OptionalDouble

2022-08-06 14:08 更新

OptionalDouble

java.lang.Object

|---java.util.OptionalDouble

public final class OptionalDouble
extends Object

一個(gè)容器對(duì)象,可能包含也可能不包含雙精度值。 如果存在值,isPresent() 將返回 true,而 getAsDouble() 將返回該值。

提供了依賴(lài)于包含值是否存在的其他方法,例如 orElse() (如果值不存在則返回默認(rèn)值)和 ifPresent() (如果值存在則執(zhí)行代碼塊)。

這是一個(gè)基于值的類(lèi); 在 OptionalDouble 的實(shí)例上使用身份敏感操作(包括引用相等 (==)、身份哈希碼或同步)可能會(huì)產(chǎn)生不可預(yù)測(cè)的結(jié)果,應(yīng)該避免。

方法總結(jié)

修飾符和類(lèi)型 方法 描述
static OptionalDouble empty() 返回一個(gè)空的 OptionalDouble 實(shí)例。
boolean equals(Object obj) 指示某個(gè)其他對(duì)象是否“等于”此 OptionalDouble。
double getAsDouble() 如果此 OptionalDouble 中存在值,則返回該值,否則拋出 NoSuchElementException。
int hashCode() 返回當(dāng)前值的哈希碼值(如果有);如果不存在值,則返回 0(零)。
void ifPresent(DoubleConsumer consumer) 如果存在值,則讓指定的使用者接受該值,否則什么也不做。
boolean isPresent() 如果存在值,則返回 true,否則返回 false。
static OptionalDouble of(double value) 返回具有指定值的 OptionalDouble。
double orElse(double other) 如果存在則返回值,否則返回其他值。
double orElseGet(DoubleSupplier other) 如果存在則返回該值,否則調(diào)用其他值并返回該調(diào)用的結(jié)果。
<X extends Throwable>double orElseThrow(Supplier<X> exceptionSupplier) 如果存在,則返回包含的值,否則拋出由提供的供應(yīng)商創(chuàng)建的異常。
String toString() 返回對(duì)象的字符串表示形式。
從類(lèi) java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

方法詳情

empty

public static OptionalDouble empty()

返回一個(gè)空的 OptionalDouble 實(shí)例。 此 OptionalDouble 不存在任何值。

返回:

一個(gè)空的 OptionalDouble。

of

public static OptionalDouble of(double value)

返回具有指定值的 OptionalDouble。

參數(shù):

參數(shù)名稱(chēng) 參數(shù)描述
value 存在的值

返回:

具有當(dāng)前值的 OptionalDouble

getAsDouble

public double getAsDouble()

如果此 OptionalDouble 中存在值,則返回該值,否則拋出 NoSuchElementException。

返回:

此 OptionalDouble 持有的值

Throws:

Throw名稱(chēng) Throw描述
NoSuchElementException 如果不存在值

isPresent

public boolean isPresent()

如果存在值,則返回 true,否則返回 false。

返回:

如果存在值,則為 true,否則為 false

ifPresent

public void ifPresent(DoubleConsumer consumer)

如果存在值,則讓指定的使用者接受該值,否則什么也不做。

參數(shù):

參數(shù)名稱(chēng) 參數(shù)描述
consumer 如果存在值則執(zhí)行塊

Throws:

Throw名稱(chēng) Throw描述
NullPointerException 如果值存在且 consumer 為空

orElse

public double orElse(double other)

如果存在則返回值,否則返回其他值。

參數(shù):

參數(shù)名稱(chēng) 參數(shù)描述
other 不存在值時(shí)要返回的值

返回:

該值(如果存在),否則為其他

orElseGet

public double orElseGet(DoubleSupplier other)

如果存在則返回該值,否則調(diào)用其他值并返回該調(diào)用的結(jié)果。

參數(shù):

參數(shù)名稱(chēng) 參數(shù)描述
other 一個(gè) DoubleSupplier,如果不存在值則返回其結(jié)果

返回:

如果存在則值,否則為 other.getAsDouble() 的結(jié)果

Throws:

Throw名稱(chēng) Throw描述
NullPointerException 如果 value 不存在并且 other 為 null

orElseThrow

public <X extends Throwable> double orElseThrow(Supplier<X> exceptionSupplier) throws X extends Throwable

如果存在,則返回包含的值,否則拋出由提供的供應(yīng)商創(chuàng)建的異常。

類(lèi)型參數(shù):

類(lèi)型參數(shù)名稱(chēng) 類(lèi)型參數(shù)描述
X 要拋出的異常的類(lèi)型

參數(shù):

參數(shù)名稱(chēng) 參數(shù)描述
exceptionSupplier 將返回要拋出的異常的供應(yīng)商

返回:

現(xiàn)在的值

Throws:

Throw名稱(chēng) Throw描述
X 如果不存在值
NullPointerException 如果不存在任何值且 exceptionSupplier 為 null
X extends Throwable

equals

public boolean equals(Object obj)

指示某個(gè)其他對(duì)象是否“等于”此 OptionalDouble。 如果滿(mǎn)足以下條件,則認(rèn)為另一個(gè)對(duì)象相等:

  • 它也是一個(gè) OptionalDouble 并且;
  • 兩個(gè)實(shí)例都沒(méi)有價(jià)值,或者;
  • 通過(guò) Double.compare() == 0,當(dāng)前值彼此“相等”。

覆蓋:

類(lèi) Object 中的等于

參數(shù):

參數(shù)名稱(chēng) 參數(shù)描述
obj 要測(cè)試是否相等的對(duì)象

返回:

{code true} 如果另一個(gè)對(duì)象“等于”這個(gè)對(duì)象,否則為 false

hashCode

public int hashCode()

返回當(dāng)前值的哈希碼值(如果有);如果不存在值,則返回 0(零)。

覆蓋:

類(lèi) Object 中的 hashCode

返回:

當(dāng)前值的哈希碼值,如果不存在值,則為 0

toString

public String toString()

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

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

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

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

覆蓋:

類(lèi) Object 中的 toString

返回:

此實(shí)例的字符串表示形式

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)