Added in API level 24

OptionalLong

class OptionalLong

kotlin.Any
↳	java.util.OptionalLong

A container object which may or may not contain a long value. If a value is present, isPresent() will return true and getAsLong() 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 OptionalLong!	`empty()` Returns an empty `OptionalLong` instance.
Boolean	`equals(other: Any?)` Indicates whether some other object is "equal to" this OptionalLong.
Long	`getAsLong()` If a value is present in this `OptionalLong`, 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: LongConsumer!)` 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 OptionalLong!	`of(value: Long)` Return an `OptionalLong` with the specified value present.
Long	`orElse(other: Long)` Return the value if present, otherwise return `other`.
Long	`orElseGet(other: LongSupplier!)` Return the value if present, otherwise invoke `other` and return the result of that invocation.
Long	`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(): OptionalLong!

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

Return
`OptionalLong!`	an empty `OptionalLong`.

equals

Added in API level 24

fun equals(other: Any?): Boolean

Indicates whether some other object is "equal to" this OptionalLong. The other object is considered equal if:

it is also an OptionalLong and;
both instances have no value present or;
the present values are "equal to" each other via ==.

Parameters
`obj`	an object to be tested for equality

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

getAsLong

Added in API level 24

fun getAsLong(): Long

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

Return
`Long`	the value held by this `OptionalLong`

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

See Also

java.util.OptionalLong#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: LongConsumer!): Unit

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

Parameters
`consumer`	LongConsumer!: 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: Long): OptionalLong!

Return an OptionalLong with the specified value present.

Parameters
`value`	Long: the value to be present

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

orElse

Added in API level 24

fun orElse(other: Long): Long

Return the value if present, otherwise return other.

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

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

orElseGet

Added in API level 24

fun orElseGet(other: LongSupplier!): Long

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

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

Return
`Long`	the value if present otherwise the result of `other.getAsLong()`

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>!): Long

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
`Long`	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