Класс OptionalInt

public static OptionalInt empty()

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

Как бы ни было заманчиво поступить иначе, не проверяйте, пуст ли объект, сравнивая его с == или проверяя его на равенство с помощью != для экземпляров, возвращённых методом OptionalInt.empty(). Нет гарантии, что это синглтон. Вместо этого используйте isEmpty() или isPresent().

Возвращает:

пустой OptionalInt

public static OptionalInt of(int value)

Параметры:

value — значение для описания

Возвращает:

OptionalInt, содержащее значение

public int getAsInt()

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

Предпочтительной альтернативой этому методу является orElseThrow().

Возвращает:

значение, описанное этим OptionalInt

Выбрасывает:

NoSuchElementException — если значение отсутствует

public boolean isPresent()

Возвращает:

true, если значение присутствует, иначе false

public boolean isEmpty()

Возвращает:

true, если значение отсутствует, иначе false

Начиная с версии:

11

public void ifPresent(IntConsumer action)

Параметры:

action — действие, которое нужно выполнить, если значение присутствует

Выбрасывает:

NullPointerException — если значение присутствует, а указанное действие равно null

public void ifPresentOrElse(IntConsumer action, Runnable emptyAction)

Параметры:

action — действие, которое нужно выполнить, если значение присутствует

emptyAction — действие для пустого значения, которое нужно выполнить, если значение отсутствует

Выбрасывает:

NullPointerException — если значение присутствует, а указанное действие равно null, либо если значение отсутствует, а указанное действие для пустого значения равно null.

Начиная с версии:

9

public IntStream stream()

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

Этот метод можно использовать для преобразования Stream необязательных целых чисел в IntStream присутствующих целых чисел:

    Stream<OptionalInt> os = ..
    IntStream s = os.flatMapToInt(OptionalInt::stream)

Возвращает:

необязательное значение в виде IntStream

Начиная с версии:

9

public int orElse(int other)

Параметры:

other — значение, которое нужно вернуть, если значение отсутствует

Возвращает:

значение, если оно присутствует, иначе other

public int orElseGet(IntSupplier supplier)

Параметры:

supplier — функция-поставщик, создающая возвращаемое значение

Возвращает:

значение, если оно присутствует, иначе результат, полученный от функции-поставщика

Выбрасывает:

NullPointerException — если значение отсутствует, а функция-поставщик равна null

public int orElseThrow()

Возвращает:

значение, описанное этим OptionalInt

Выбрасывает:

NoSuchElementException — если значение отсутствует

Начиная с версии:

10

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

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

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

Параметры типа:

X — тип выбрасываемого исключения

Параметры:

exceptionSupplier — функция-поставщик, создающая исключение для выбрасывания

Возвращает:

значение, если оно присутствует

Выбрасывает:

X — если значение отсутствует

NullPointerException — если значение отсутствует, а функция-поставщик исключения равна null

public boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj — объект, равенство которого проверяется

Возвращает:

true, если другой объект «равен» этому объекту, иначе false

См. также:

• Object.hashCode()
• HashMap

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код присутствующего значения или 0, если значение отсутствует

См. также:

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

public String toString()

Переопределяет:

toString в классе Object

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

Если значение присутствует, результат должен включать его строковое представление. Пустые и содержащие значение OptionalInt должны однозначно различаться.

Возвращает:

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