Added in API level 24

OptionalDouble

class OptionalDouble

kotlin.Any
↳	java.util.OptionalDouble

A container object which may or may not contain a double value. If a value is present, isPresent() will return true and getAsDouble() 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) and ifPresent() (execute a block of code if the value is present).

Summary

Public methods
static OptionalDouble!	`empty()` Returns an empty `OptionalDouble` instance.
Boolean	`equals(other: Any?)` Indicates whether some other object is "equal to" this OptionalDouble.
Double	`getAsDouble()` If a value is present in this `OptionalDouble`, returns the value, otherwise throws `NoSuchElementException`.
Int	`hashCode()` Returns the hash code value of the present value, if any, or 0 (zero) if no value is present.
Unit	`ifPresent(consumer: DoubleConsumer!)` Have the specified consumer accept the value if a value is present, otherwise do nothing.
Boolean	`isPresent()` Return `true` if there is a value present, otherwise `false`.
static OptionalDouble!	`of(value: Double)` Return an `OptionalDouble` with the specified value present.
Double	`orElse(other: Double)` Return the value if present, otherwise return `other`.
Double	`orElseGet(other: DoubleSupplier!)` Return the value if present, otherwise invoke `other` and return the result of that invocation.
Double	`orElseThrow(exceptionSupplier: Supplier<X>!)` 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.

Public methods

empty

Added in API level 24

static fun empty(): OptionalDouble!

Returns an empty OptionalDouble instance. No value is present for this OptionalDouble.

Return
`OptionalDouble!`	an empty `OptionalDouble`.

equals

Added in API level 24

fun equals(other: Any?): Boolean

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.

Parameters
`obj`	an object to be tested for equality

Return
`Boolean`	{code true} if the other object is "equal to" this object otherwise `false`

getAsDouble

Added in API level 24

fun getAsDouble(): Double

If a value is present in this OptionalDouble, returns the value, otherwise throws NoSuchElementException.

Return
`Double`	the value held by this `OptionalDouble`

Exceptions
`java.util.NoSuchElementException`	if there is no value present

See Also

java.util.OptionalDouble#isPresent()

hashCode

Added in API level 24

fun hashCode(): Int

Returns the hash code value of the present value, if any, or 0 (zero) if no value is present.

Return
`Int`	hash code value of the present value or 0 if no value is present

ifPresent

Added in API level 24

fun ifPresent(consumer: DoubleConsumer!): Unit

Have the specified consumer accept the value if a value is present, otherwise do nothing.

Parameters
`consumer`	DoubleConsumer!: block to be executed if a value is present

Exceptions
`java.lang.NullPointerException`	if value is present and `consumer` is null

isPresent

Added in API level 24

fun isPresent(): Boolean

Return true if there is a value present, otherwise false.

Return
`Boolean`	`true` if there is a value present, otherwise `false`

of

Added in API level 24

static fun of(value: Double): OptionalDouble!

Return an OptionalDouble with the specified value present.

Parameters
`value`	Double: the value to be present

Return
`OptionalDouble!`	an `OptionalDouble` with the value present

orElse

Added in API level 24

fun orElse(other: Double): Double

Return the value if present, otherwise return other.

Parameters
`other`	Double: the value to be returned if there is no value present

Return
`Double`	the value, if present, otherwise `other`

orElseGet

Added in API level 24

fun orElseGet(other: DoubleSupplier!): Double

Return the value if present, otherwise invoke other and return the result of that invocation.

Parameters
`other`	DoubleSupplier!: a `DoubleSupplier` whose result is returned if no value is present

Return
`Double`	the value if present otherwise the result of `other.getAsDouble()`

Exceptions
`java.lang.NullPointerException`	if value is not present and `other` is null

orElseThrow

Added in API level 24

fun <X : Throwable!> orElseThrow(exceptionSupplier: Supplier<X>!): Double

Return the contained value, if present, otherwise throw an exception to be created by the provided supplier.

Parameters
`<X>`	Type of the exception to be thrown
`exceptionSupplier`	Supplier<X>!: The supplier which will return the exception to be thrown

Return
`Double`	the present value

Exceptions
`X`	if there is no value present
`java.lang.NullPointerException`	if no value is present and `exceptionSupplier` is null

toString

Added in API level 24

fun toString(): String

Returns a string representation of the object. In general, the toString 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 class Object 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())

Returns a non-empty string representation of this object suitable for debugging. The exact presentation format is unspecified and may vary between implementations and versions.

Return
`String`	the string representation of this instance