Класс OptionalLong

java.lang.Object

java.util.OptionalLong

public final class OptionalLong extends Object

Объект-контейнер, который может или не может содержать значение. Если значение присутствует, метод isPresent() возвращает true. Если значение отсутствует, объект считается пустым, и метод isPresent() возвращает false.

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

Это класс с базисом-значением; программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать экземпляры для синхронизации, иначе может произойти непредсказуемое поведение. Например, в будущих релизах синхронизация может не работать корректно.

API Note:: OptionalLong предназначен в первую очередь для использования в качестве типа возвращаемого значения метода, где явно требуется представление "отсутствия результата". Переменная, тип которой является OptionalLong, никогда не должна сама быть null; она всегда должна указывать на экземпляр OptionalLong.
Since:: 1.8

Краткое описание методов

Модификатор и тип	Метод	Описание
`static OptionalLong`	`empty()`	Возвращает пустой экземпляр `OptionalLong`.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект "равным" этому объекту `OptionalLong`.
`long`	`getAsLong()`	Если значение присутствует, возвращает значение, в противном случае генерирует исключение `NoSuchElementException`.
`int`	`hashCode()`	Возвращает хэш-код значения, если оно присутствует, в противном случае возвращает `0` (ноль), если значение отсутствует.
`void`	`ifPresent(LongConsumer action)`	Если значение присутствует, выполняет заданное действие со значением, в противном случае ничего не делает.
`void`	`ifPresentOrElse(LongConsumer action, Runnable emptyAction)`	Если значение присутствует, выполняет заданное действие со значением, в противном случае выполняет заданное действие для пустого случая.
`boolean`	`isEmpty()`	Если значение отсутствует, возвращает `true`, в противном случае возвращает `false`.
`boolean`	`isPresent()`	Если значение присутствует, возвращает `true`, в противном случае возвращает `false`.
`static OptionalLong`	`of(long value)`	Возвращает строку, описывающую данное значение.
`long`	`orElse(long other)`	Если значение присутствует, возвращает значение, в противном случае возвращает `other`.
`long`	`orElseGet(LongSupplier supplier)`	Если значение присутствует, возвращает значение, в противном случае возвращает результат, полученный от поставщика функции.
`long`	`orElseThrow()`	Если значение присутствует, возвращает значение, в противном случае генерирует исключение `NoSuchElementException`.
`<X extends Throwable> long`	`orElseThrow(Supplier<? extends X> exceptionSupplier)`	Если значение присутствует, возвращает значение, в противном случае генерирует исключение, сгенерированное функцией генерации исключений.
`LongStream`	`stream()`	Если значение присутствует, возвращает последовательную `LongStream`, содержащую только это значение, в противном случае возвращает пустую `LongStream`.
`String`	`toString()`	Возвращает строковое представление этого объекта `OptionalLong`, подходящее для отладки.

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

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

Подробное описание методов

empty

public static OptionalLong empty()

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

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

of

public static OptionalLong of(long value)

Возвращает OptionalLong, описывающий заданное значение.

Параметры:: value - значение для описания
Возвращает:: OptionalLong со значением

getAsLong

public long getAsLong()

Если значение присутствует, возвращает значение, в противном случае выбрасывает NoSuchElementException.

Примечание API:: Предпочтительный альтернативный метод — orElseThrow().
Возвращает:: значение, описанное этим OptionalLong
Выбрасывает:: NoSuchElementException - если значение отсутствует

isPresent

public boolean isPresent()

Если значение присутствует, возвращает true, в противном случае false.

Возвращает:: true, если значение присутствует, в противном случае false

isEmpty

public boolean isEmpty()

Если значение отсутствует, возвращает true, в противном случае false.

Возвращает:: true, если значение отсутствует, в противном случае false
С:: 11

ifPresent

public void ifPresent(LongConsumer action)

Если значение присутствует, выполняет заданное действие со значением, в противном случае ничего не делает.

Параметры:: action - действие, которое должно быть выполнено, если значение присутствует
Выбрасывает:: NullPointerException - если значение присутствует, и заданное действие является null

ifPresentOrElse

public void ifPresentOrElse(LongConsumer action, Runnable emptyAction)

Если значение присутствует, выполняет заданное действие со значением, в противном случае выполняет заданное действие по умолчанию.

Параметры:: action - действие, которое должно быть выполнено, если значение присутствует; emptyAction - действие по умолчанию, которое должно быть выполнено, если значение отсутствует
Выбрасывает:: NullPointerException - если значение присутствует, и заданное действие является null, или значение отсутствует, а заданное действие по умолчанию является null.
С:: 9

stream

public LongStream stream()

Если значение присутствует, возвращает последовательную LongStream, содержащую только это значение, в противном случае возвращает пустой LongStream.

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

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


     Stream<OptionalLong> os = ..
     LongStream s = os.flatMapToLong(OptionalLong::stream)

Возвращает:

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

С:

orElse

public long orElse(long other)

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

Параметры:: other - значение, которое должно быть возвращено, если значение отсутствует
Возвращает:: значение, если присутствует, в противном случае other

orElseGet

public long orElseGet(LongSupplier supplier)

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

Параметры:: supplier - функция-поставщик, которая генерирует возвращаемое значение
Возвращает:: значение, если присутствует, в противном случае результат, полученный от функции-поставщика
Выбрасывает:: NullPointerException - если значение отсутствует, и функция-поставщик является null

orElseThrow

public long orElseThrow()

Если значение присутствует, возвращает значение, в противном случае выбрасывает NoSuchElementException.

Возвращает:: значение, описанное этим OptionalLong
Выбрасывает:: NoSuchElementException - если значение отсутствует
С:: 10

orElseThrow

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

Если значение присутствует, возвращает значение, в противном случае выбрасывает исключение, сгенерированное функцией-поставщиком исключений.

Примечание API:: В качестве поставщика можно использовать ссылку на метод конструктора исключения со списком пустых аргументов. Например, IllegalStateException::new
Параметры типа:: X - Тип исключения, которое будет выброшено
Параметры:: exceptionSupplier - функция-поставщик, которая генерирует исключение
Возвращает:: значение, если присутствует
Выбрасывает:: X - если значение отсутствует; NullPointerException - если значение отсутствует и функция-поставщик исключений является null

equals

public boolean equals(Object obj)

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

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

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

equals в классе Object

Параметры:

obj - объект, подлежащий проверке на равенство

Возвращает:

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

См. также:

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

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

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Требования к реализации:: Если значение присутствует, результат должен включать его строковое представление в результат. Пустые и присутствующие OptionalLong должны быть однозначно различимы.
Возвращает:: строковое представление этого экземпляра

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/OptionalLong.html