W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
java.lang.Object
|---java.util.OptionalInt
public final class OptionalInt
extends Object
一個(gè)容器對(duì)象,可能包含也可能不包含 int 值。 如果存在值,isPresent() 將返回 true,而 getAsInt() 將返回該值。
提供了依賴于包含值是否存在的其他方法,例如 orElse() (如果值不存在則返回默認(rèn)值)和 ifPresent() (如果值存在則執(zhí)行代碼塊)。
這是一個(gè)基于值的類; 在 OptionalInt 的實(shí)例上使用身份敏感操作(包括引用相等 (==)、身份哈希碼或同步)可能會(huì)產(chǎn)生不可預(yù)知的結(jié)果,應(yīng)該避免。
修飾符和類型 | 方法 | 描述 |
---|---|---|
static OptionalInt | empty() | 返回一個(gè)空的 OptionalInt 實(shí)例。 |
boolean | equals(Object obj) | 指示某個(gè)其他對(duì)象是否“等于”此 OptionalInt。 |
int | getAsInt() | 如果此 OptionalInt 中存在值,則返回該值,否則拋出 NoSuchElementException。 |
int | hashCode() | 返回當(dāng)前值的哈希碼值(如果有);如果不存在值,則返回 0(零)。 |
void | ifPresent(IntConsumer consumer) | 如果存在值,則讓指定的使用者接受該值,否則什么也不做。 |
boolean | isPresent() | 如果存在值,則返回 true,否則返回 false。 |
static OptionalInt | of(int value) | 返回具有指定值的 OptionalInt。 |
int | orElse(int other) | 如果存在則返回值,否則返回其他值。 |
int | orElseGet(IntSupplier other) | 如果存在則返回該值,否則調(diào)用其他值并返回該調(diào)用的結(jié)果。 |
<X extends Throwable>int | orElseThrow(Supplier<X> exceptionSupplier) | 如果存在,則返回包含的值,否則拋出由提供的供應(yīng)商創(chuàng)建的異常。 |
String | toString() | 返回對(duì)象的字符串表示形式。 |
從類 java.lang.Object 繼承的方法 |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
public static OptionalInt empty()
返回一個(gè)空的 OptionalInt 實(shí)例。 此 OptionalInt 沒(méi)有值。
返回:
一個(gè)空的 OptionalInt
public static OptionalInt of(int value)
返回具有指定值的 OptionalInt。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
value | 存在的值 |
返回:
存在值的 OptionalInt
public int getAsInt()
如果此 OptionalInt 中存在值,則返回該值,否則拋出 NoSuchElementException。
返回:
此 OptionalInt 持有的值
Throws:
Throw名稱 | Throw描述 |
---|---|
NoSuchElementException | 如果不存在值 |
public boolean isPresent()
如果存在值,則返回 true,否則返回 false。
返回:
如果存在值,則為 true,否則為 false
public void ifPresent(IntConsumer consumer)
如果存在值,則讓指定的使用者接受該值,否則什么也不做。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
consumer | 如果存在值則執(zhí)行塊 |
Throws:
Throw名稱 | Throw描述 |
---|---|
NullPointerException | 如果值存在且 consumer 為空 |
public int orElse(int other)
如果存在則返回值,否則返回其他值。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
other | 不存在值時(shí)要返回的值 |
返回:
該值(如果存在),否則為其他
public int orElseGet(IntSupplier other)
如果存在則返回該值,否則調(diào)用其他值并返回該調(diào)用的結(jié)果。
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
other | 一個(gè) IntSupplier,如果不存在值則返回其結(jié)果 |
返回:
值如果存在,否則為 other.getAsInt() 的結(jié)果
Throws:
Throw名稱 | Throw描述 |
---|---|
NullPointerException | 如果 value 不存在并且 other 為 null |
public <X extends Throwable> int orElseThrow(Supplier<X> exceptionSupplier) throws X extends Throwable
如果存在,則返回包含的值,否則拋出由提供的供應(yīng)商創(chuàng)建的異常。
類型參數(shù):
類型參數(shù)名稱 | 類型參數(shù)描述 |
---|---|
X | 要拋出的異常的類型 |
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
exceptionSupplier | 將返回要拋出的異常的供應(yīng)商 |
返回:
現(xiàn)在的值
Throws:
Throw名稱 | Throw描述 |
---|---|
X | 如果不存在值 |
NullPointerException | 如果不存在任何值且 exceptionSupplier 為 null |
X extends Throwable |
public boolean equals(Object obj)
指示某個(gè)其他對(duì)象是否“等于”此 OptionalInt。 如果滿足以下條件,則認(rèn)為另一個(gè)對(duì)象相等:
覆蓋:
類 Object 中的等于
參數(shù):
參數(shù)名稱 | 參數(shù)描述 |
---|---|
obj | 要測(cè)試是否相等的對(duì)象 |
返回:
{code true} 如果另一個(gè)對(duì)象“等于”這個(gè)對(duì)象,否則為 false
public int hashCode()
返回當(dāng)前值的哈希碼值(如果有);如果不存在值,則返回 0(零)。
覆蓋:
類 Object 中的 hashCode
返回:
當(dāng)前值的哈希碼值,如果不存在值,則為 0
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í)例的字符串表示形式
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: