java.lang.Object

java.util.OptionalLong

public final class OptionalLong extends Object

long値を含む場合と含まない場合があるコンテナオブジェクト。値が存在する場合、isPresent()はtrueを返します。値が存在しない場合、オブジェクトはemptyとみなされ、isPresent()はfalseを返します。

orElse() (値がない場合はデフォルト値を返します)やifPresent() (値が存在する場合にアクションを実行)など、含まれている値の有無に依存する追加のメソッドが提供されます。

これはvalue-basedクラスです。プログラマは、equalのインスタンスを交換可能として扱い、同期にインスタンスを使用しないようにする必要があります。そうしないと、予期しない動作が発生する可能性があります。たとえば、将来のリリースでは、同期が失敗する可能性があります。

APIのノート:: OptionalLongは、主に"結果がありません。"を明示的に必要とするメソッドの戻り型として使用することを意図しています型がOptionalLongの変数は、それ自体がnullになることはなく、常にOptionalLongインスタンスを指す必要があります。
導入されたバージョン:: 1.8

メソッドのサマリー

修飾子と型

メソッド

説明

static OptionalLong

empty()

空のOptionalLongインスタンスを返します。

boolean

equals(Object obj)

他のオブジェクトがこのOptionalLongに"に等しい"かどうかを示します。

long

getAsLong()

値が存在する場合は値を返し、存在しない場合はNoSuchElementExceptionをスローします。

int

hashCode()

値のハッシュ・コード(存在する場合)を返します。値がない場合は0 (zero)を返します。

void

ifPresent(LongConsumer action)

値が存在する場合は、指定されたアクションを値とともに実行し、それ以外の場合は何も実行しません。

void

ifPresentOrElse(LongConsumer action, Runnable emptyAction)

値が存在する場合は、指定されたアクションを値とともに実行し、それ以外の場合は、指定された空ベースのアクションを実行します。

boolean

isEmpty()

値が存在しない場合はtrue、それ以外の場合falseを返します。

boolean

isPresent()

値が存在する場合、true、それ以外の場合はfalseを返します。

static OptionalLong

of(long value)

指定された値を記述するOptionalLongを返します。

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のノート:
  
  このメソッドを使用すると、オプションのlongのStreamを現在のlongのLongStreamに変換できます:
  Stream<OptionalLong> os = .. LongStream s = os.flatMapToLong(OptionalLong::stream)
  
  戻り値:
  
  LongStreamとしてのオプションの値
  
  導入されたバージョン:
  
  9
- 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
  
  関連項目:
  
  Object.hashCode()
  
  HashMap
- hashCode
  public int hashCode()
  
  値のハッシュ・コード(存在する場合)を返します。値がない場合は0 (zero)を返します。
  
  オーバーライド:
  
  hashCode、クラスObject
  
  戻り値:
  
  現在値のハッシュ・コード値または値が存在しない場合の0
  
  関連項目:
  
  Object.equals(java.lang.Object)
  
  System.identityHashCode(java.lang.Object)
- toString
  
  public String toString()
  
  デバッグに適したこのOptionalLongの空でない文字列表現を返します。正確な表示フォーマットは未指定であり、実装とバージョンの間で異なることがあります。
  
  オーバーライド:
  
  toString、クラスObject
  
  実装要件:
  
  値が存在する場合は、結果にその文字列表現が含まれる必要があります。空および現在のOptionalLongは、明確に区別できる必要があります。
  
  戻り値:
  
  このインスタンスの文字列表現

クラスOptionalLong

メソッドのサマリー

クラスjava.lang.Objectで宣言されたメソッド

メソッドの詳細

empty

of

getAsLong

isPresent

isEmpty

ifPresent

ifPresentOrElse

stream

orElse

orElseGet

orElseThrow

orElseThrow

equals

hashCode

toString