モジュール java.base
パッケージ java.lang

クラスBoolean

java.lang.Object
java.lang.Boolean
すべての実装されたインタフェース:
Serializable, Comparable<Boolean>, Constable
public final class Boolean extends Object implements Serializable, Comparable<Boolean>, Constable
Booleanクラスは、プリミティブ型booleanの値をオブジェクトにラップします。 Boolean型のオブジェクトには、型がbooleanの単一フィールドが含まれます。

さらにこのクラスは、booleanをStringに、Stringをbooleanに変換する多数のメソッドや、booleanの処理時に役立つ定数およびメソッドも提供します。

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

導入されたバージョン:
1.0
関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final Boolean
    FALSE
    プリミティブ値falseに対応するBooleanオブジェクトです。
    static final Boolean
    TRUE
    プリミティブ値trueに対応するBooleanオブジェクトです。
    static final Class<Boolean>
    TYPE
    booleanのプリミティブ型を表すClassオブジェクトです。

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    Boolean(boolean value)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このコンストラクタを使用することはほとんどありません。
    Boolean(String s)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このコンストラクタを使用することはほとんどありません。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    booleanValue()
    このBooleanオブジェクトの値をプリミティブboolean型として返します。
    static int
    compare(boolean x, boolean y)
    2つのboolean値を比較します。
    int
    compareTo(Boolean b)
    このBooleanインスタンスを別のインスタンスと比較します。
    Optional<DynamicConstantDesc<Boolean>>
    describeConstable()
    このインスタンスの名目記述子を含むOptionalを返します。
    boolean
    equals(Object obj)
    引数がnullではなく、このオブジェクトと同じboolean値を表すBooleanオブジェクトの場合にだけ、trueを返します。
    static boolean
    getBoolean(String name)
    引数で指定されたシステム・プロパティが存在し、大/小文字の区別なしで文字列"true"と等しい場合にのみ、trueを返します。
    int
    hashCode()
    このBooleanオブジェクトのハッシュ・コードを返します。
    static int
    hashCode(boolean value)
    Boolean.hashCode()との互換性がある、boolean値のハッシュ・コードを返します。
    static boolean
    logicalAnd(boolean a, boolean b)
    指定されたbooleanオペランドに論理積演算子を適用した結果を返します。
    static boolean
    logicalOr(boolean a, boolean b)
    指定されたbooleanオペランドに論理和演算子を適用した結果を返します。
    static boolean
    logicalXor(boolean a, boolean b)
    指定されたbooleanオペランドに排他的論理和演算子を適用した結果を返します。
    static boolean
    parseBoolean(String s)
    文字列引数をboolean型として解析します。
    String
    toString()
    このBooleanの値を表すStringオブジェクトを返します。
    static String
    toString(boolean b)
    指定されたbooleanを表すStringオブジェクトを返します。
    static Boolean
    valueOf(boolean b)
    指定されたboolean値を表すBooleanインスタンスを返します。
    static Boolean
    valueOf(String s)
    指定された文字列によって表される値を持つBooleanを返します。

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

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

  • フィールド詳細

    • TRUE

      public static final Boolean TRUE
      プリミティブ値trueに対応するBooleanオブジェクトです。

    • FALSE

      public static final Boolean FALSE
      プリミティブ値falseに対応するBooleanオブジェクトです。

    • TYPE

      public static final Class<Boolean> TYPE
      booleanのプリミティブ型を表すClassオブジェクトです。
      導入されたバージョン:
      1.1

  • コンストラクタの詳細

    • Boolean

      @Deprecated(since="9", forRemoval=true) public Boolean(boolean value)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このコンストラクタを使用することはほとんどありません。 静的ファクトリvalueOf(boolean)は、より良いスペースと時間のパフォーマンスをもたらす可能性が高いため、通常はより良い選択です。 また、可能であれば最終フィールドTRUEとFALSEの使用も検討してください。
      value引数を表すBooleanオブジェクトを割り当てます。
      パラメータ:
      value - Booleanの値。

    • Boolean

      @Deprecated(since="9", forRemoval=true) public Boolean(String s)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このコンストラクタを使用することはほとんどありません。 文字列をbooleanプリミティブに変換するにはparseBoolean(String)を使用し、文字列をBooleanオブジェクトに変換するにはvalueOf(String)を使用します。
      文字列引数がnullではなく、文字列"true"に等しい(大文字と小文字は区別しない)場合は、値trueを表すBooleanオブジェクトを割り当てます。 それ以外の場合は、値falseを表すBooleanオブジェクトを割り当てます。
      パラメータ:
      s - Booleanに変換する文字列。

  • メソッドの詳細

    • parseBoolean

      public static boolean parseBoolean(String s)
      文字列引数をboolean型として解析します。 文字列引数がnullではなく、文字列"true"に等しい(大文字と小文字は区別しない)場合、返されるbooleanは値trueを表します。 それ以外の場合は、null引数を含むfalse値が返されます。

      例: Boolean.parseBoolean("True")はtrueを返す。
      例: Boolean.parseBoolean("yes")はfalseを返す。

      パラメータ:
      s - 解析対象のboolean表現を含むString
      戻り値:
      文字列引数で表されるboolean型
      導入されたバージョン:
      1.5

    • booleanValue

      public boolean booleanValue()
      このBooleanオブジェクトの値をプリミティブboolean型として返します。
      戻り値:
      このオブジェクトのプリミティブboolean値。

    • valueOf

      public static Boolean valueOf(boolean b)
      指定されたboolean値を表すBooleanインスタンスを返します。 指定されたboolean値がtrueの場合、このメソッドはBoolean.TRUEを返し、falseの場合、このメソッドはBoolean.FALSEを返します。 新規Booleanインスタンスが不要な場合、通常このメソッドがコンストラクタBoolean(boolean)に優先して使用されます。その理由は、このメソッドが操作に必要な領域や時間がはるかに少なくて済む場合が多いためです。
      パラメータ:
      b - boolean型の値。
      戻り値:
      bを表すBooleanインスタンス
      導入されたバージョン:
      1.4

    • valueOf

      public static Boolean valueOf(String s)
      指定された文字列によって表される値を持つBooleanを返します。 文字列引数がnullではなく、文字列"true"に等しい(大文字と小文字は区別しない)場合、返されるBooleanはtrue値を表します。 それ以外の場合は、null引数を含むfalse値が返されます。
      パラメータ:
      s - 文字列
      戻り値:
      文字列が表すBoolean値。

    • toString

      public static String toString(boolean b)
      指定されたbooleanを表すStringオブジェクトを返します。 指定されたbooleanがtrueの場合は文字列"true"が返され、それ以外の場合は文字列"false"が返されます。
      パラメータ:
      b - 変換されるboolean
      戻り値:
      指定されたbooleanの文字列表現
      導入されたバージョン:
      1.4

    • toString

      public String toString()
      このBooleanの値を表すStringオブジェクトを返します。 このオブジェクトが値trueを表している場合、"true"に等しい文字列が返されます。 それ以外の場合、"false"に等しい文字列が返されます。
      オーバーライド:
      toString、クラスObject
      戻り値:
      このオブジェクトの文字列表現。

    • hashCode

      public int hashCode()
      このBooleanオブジェクトのハッシュ・コードを返します。
      オーバーライド:
      hashCode、クラスObject
      戻り値:
      このオブジェクトがtrueを表す場合は整数1231、falseを表す場合は整数1237。
      関連項目:

    • hashCode

      public static int hashCode(boolean value)
      Boolean.hashCode()との互換性がある、boolean値のハッシュ・コードを返します。
      パラメータ:
      value - ハッシュ対象の値
      戻り値:
      boolean値のハッシュ・コード値。
      導入されたバージョン:
      1.8

    • equals

      public boolean equals(Object obj)
      引数がnullではなく、このオブジェクトと同じboolean値を表すBooleanオブジェクトの場合にだけ、trueを返します。
      オーバーライド:
      equals、クラスObject
      パラメータ:
      obj - 比較対象のオブジェクト。
      戻り値:
      Booleanオブジェクトが同じ値を表す場合はtrue、そうでない場合はfalse。
      関連項目:

    • getBoolean

      public static boolean getBoolean(String name)
      引数で指定されたシステム・プロパティが存在し、大/小文字の区別なしで文字列"true"と等しい場合にのみ、trueを返します。 システム・プロパティには、Systemクラスによって定義されるgetPropertyメソッドを使ってアクセスできます。

      指定された名前を持つプロパティがない場合、あるいは指定された名前が空またはnullの場合は、falseが返されます。

      パラメータ:
      name - システム・プロパティ名。
      戻り値:
      システム・プロパティのboolean値。
      スロー:
      SecurityException - System.getPropertyと同じ理由のため
      関連項目:

    • compareTo

      public int compareTo(Boolean b)
      このBooleanインスタンスを別のインスタンスと比較します。
      定義:
      compareTo、インタフェースComparable<Boolean>
      パラメータ:
      b - 比較対象のBooleanインスタンス
      戻り値:
      このオブジェクトが引数と同じboolean値を表す場合はゼロ。このオブジェクトがtrueを表し、引数がfalseを表す場合は正の値。このオブジェクトがfalseを表し、引数がtrueを表す場合は負の値
      スロー:
      NullPointerException - 引数がnullの場合
      導入されたバージョン:
      1.5
      関連項目:

    • compare

      public static int compare(boolean x, boolean y)
      2つのboolean値を比較します。 返される値は、次から返される値と同じになります。 
          Boolean.valueOf(x).compareTo(Boolean.valueOf(y))
      パラメータ:
      x - 比較する最初のboolean
      y - 比較する2番目のboolean
      戻り値:
      x == yの場合は値0、!x && yの場合は0より小さい値、x && !yの場合は0より大きい値
      導入されたバージョン:
      1.7

    • logicalAnd

      public static boolean logicalAnd(boolean a, boolean b)
      指定されたbooleanオペランドに論理積演算子を適用した結果を返します。
      パラメータ:
      a - 第1オペランド
      b - 第2オペランド
      戻り値:
      aとbの論理積
      導入されたバージョン:
      1.8
      関連項目:

    • logicalOr

      public static boolean logicalOr(boolean a, boolean b)
      指定されたbooleanオペランドに論理和演算子を適用した結果を返します。
      パラメータ:
      a - 第1オペランド
      b - 第2オペランド
      戻り値:
      aとbの論理和
      導入されたバージョン:
      1.8
      関連項目:

    • logicalXor

      public static boolean logicalXor(boolean a, boolean b)
      指定されたbooleanオペランドに排他的論理和演算子を適用した結果を返します。
      パラメータ:
      a - 第1オペランド
      b - 第2オペランド
      戻り値:
      aとbの排他的論理和
      導入されたバージョン:
      1.8
      関連項目:

    • describeConstable

      public Optional<DynamicConstantDesc<Boolean>> describeConstable()
      このインスタンスの名目記述子を含むOptionalを返します。
      定義:
      インタフェースConstable内のdescribeConstable
      戻り値:
      Booleanインスタンスを説明するOptional
      導入されたバージョン:
      15