java.lang.Object

java.util.OptionalDouble

public final class OptionalDouble extends Object

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

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

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

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

メソッドのサマリー

修飾子と型

メソッド

説明

static OptionalDouble

empty()

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

boolean

equals(Object obj)

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

double

getAsDouble()

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

int

hashCode()

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

void

ifPresent(DoubleConsumer action)

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

void

ifPresentOrElse(DoubleConsumer action, Runnable emptyAction)

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

boolean

isEmpty()

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

boolean

isPresent()

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

static OptionalDouble

of(double value)

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

double

orElse(double other)

値が存在する場合は値を返し、存在しない場合はotherを返します。

double

orElseGet(DoubleSupplier supplier)

値が存在する場合は値を返し、それ以外の場合は供給関数によって生成された結果を返します。

double

orElseThrow()

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

<X extends Throwable> double

orElseThrow(Supplier<? extends X> exceptionSupplier)

値が存在する場合は値を返し、それ以外の場合は例外指定関数によって生成された例外をスローします。

DoubleStream

stream()

値が存在する場合は、その値のみを含む順次DoubleStreamを戻し、それ以外の場合は空のDoubleStreamを戻します。

String

toString()

デバッグに適したこのOptionalDoubleの空でない文字列表現を返します。

クラスjava.lang.Objectで宣言されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

メソッドの詳細
- empty
  
  public static OptionalDouble empty()
  
  空のOptionalDoubleインスタンスを返します。このOptionalDoubleには値はありません。
  
  APIのノート:
  
  これは一時的なものですが、OptionalDouble.empty()によって返されたインスタンスと==または!=を比較して、オブジェクトが空であるかどうかをテストしないでください。シングルトンである保証はありません。かわりに、isEmpty()またはisPresent()を使用してください。
  
  戻り値:
  
  空のOptionalDouble。
- of
  
  public static OptionalDouble of(double value)
  
  指定された値を記述するOptionalDoubleを返します。
  
  パラメータ:
  
  value - 説明する値
  
  戻り値:
  
  値が存在するOptionalDouble
- getAsDouble
  
  public double getAsDouble()
  
  値が存在する場合は値を返し、存在しない場合はNoSuchElementExceptionをスローします。
  
  APIのノート:
  
  このメソッドの代替として優先される方法は、orElseThrow()です。
  
  戻り値:
  
  このOptionalDoubleで記述された値
  
  例外:
  
  NoSuchElementException - 値が存在しない場合
- isPresent
  
  public boolean isPresent()
  
  値が存在する場合、true、それ以外の場合はfalseを返します。
  
  戻り値:
  
  値が存在する場合はtrue、存在しない場合はfalse
- isEmpty
  
  public boolean isEmpty()
  
  値が存在しない場合はtrue、それ以外の場合falseを返します。
  
  戻り値:
  
  値が存在しない場合はtrue、それ以外の場合はfalse
  
  導入されたバージョン:
  
  11
- ifPresent
  
  public void ifPresent(DoubleConsumer action)
  
  値が存在する場合は、指定されたアクションを値とともに実行し、それ以外の場合は何も実行しません。
  
  パラメータ:
  
  action - 値が存在する場合、実行するアクション
  
  例外:
  
  NullPointerException - 値が存在し、与えられたアクションがnullの場合
- ifPresentOrElse
  
  public void ifPresentOrElse(DoubleConsumer action, Runnable emptyAction)
  
  値が存在する場合は、指定されたアクションを値とともに実行し、それ以外の場合は、指定された空ベースのアクションを実行します。
  
  パラメータ:
  
  action - 値が存在する場合、実行するアクション
  
  emptyAction - 値が存在しない場合、実行される空ベースのアクション
  
  例外:
  
  NullPointerException - 値が存在し、指定されたアクションがnullの場合、または値が存在しない場合、指定された空のアクションはnullです。
  
  導入されたバージョン:
  
  9
- stream
  public DoubleStream stream()
  
  値が存在する場合は、その値のみを含む順次DoubleStreamを戻し、それ以外の場合は空のDoubleStreamを戻します。
  
  APIのノート:
  
  このメソッドは、オプションのdoubleのStreamを現在のdoubleのDoubleStreamに変換するために使用できます:
  Stream<OptionalDouble> os = .. DoubleStream s = os.flatMapToDouble(OptionalDouble::stream)
  
  戻り値:
  
  オプションの値はDoubleStreamです。
  
  導入されたバージョン:
  
  9
- orElse
  
  public double orElse(double other)
  
  値が存在する場合は値を返し、存在しない場合はotherを返します。
  
  パラメータ:
  
  other - 値が存在しない場合、返される値
  
  戻り値:
  
  値(存在する場合)、それ以外の場合はother
- orElseGet
  
  public double orElseGet(DoubleSupplier supplier)
  
  値が存在する場合は値を返し、それ以外の場合は供給関数によって生成された結果を返します。
  
  パラメータ:
  
  supplier - 戻される値を生成する供給関数
  
  戻り値:
  
  値が存在する場合は、それ以外の場合は、供給機能によって生成される結果
  
  例外:
  
  NullPointerException - 値が存在せず、供給関数がnullの場合
- orElseThrow
  
  public double orElseThrow()
  
  値が存在する場合は値を返し、存在しない場合はNoSuchElementExceptionをスローします。
  
  戻り値:
  
  このOptionalDoubleで記述された値
  
  例外:
  
  NoSuchElementException - 値が存在しない場合
  
  導入されたバージョン:
  
  10
- orElseThrow
  
  public <X extends Throwable> double orElseThrow(Supplier<? extends X> exceptionSupplier) throws X
  
  値が存在する場合は値を返し、それ以外の場合は例外指定関数によって生成された例外をスローします。
  
  APIのノート:
  
  引数リストが空である例外コンストラクタへのメソッド参照をサプライヤとして使用できます。たとえば、IllegalStateException::newなどです。
  
  型パラメータ:
  
  X - スローされる例外の型
  
  パラメータ:
  
  exceptionSupplier - スローされる例外を生成する供給関数
  
  戻り値:
  
  値がある場合
  
  例外:
  
  X - 値が存在しない場合
  
  NullPointerException - 値が存在せず、例外を提供する関数がnullの場合
- equals
  public boolean equals(Object obj)
  
  他のオブジェクトがこのOptionalDoubleに"に等しい"かどうかを示します。他方のオブジェクトは次の場合に同等と見なされます。
  
  それもOptionalDoubleである、および
  両方のインスタンスに存在する値がない、または
  存在する値がDouble.compare() == 0によってお互いに等しい。
  
  オーバーライド:
  
  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()
  
  デバッグに適したこのOptionalDoubleの空でない文字列表現を返します。正確な表示フォーマットは未指定であり、実装とバージョンの間で異なることがあります。
  
  オーバーライド:
  
  toString、クラスObject
  
  実装要件:
  
  値が存在する場合は、結果にその文字列表現が含まれる必要があります。空および現在のOptionalDoubleは、明確に区別できる必要があります。
  
  戻り値:
  
  このインスタンスの文字列表現

クラスOptionalDouble

メソッドのサマリー

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

メソッドの詳細

empty

of

getAsDouble

isPresent

isEmpty

ifPresent

ifPresentOrElse

stream

orElse

orElseGet

orElseThrow

orElseThrow

equals

hashCode

toString