compact1, compact2, compact3

java.util

Класс OptionalLong

java.lang. Объект

java.util. OptionalLong

public final class OptionalLong
extends Object

Контейнерный объект, который может или, возможно, не содержит a long значение. Если значение присутствует, isPresent() возвратится true и get() возвратит значение.

Дополнительные методы, которые зависят от присутствия или отсутствия содержавшего значения, обеспечиваются, такой как orElse() (возвратите значение по умолчанию если значение, не существующее), и ifPresent() (выполните блок кода, если значение присутствует).

С тех пор:

1.8

Сводка метода

Модификатор и Тип	Метод и Описание
static OptionalLong	empty() Возвращает пустое OptionalLong экземпляр.
boolean	equals(Object obj) Указывает, " ли некоторый другой объект равен" этому Дополнительному.
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) Возвратите содержавшее значение, если есть иначе выдайте исключение, которое будет создаваться предоставленным поставщиком.
Строка	toString() Возвращает непустое строковое представление этого OptionalLong, подходящего для того, чтобы отладить.

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь метода

пустой

public static OptionalLong empty()

Возвращает пустое OptionalLong экземпляр. Никакое значение не присутствует для этого OptionalLong.

Примечание API:

Хотя может быть заманчиво сделать так, избежать тестировать, если объект пуст, сравниваясь с == против экземпляров, возвращенных Option.empty(). Нет никакой гарантии, что это - одиночный элемент. Вместо этого используйте isPresent().

Возвраты:

пустое OptionalLong.

из

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 - a LongSupplier чей результат возвращается, если никакое значение не присутствует

Возвраты:

значение, если существующий иначе результат other.getAsLong()

Броски:

NullPointerException - если значение не присутствует и other нуль

orElseThrow

public <X extends Throwable> long orElseThrow(Supplier<X> exceptionSupplier)
                                       throws X extends Throwable

Возвратите содержавшее значение, если есть иначе выдайте исключение, которое будет создаваться предоставленным поставщиком.

Примечание API:

Ссылка метода на конструктора исключения с пустым списком параметров может использоваться в качестве поставщика. Например, IllegalStateException::new

Введите Параметры:

X - Тип исключения, которое будет брошено

Параметры:

exceptionSupplier - Поставщик, который возвратит исключение, которое будет брошено

Возвраты:

текущая стоимость

Броски:

X - если нет никакого существующего значения

NullPointerException - если никакое значение не присутствует и exceptionSupplier нуль

X extends Throwable

равняется

public boolean equals(Object obj)

Указывает, " ли некоторый другой объект равен" этому Дополнительному. Другой объект считают равным если:

• это также OptionalInt и;
• у обоих экземпляров нет никакого существующего значения или;
• текущая стоимость "равна" друг другу через ==.

Переопределения:

equals в class Object

Параметры:

obj - объект, который будет протестирован на равенство

Возвраты:

{кодируют истину}, если другой объект "равен" этому объекту иначе false

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Возвращает значение хэш-кода текущей стоимости, если таковые вообще имеются, или 0 (нуль), если никакое значение не присутствует.

Переопределения:

hashCode в class Object

Возвраты:

значение хэш-кода текущей стоимости или 0, если никакое значение не присутствует

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает непустое строковое представление этого OptionalLong, подходящего для того, чтобы отладить. Точный формат представления является неуказанным и может измениться между реализациями и версиями.

Переопределения:

toString в class Object

Требования реализации:

Если значение присутствует, результат должен включать свое строковое представление в результат. Пустой и существующий OptionalLongs должен быть однозначно дифференцируемым.

Возвраты:

строковое представление этого экземпляра