OptionalLong (Java Platform SE 8 )

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
    
    实现要求：
    
    如果存在值，则结果必须在其结果中包含其字符串表示形式。空的和现实的实例必须毫不含糊地区分开来。
    
    结果
    
    该实例的字符串表示形式

Class OptionalLong

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

empty

of

getAsLong

isPresent

ifPresent

orElse

orElseGet

orElseThrow

equals

hashCode

toString