java.lang
クラス Boolean

java.lang.Object
  java.lang.Boolean

すべての実装されたインタフェース:

Serializable, Comparable<Boolean>

public final class Boolean
extends Object
implements Serializable, Comparable<Boolean>

Boolean クラスは、プリミティブ型 boolean の値をオブジェクトにラップします。Boolean 型のオブジェクトには、型が boolean の単一フィールドが入ります。

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

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

フィールドの概要

static Boolean	FALSE プリミティブ値 false に対応する Boolean オブジェクトです。
static Boolean	TRUE プリミティブ値 true に対応する Boolean オブジェクトです。
static Class<Boolean>	TYPE boolean のプリミティブ型を表す Class オブジェクトです。

コンストラクタの概要

Boolean(boolean value)
value 引数を表す Boolean オブジェクトを割り当てます。

Boolean(String s)
文字列引数が null ではなく、文字列「true」に等しい (大文字と小文字は区別しない) 場合は、値 true を表す Boolean オブジェクトを割り当てます。

メソッドの概要

boolean	booleanValue() この Boolean オブジェクトの値をプリミティブ boolean 型として返します。
int	compareTo(Boolean b) この Boolean インスタンスを別の Boolean インスタンスと比較します。
boolean	equals(Object obj) 引数が null ではなく、このオブジェクトと同じ boolean 値を表す Boolean オブジェクトの場合にだけ、true を返します。
static boolean	getBoolean(String name) 引数によって指定されたシステムプロパティが存在し、それが文字列「true」に等しい場合にだけ、true を返します。
int	hashCode() この 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) 指定された String が表す値を持つ 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 オブジェクトです。

導入されたバージョン:

JDK1.1

コンストラクタの詳細

Boolean

public Boolean(boolean value)

value 引数を表す Boolean オブジェクトを割り当てます。

注: このコンストラクタを使用する機会はまれにしかありません。new インスタンスが必須でないかぎり、通常は static ファクトリ valueOf(boolean) を選択した方が、操作に必要な領域や時間がはるかに少なくて済みます。

パラメータ:

value - Boolean の値

Boolean

public Boolean(String s)

文字列引数が null ではなく、文字列「true」に等しい (大文字と小文字は区別しない) 場合は、値 true を表す Boolean オブジェクトを割り当てます。そうでない場合は、値 false を表す Boolean オブジェクトを割り当てます。次に例を示します。

new Boolean("True") は true を表す Boolean オブジェクトを生成します。
new Boolean("yes") は false を表す Boolean オブジェクトを生成します。

パラメータ:

s - Boolean に変換する文字列

メソッドの詳細

parseBoolean

public static boolean parseBoolean(String s)

文字列引数を boolean 型として解析します。文字列引数が null ではなく、文字列「true」に等しい (大文字と小文字は区別しない) 場合、この返された Boolean は値 true を表します。

パラメータ:

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)

指定された String が表す値を持つ Boolean を返します。文字列引数が null ではなく、文字列「true」に等しい (大文字と小文字は区別しない) 場合、この返された Boolean は値 true を表します。

例: Boolean.valueOf("True") は true を返す
例: Boolean.valueOf("yes") は 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」に等しい文字列が返されます。

オーバーライド:

クラス Object 内の toString

戻り値:

このオブジェクトの文字列表現

hashCode

public int hashCode()

この Boolean オブジェクトのハッシュコードを返します。

オーバーライド:

クラス Object 内の hashCode

戻り値:

このオブジェクトが true を表す場合は整数 1231、false を表す場合は整数 1237

関連項目:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

引数が null ではなく、このオブジェクトと同じ boolean 値を表す Boolean オブジェクトの場合にだけ、true を返します。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 比較対象のオブジェクト

戻り値:

Boolean オブジェクトが同じ値を表す場合は true、そうでない場合は false

関連項目:

Object.hashCode(), Hashtable

getBoolean

public static boolean getBoolean(String name)

引数によって指定されたシステムプロパティが存在し、それが文字列「true」に等しい場合にだけ、true を返します。Java^TM プラットフォームのバージョン 1.0.2 以降、この判定では、文字列「true」は大文字と小文字が区別されません。システムプロパティには、System クラスによって定義される getProperty メソッドを使ってアクセスできます。

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

パラメータ:

name - システムプロパティ名

戻り値:

システムプロパティの boolean 値

関連項目:

System.getProperty(java.lang.String), System.getProperty(java.lang.String, java.lang.String)

compareTo

public int compareTo(Boolean b)

この Boolean インスタンスを別の Boolean インスタンスと比較します。

定義:

インタフェース Comparable<Boolean> 内の compareTo

パラメータ:

b - 比較対象の Boolean インスタンス

戻り値:

このオブジェクトが引数と同じ boolean 値を表す場合はゼロ。このオブジェクトが true を表し、引数が false を表す場合は正の値。このオブジェクトが false を表し、引数が true を表す場合は負の値

例外:

NullPointerException - 引数が null の場合

導入されたバージョン:

1.5

関連項目:

Comparable