java.lang.Object
|---java.util.OptionalLong
public final class OptionalLong
extends Object
一个容器对象，可能包含也可能不包含 long 值。 如果存在值，isPresent() 将返回 true，而 getAsLong() 将返回该值。
提供了依赖于包含值是否存在的其他方法，例如 orElse() （如果值不存在则返回默认值）和 ifPresent() （如果值存在则执行代码块）。
这是一个基于值的类； 在 OptionalLong 的实例上使用身份敏感操作（包括引用相等 (==)、身份哈希码或同步）可能会产生不可预知的结果，应该避免。
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| static OptionalLong | empty() | 返回一个空的 OptionalLong 实例。 |
| boolean | equals(Object obj) | 指示某个其他对象是否“等于”此 OptionalLong。 |
| long | getAsLong() | 如果此 OptionalLong 中存在值，则返回该值，否则抛出 NoSuchElementException。 |
| int | hashCode() | 返回当前值的哈希码值（如果有）；如果不存在值，则返回 0（零）。 |
| void | ifPresent(LongConsumer consumer) | 如果存在值，则让指定的使用者接受该值，否则什么也不做。 |
| boolean | isPresent() | 如果存在值，则返回 true，否则返回 false。 |
| static OptionalLong | of(long value) | 返回具有指定值的 OptionalLong。 |
| long | orElse(long other) | 如果存在则返回值，否则返回其他值。 |
| long | orElseGet(LongSupplier other) | 如果存在则返回该值，否则调用其他值并返回该调用的结果。 |
| <X extends Throwable>long | orElseThrow(Supplier<X> exceptionSupplier) | 如果存在，则返回包含的值，否则抛出由提供的供应商创建的异常。 |
| 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。
参数：
| 参数名称 | 参数描述 |
|---|---|
| value | 存在的值 |
返回:
具有当前值的 OptionalLong
public long getAsLong()
如果此 OptionalLong 中存在值，则返回该值，否则抛出 NoSuchElementException。
返回:
此 OptionalLong 持有的值
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NoSuchElementException | 如果不存在值 |
public boolean isPresent()
如果存在值，则返回 true，否则返回 false。
返回:
如果存在值，则为 true，否则为 false
public void ifPresent(LongConsumer consumer)
如果存在值，则让指定的使用者接受该值，否则什么也不做。
参数：
| 参数名称 | 参数描述 |
|---|---|
| consumer | 如果存在值则执行块 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果值存在且 consumer 为空 |
public long orElse(long other)
如果存在则返回值，否则返回其他值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| other | 不存在值时要返回的值 |
返回:
该值（如果存在），否则为其他
public long orElseGet(LongSupplier other)
如果存在则返回该值，否则调用其他值并返回该调用的结果。
参数：
| 参数名称 | 参数描述 |
|---|---|
| other | 一个 LongSupplier，如果不存在值则返回其结果 |
返回:
该值如果存在，否则为 other.getAsLong() 的结果
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果 value 不存在并且 other 为 null |
public <X extends Throwable> long orElseThrow(Supplier<X> exceptionSupplier) throws X extends Throwable
如果存在，则返回包含的值，否则抛出由提供的供应商创建的异常。
类型参数：
| 类型参数名称 | 类型参数描述 |
|---|---|
| X | 要抛出的异常的类型 |
参数:
| 参数名称 | 参数描述 |
|---|---|
| exceptionSupplier | 将返回要抛出的异常的供应商 |
返回:
现在的值
Throws:
| Throw名称 | Throw描述 |
|---|---|
| X | 如果不存在值 |
| NullPointerException | 如果不存在任何值且 exceptionSupplier 为 null |
| X extends Throwable |
public boolean equals(Object obj)
指示某个其他对象是否“等于”此 OptionalLong。 如果满足以下条件，则认为另一个对象相等：
覆盖：
类 Object 中的等于
参数：
| 参数名称 | 参数描述 |
|---|---|
| obj | 要测试是否相等的对象 |
返回:
{code true} 如果另一个对象“等于”这个对象，否则为 false
public int hashCode()
返回当前值的哈希码值（如果有）；如果不存在值，则返回 0（零）。
覆盖：
类 Object 中的 hashCode
返回:
当前值的哈希码值，如果不存在值，则为 0
public String toString()
返回对象的字符串表示形式。 通常，toString 方法返回一个“以文本方式表示”该对象的字符串。 结果应该是一个简洁但信息丰富的表示，易于人们阅读。 建议所有子类重写此方法。
Object 类的 toString 方法返回一个字符串，该字符串由对象作为实例的类的名称、at 符号字符“@”和对象的哈希码的无符号十六进制表示形式组成。 换句话说，此方法返回一个等于以下值的字符串：
getClass().getName() + '@' + Integer.toHexString(hashCode())
返回此对象的适合调试的非空字符串表示形式。 确切的表示格式未指定，并且可能因实现和版本而异。
覆盖：
类 Object 中的 toString
返回:
此实例的字符串表示形式
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。