compact1, compact2, compact3

java.util

Class OptionalLong

java.lang.Object

java.util.OptionalLong

public final class OptionalLong
extends Object

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

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

这是一个value-based课; 使用身份敏感的操作（包括引用相等（的==上的实例），标识哈希码，或同步） OptionalLong可具有不可预测的结果，应当避免。

从以下版本开始：

1.8

方法摘要

Modifier and Type	Method and Description
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) 返回值如果存在，否则返回 other 。
long	orElseGet(LongSupplier other) 返回值（如果存在），否则调用 other并返回该调用的结果。
<X extends Throwable> long	orElseThrow(Supplier<X> exceptionSupplier) 返回包含的值（如果存在），否则抛出由提供的供应商创建的异常。
String	toString() 返回对象的字符串表示形式。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

方法详细信息

empty

public static OptionalLong empty()

返回一个空的OptionalLong实例。 此OptionalLong不存在值。

API Note:

虽然这样做可能是诱人的，但如果Option.empty()返回的Option.empty()与==进行比较，那么避免测试对象是否为空。 不能保证是单身人士。 相反，请使用isPresent() 。

结果

一个空的 OptionalLong 。

of

public static OptionalLong of(long value)

返回一个 OptionalLong具有指定值存在。

参数

value - 要存在的值

结果

一个 OptionalLong值存在

getAsLong

public long getAsLong()

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

结果

由 OptionalLong持有的价值

异常

NoSuchElementException - 如果没有值存在

另请参见：

isPresent()

isPresent

public boolean isPresent()

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

结果

true如果存在值，否则为 false

ifPresent

public void ifPresent(LongConsumer consumer)

让指定的消费者接受该值，如果一个值存在，否则什么也不做。

参数

consumer - 如果存在值，则执行块

异常

NullPointerException - 如果值存在且 consumer为空

orElse

public long orElse(long other)

返回值如果存在，否则返回 other 。

参数

other - 如果没有值存在，返回的值

结果

价值，如果存在，否则 other

orElseGet

public long orElseGet(LongSupplier other)

返回值（如果存在），否则调用 other并返回该调用的结果。

参数

other - 一个 LongSupplier ，如果没有值，则返回其结果

结果

的值（如果存在）的结果的其他方式 other.getAsLong()

异常

NullPointerException - 如果值不存在，并且 other为空

orElseThrow

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

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

API Note:

可以使用具有空参数列表的异常构造函数的方法引用作为供应商。 例如， IllegalStateException::new

参数类型

X - 要抛出的异常的类型

参数

exceptionSupplier - 将返回被抛出的异常的供应商

结果

现值

异常

X - 如果没有值存在

NullPointerException - 如果没有值， exceptionSupplier为null

X extends Throwable

equals

public boolean equals(Object obj)

指示一些其他对象是否等于此OptionalLong。 另一个对象被认为是相等的：

• 它也是一个OptionalLong和;
• 或者;
• 现在的值通过== “相等”。

重写：

equals在类别 Object

参数

obj - 要进行相等测试的对象

结果

{code true}如果另一个对象是“等于”这个对象否则 false

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回当前值的哈希码值（如果有的话），如果没有值，则返回0（零）。

重写：

hashCode在 Object

结果

当前值的哈希码值，如果没有值，则为0

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

toString

public String toString()

返回对象的字符串表示形式。 一般来说， toString方法返回一个字符串“textually代表”这个对象。 结果应该是一个简明扼要的表达，容易让人阅读。 建议所有子类覆盖此方法。

该toString类方法Object返回一个由其中的对象是一个实例，该符号字符`的类的名称的字符串@ ”和对象的哈希码的无符号的十六进制表示。 换句话说，这个方法返回一个等于下列值的字符串：

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

返回适用于调试的此对象的非空字符串表示形式。 准确的表示格式是未指定的，可能会在实现和版本之间变化。

重写：

toString在 Object

实现要求：

如果存在值，则结果必须在其结果中包含其字符串表示形式。 空的和现实的实例必须毫不含糊地区分开来。

结果

该实例的字符串表示形式