鴻蒙OS OptionalLong

OptionalLong

java.lang.Object

|---java.util.OptionalLong

public final class OptionalLong
extends Object

一個(gè)容器對(duì)象，可能包含也可能不包含 long 值。 如果存在值，isPresent() 將返回 true，而 getAsLong() 將返回該值。

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

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

方法總結(jié)

方法詳情

empty

public static OptionalLong empty()

返回一個(gè)空的 OptionalLong 實(shí)例。 此 OptionalLong 沒有值。

返回:

一個(gè)空的 OptionalLong。

of

public static OptionalLong of(long value)

返回具有指定值的 OptionalLong。

參數(shù)：

返回:

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

getAsLong

public long getAsLong()

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

返回:

此 OptionalLong 持有的值

Throws:

isPresent

public boolean isPresent()

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

返回:

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

ifPresent

public void ifPresent(LongConsumer consumer)

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

參數(shù)：

Throws:

orElse

public long orElse(long other)

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

參數(shù)：

返回:

該值（如果存在），否則為其他

orElseGet

public long orElseGet(LongSupplier other)

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

參數(shù)：

返回:

該值如果存在，否則為 other.getAsLong() 的結(jié)果

Throws:

orElseThrow

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

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

類型參數(shù)：

參數(shù):

返回:

現(xiàn)在的值

Throws:

equals

public boolean equals(Object obj)

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

• 它也是一個(gè) OptionalLong 和；
• 兩個(gè)實(shí)例都沒有價(jià)值，或者；
• 當(dāng)前值通過(guò) == 彼此“相等”。

覆蓋：

類 Object 中的等于

參數(shù)：

返回:

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

hashCode

public int hashCode()

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

覆蓋：

類 Object 中的 hashCode

返回:

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

toString

public String toString()

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

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

返回:

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