Class OptionalDouble
- java.lang.Object
-
- java.util.OptionalDouble
-
public final class OptionalDouble extends Object
A container object which may or may not contain adouble
value. If a value is present,isPresent()
will returntrue
andgetAsDouble()
will return the value.Additional methods that depend on the presence or absence of a contained value are provided, such as
orElse()
(return a default value if value not present) andifPresent()
(execute a block of code if the value is present).This is a value-based class; use of identity-sensitive operations (including reference equality (
==
), identity hash code, or synchronization) on instances ofOptionalDouble
may have unpredictable results and should be avoided.- Since:
- 1.8
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method and Description static OptionalDouble
empty()
Returns an emptyOptionalDouble
instance.boolean
equals(Object obj)
Indicates whether some other object is "equal to" this OptionalDouble.double
getAsDouble()
If a value is present in thisOptionalDouble
, returns the value, otherwise throwsNoSuchElementException
.int
hashCode()
Returns the hash code value of the present value, if any, or 0 (zero) if no value is present.void
ifPresent(DoubleConsumer consumer)
Have the specified consumer accept the value if a value is present, otherwise do nothing.boolean
isPresent()
Returntrue
if there is a value present, otherwisefalse
.static OptionalDouble
of(double value)
Return anOptionalDouble
with the specified value present.double
orElse(double other)
Return the value if present, otherwise returnother
.double
orElseGet(DoubleSupplier other)
Return the value if present, otherwise invokeother
and return the result of that invocation.<X extends Throwable>
doubleorElseThrow(Supplier<X> exceptionSupplier)
Return the contained value, if present, otherwise throw an exception to be created by the provided supplier.String
toString()
Returns a string representation of the object.
-
-
-
Method Detail
empty
public static OptionalDouble empty()
Returns an emptyOptionalDouble
instance. No value is present for this OptionalDouble.- API Note:
-
Though it may be tempting to do so, avoid testing if an object is empty by comparing with
==
against instances returned byOption.empty()
. There is no guarantee that it is a singleton. Instead, useisPresent()
. - Returns:
-
an empty
OptionalDouble
.
of
public static OptionalDouble of(double value)
Return anOptionalDouble
with the specified value present.- Parameters:
-
value
- the value to be present - Returns:
-
an
OptionalDouble
with the value present
getAsDouble
public double getAsDouble()
If a value is present in thisOptionalDouble
, returns the value, otherwise throwsNoSuchElementException
.- Returns:
-
the value held by this
OptionalDouble
- Throws:
-
NoSuchElementException
- if there is no value present - See Also:
-
isPresent()
isPresent
public boolean isPresent()
Returntrue
if there is a value present, otherwisefalse
.- Returns:
-
true
if there is a value present, otherwisefalse
ifPresent
public void ifPresent(DoubleConsumer consumer)
Have the specified consumer accept the value if a value is present, otherwise do nothing.- Parameters:
-
consumer
- block to be executed if a value is present - Throws:
-
NullPointerException
- if value is present andconsumer
is null
orElse
public double orElse(double other)
Return the value if present, otherwise returnother
.- Parameters:
-
other
- the value to be returned if there is no value present - Returns:
-
the value, if present, otherwise
other
orElseGet
public double orElseGet(DoubleSupplier other)
Return the value if present, otherwise invokeother
and return the result of that invocation.- Parameters:
-
other
- aDoubleSupplier
whose result is returned if no value is present - Returns:
-
the value if present otherwise the result of
other.getAsDouble()
- Throws:
-
NullPointerException
- if value is not present andother
is null
orElseThrow
public <X extends Throwable> double orElseThrow(Supplier<X> exceptionSupplier) throws X extends Throwable
Return the contained value, if present, otherwise throw an exception to be created by the provided supplier.- API Note:
-
A method reference to the exception constructor with an empty argument list can be used as the supplier. For example,
IllegalStateException::new
- Type Parameters:
-
X
- Type of the exception to be thrown - Parameters:
-
exceptionSupplier
- The supplier which will return the exception to be thrown - Returns:
- the present value
- Throws:
-
X
- if there is no value present -
NullPointerException
- if no value is present andexceptionSupplier
is null -
X extends Throwable
equals
public boolean equals(Object obj)
Indicates whether some other object is "equal to" this OptionalDouble. The other object is considered equal if:- it is also an
OptionalDouble
and; - both instances have no value present or;
- the present values are "equal to" each other via
Double.compare() == 0
.
- Overrides:
-
equals
in classObject
- Parameters:
-
obj
- an object to be tested for equality - Returns:
-
{code true} if the other object is "equal to" this object otherwise
false
- See Also:
-
Object.hashCode()
,HashMap
- it is also an
hashCode
public int hashCode()
Returns the hash code value of the present value, if any, or 0 (zero) if no value is present.- Overrides:
-
hashCode
in classObject
- Returns:
- hash code value of the present value or 0 if no value is present
- See Also:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
toString
public String toString()
Returns a string representation of the object. In general, thetoString
method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.The
toString
method for classObject
returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@
', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:getClass().getName() + '@' + Integer.toHexString(hashCode())
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.