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