鴻蒙OS OptionalInt

2022-08-06 14:08 更新

OptionalInt

java.lang.Object

|---java.util.OptionalInt

public final class OptionalInt
extends Object

一個容器對象,可能包含也可能不包含 int 值。 如果存在值,isPresent() 將返回 true,而 getAsInt() 將返回該值。

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

這是一個基于值的類; 在 OptionalInt 的實例上使用身份敏感操作(包括引用相等 (==)、身份哈希碼或同步)可能會產生不可預知的結果,應該避免。

方法總結

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

方法詳情

empty

public static OptionalInt empty()

返回一個空的 OptionalInt 實例。 此 OptionalInt 沒有值。

返回:

一個空的 OptionalInt

of

public static OptionalInt of(int value)

返回具有指定值的 OptionalInt。

參數:

參數名稱 參數描述
value 存在的值

返回:

存在值的 OptionalInt

getAsInt

public int getAsInt()

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

返回:

此 OptionalInt 持有的值

Throws:

Throw名稱 Throw描述
NoSuchElementException 如果不存在值

isPresent

public boolean isPresent()

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

返回:

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

ifPresent

public void ifPresent(IntConsumer consumer)

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

參數:

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

Throws:

Throw名稱 Throw描述
NullPointerException 如果值存在且 consumer 為空

orElse

public int orElse(int other)

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

參數:

參數名稱 參數描述
other 不存在值時要返回的值

返回:

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

orElseGet

public int orElseGet(IntSupplier other)

如果存在則返回該值,否則調用其他值并返回該調用的結果。

參數:

參數名稱 參數描述
other 一個 IntSupplier,如果不存在值則返回其結果

返回:

值如果存在,否則為 other.getAsInt() 的結果

Throws:

Throw名稱 Throw描述
NullPointerException 如果 value 不存在并且 other 為 null

orElseThrow

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

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

類型參數:

類型參數名稱 類型參數描述
X 要拋出的異常的類型

參數:

參數名稱 參數描述
exceptionSupplier 將返回要拋出的異常的供應商

返回:

現在的值

Throws:

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

equals

public boolean equals(Object obj)

指示某個其他對象是否“等于”此 OptionalInt。 如果滿足以下條件,則認為另一個對象相等:

  • 它也是一個 OptionalInt 并且;
  • 兩個實例都沒有價值,或者;
  • 當前值通過 == 彼此“相等”。

覆蓋:

類 Object 中的等于

參數:

參數名稱 參數描述
obj 要測試是否相等的對象

返回:

{code true} 如果另一個對象“等于”這個對象,否則為 false

hashCode

public int hashCode()

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

覆蓋:

類 Object 中的 hashCode

返回:

當前值的哈希碼值,如果不存在值,則為 0

toString

public String toString()

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

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

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

返回此對象的適合調試的非空字符串表示形式。 確切的表示格式未指定,并且可能因實現和版本而異。

覆蓋:

類 Object 中的 toString

返回:

此實例的字符串表示形式

以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號