- java.lang.Object
-
- java.util.OptionalDouble
-
public final class OptionalDouble extends Object
容器对象,可能包含也可能不包含double
值。 如果存在值,则isPresent()
返回true
。 如果不存在任何值,则该对象被视为空 ,isPresent()
返回false
。提供了依赖于是否存在包含值的其他方法,例如
orElse()
(如果不存在值则返回默认值)和ifPresent()
(如果存在值则执行操作)。这是一个value-based类; 在
OptionalDouble
实例上使用身份敏感操作(包括引用相等(==
),标识哈希码或同步)可能会产生不可预测的结果,应该避免使用。- API Note:
-
OptionalDouble
主要用作方法返回类型,明确需要表示“无结果”。 类型为OptionalDouble
变量本身不应该是null
; 它应始终指向OptionalDouble
实例。 - 从以下版本开始:
- 1.8
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 static OptionalDouble
empty()
返回一个空的OptionalDouble
实例。boolean
equals(Object obj)
指示某个其他对象是否“等于”此OptionalDouble
。double
getAsDouble()
如果存在值,则返回该值,否则抛出NoSuchElementException
。int
hashCode()
返回值的哈希码(如果存在),否则0
(零)(如果不存在值)。void
ifPresent(DoubleConsumer action)
如果存在值,则使用值执行给定操作,否则不执行任何操作。void
ifPresentOrElse(DoubleConsumer action, Runnable emptyAction)
如果存在值,则使用值执行给定操作,否则执行给定的基于空的操作。boolean
isEmpty()
如果值不存在,则返回true
,否则返回false
。boolean
isPresent()
如果存在值,则返回true
,否则返回false
。static OptionalDouble
of(double value)
返回描述给定值的OptionalDouble
。double
orElse(double other)
如果存在值,则返回该值,否则返回other
。double
orElseGet(DoubleSupplier supplier)
如果存在值,则返回该值,否则返回由供应函数生成的结果。double
orElseThrow()
如果存在值,则返回该值,否则抛出NoSuchElementException
。<X extends Throwable>
doubleorElseThrow(Supplier<? extends X> exceptionSupplier)
如果存在值,则返回该值,否则抛出异常提供函数生成的异常。DoubleStream
stream()
如果存在值,则返回仅包含该值的顺序DoubleStream
,否则返回空DoubleStream
。String
toString()
返回适合调试的OptionalDouble
的非空字符串表示形式。
-
-
-
方法详细信息
-
empty
public static OptionalDouble empty()
返回一个空的OptionalDouble
实例。 此OptionalDouble
没有值。- API Note:
-
虽然它可能是很有诱惑力的话,避免测试如果一个对象是通过比较空
==
对抗返回实例OptionalDouble.empty()
。 无法保证它是单身人士。 相反,请使用isPresent()
。 - 结果
-
空
OptionalDouble
。
-
of
public static OptionalDouble of(double value)
返回描述给定值的OptionalDouble
。- 参数
-
value
- 要描述的值 - 结果
-
值
OptionalDouble
-
getAsDouble
public double getAsDouble()
如果存在值,则返回该值,否则抛出NoSuchElementException
。- API Note:
-
该方法的优选替代方案是
orElseThrow()
。 - 结果
-
此
OptionalDouble
描述的值 - 异常
-
NoSuchElementException
- 如果没有值
-
isPresent
public boolean isPresent()
如果存在值,则返回true
,否则返回false
。- 结果
-
true
如果存在值,否则为false
-
isEmpty
public boolean isEmpty()
如果值不存在,则返回true
,否则返回false
。- 结果
-
true
如果值不存在,否则为false
- 从以下版本开始:
- 11
-
ifPresent
public void ifPresent(DoubleConsumer action)
如果存在值,则使用值执行给定操作,否则不执行任何操作。- 参数
-
action
- 如果存在值,则执行的操作 - 异常
-
NullPointerException
- 如果存在值且给定操作为null
-
ifPresentOrElse
public void ifPresentOrElse(DoubleConsumer action, Runnable emptyAction)
如果存在值,则使用值执行给定操作,否则执行给定的基于空的操作。- 参数
-
action
- 如果存在值,则执行的操作 -
emptyAction
- 如果没有值,则执行基于空的操作 - 异常
-
NullPointerException
- 如果存在值且给定操作为null
,或者不存在任何值且给定的基于空的操作为null
。 - 从以下版本开始:
- 9
-
stream
public DoubleStream stream()
如果存在值,则返回仅包含该值的顺序DoubleStream
,否则返回空DoubleStream
。- API Note:
-
此方法可用于将
Stream
的可选双精度DoubleStream
为当前双精度的DoubleStream
:Stream<OptionalDouble> os = .. DoubleStream s = os.flatMapToDouble(OptionalDouble::stream)
- 结果
-
可选值为
DoubleStream
- 从以下版本开始:
- 9
-
orElse
public double orElse(double other)
如果存在值,则返回该值,否则返回other
。- 参数
-
other
- 如果没有值,则返回值 - 结果
-
值,如果存在,否则
other
-
orElseGet
public double orElseGet(DoubleSupplier supplier)
如果存在值,则返回该值,否则返回由供应函数生成的结果。- 参数
-
supplier
- 生成要返回的值的供应函数 - 结果
- 值,如果存在,否则由供应函数产生的结果
- 异常
-
NullPointerException
- 如果没有值且供应功能为null
-
orElseThrow
public double orElseThrow()
如果存在值,则返回该值,否则抛出NoSuchElementException
。- 结果
-
此
OptionalDouble
描述的值 - 异常
-
NoSuchElementException
- 如果没有值 - 从以下版本开始:
- 10
-
orElseThrow
public <X extends Throwable> double orElseThrow(Supplier<? extends X> exceptionSupplier) throws X extends Throwable
如果存在值,则返回该值,否则抛出异常提供函数生成的异常。- API Note:
-
具有空参数列表的异常构造函数的方法引用可用作供应商。
例如,
IllegalStateException::new
- 参数类型
-
X
- 要引发的异常的类型 - 参数
-
exceptionSupplier
- 生成要抛出的异常的供应函数 - 结果
- 价值,如果存在
- 异常
-
X
- 如果没有值 -
NullPointerException
- 如果没有值,则异常提供功能为null
-
X extends Throwable
-
equals
public boolean equals(Object obj)
指示某个其他对象是否“等于”此OptionalDouble
。 如果符合以下条件,则认为另一个对- 它也是
OptionalDouble
和; - 两个实例都没有价值或;
- 现在的值通过
Double.compare() == 0
相互“等于”。
- 重写:
-
equals
类Object
- 参数
-
obj
- 要进行相等性测试的对象 - 结果
-
true
如果另一个对象“等于”此对象,否则为false
- 另请参见:
-
Object.hashCode()
,HashMap
- 它也是
-
hashCode
public int hashCode()
返回值的哈希码(如果存在),否则0
(零)(如果不存在值)。- 重写:
-
hashCode
类Object
- 结果
-
如果没有值,则为当前值的哈希码值或
0
- 另请参见:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-