树叶云鸿蒙OS教程：鸿蒙OS OptionalLong

OptionalLong

java.lang.Object

|—java.util.OptionalLong

public final class OptionalLong
extends Object

一个容器对象，可能包含也可能不包含 long 值。 如果存在值，isPresent() 将返回 true，而 getAsLong() 将返回该值。

提供了依赖于包含值是否存在的其他方法，例如 orElse() （如果值不存在则返回默认值）和 ifPresent() （如果值存在则执行代码块）。

这是一个基于值的类； 在 OptionalLong 的实例上使用身份敏感操作（包括引用相等 (==)、身份哈希码或同步）可能会产生不可预知的结果，应该避免。

方法总结

方法详情

empty

public static OptionalLong empty()

返回一个空的 OptionalLong 实例。 此 OptionalLong 没有值。

返回:

一个空的 OptionalLong。

of

public static OptionalLong of(long value)

返回具有指定值的 OptionalLong。

参数：

返回:

具有当前值的 OptionalLong

getAsLong

public long getAsLong()

如果此 OptionalLong 中存在值，则返回该值，否则抛出 NoSuchElementException。

返回:

此 OptionalLong 持有的值

Throws:

isPresent

public boolean isPresent()

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

返回:

如果存在值，则为 true，否则为 false

ifPresent

public void ifPresent(LongConsumer consumer)

如果存在值，则让指定的使用者接受该值，否则什么也不做。

参数：

Throws:

orElse

public long orElse(long other)

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

参数：

返回:

该值（如果存在），否则为其他

orElseGet

public long orElseGet(LongSupplier other)

如果存在则返回该值，否则调用其他值并返回该调用的结果。

参数：

返回:

该值如果存在，否则为 other.getAsLong() 的结果

Throws:

orElseThrow

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

如果存在，则返回包含的值，否则抛出由提供的供应商创建的异常。

类型参数：

参数:

返回:

现在的值

Throws:

equals

public boolean equals(Object obj)

指示某个其他对象是否“等于”此 OptionalLong。 如果满足以下条件，则认为另一个对象相等：

• 它也是一个 OptionalLong 和；
• 两个实例都没有价值，或者；
• 当前值通过 == 彼此“相等”。

覆盖：

类 Object 中的等于

参数：

返回:

{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

返回:

此实例的字符串表示形式