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 的相互轉換提供了許多方法，並提供了處理 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)
如果 String 參數不為 null 且在忽略大小寫時等於 "true"，則分派一個表示 true 值的 Boolean 物件。

方法摘要

boolean	booleanValue() 將此 Boolean 物件的值作為基本布林值返回。
int	compareTo(Boolean b) 將此 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() 返回表示該布林值的 String 物件。
static String	toString(boolean b) 返回一個表示指定布林值的 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 物件。

從以下版本開始：

JDK1.1

建構子詳細資訊

Boolean

public Boolean(boolean value)

分派一個表示 value 參數的 Boolean 物件。

註：一般情況下都不宜使用該建構子。若不需要新 的實例，則靜態處理器 valueOf(boolean) 通常是一個更好的選擇。這有可能顯著提高空間和時間性能。

參數：

value - Boolean 的值。

Boolean

public Boolean(String s)

如果 String 參數不為 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 值。如果 String 參數不是 null 且在忽略大小寫時等於 "true"，則返回的 boolean 表示 true 值。

範例：Boolean.parseBoolean("True") 返回 true。
範例：Boolean.parseBoolean("yes") 返回 false。

參數：

s - 套件含要解析的布林表達式的 String

返回：

String 參數所表示的布林值

從以下版本開始：

1.5

booleanValue

public boolean booleanValue()

將此 Boolean 物件的值作為基本布林值返回。

返回：

此物件的基本 boolean 值。

valueOf

public static Boolean valueOf(boolean b)

返回一個表示指定 boolean 值的 Boolean 實例。如果指定的 boolean 值為 true，則此方法返回 Boolean.TRUE；如果為 false，則返回 Boolean.FALSE。如果不需要新的 Boolean 實例，則應優先使用此方法，而不是建構子 Boolean(boolean)，因為此方法有可能大大提高空間和時間性能。

參數：

b - 布林值。

返回：

一個表示 b 的 Boolean 實例。

從以下版本開始：

1.4

valueOf

public static Boolean valueOf(String s)

返回一個用指定的字元串表示值的 Boolean 值。如果字元串參數不為 null 且在忽略大小寫時等於 "true"，則返回的 Boolean 表示 true 值。

參數：

s - 字元串。

返回：

該字元串所表示的 Boolean 值。

toString

public static String toString(boolean b)

返回一個表示指定布林值的 String 物件。如果指定布林值為 true，則將返回字元串 "true"，否則將返回字元串 "false"。

參數：

b - 要轉換的布林值

返回：

指定 boolean 值的字元串表達式

從以下版本開始：

1.4

toString

public String toString()

返回表示該布林值的 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 - 比較的物件。

返回：

如果這些布林物件表示相同的值，則返回 true；否則返回 false。

另請參見：

Object.hashCode(), Hashtable

getBoolean

public static boolean getBoolean(String name)

當且僅當以參數命名的系統屬性存在，且等於 "true" 字元串時，才返回 true。（從 Java^TM 平臺的 1.0.2 版本開始，字元串的測試不再區分大小寫。）通過 getProperty 方法可存取系統屬性，此方法由 System 類別定義。

如果沒有以指定名稱命名的屬性或者指定名稱為空或 null，則返回 false。

參數：

name - 系統屬性名。

返回：

系統屬性的 boolean 值。

另請參見：

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

compareTo

public int compareTo(Boolean b)

將此 Boolean 實例與其他實例進行比較。

指定者：

介面 Comparable<Boolean> 中的 compareTo

參數：

b - 要進行比較的 Boolean 實例

返回：

如果對象與參數表示的布林值相同，則返回零；如果此物件表示 true，參數表示 false，則返回一個正值；如果此物件表示 false，參數表示 true，則返回一個負值

拋出：

NullPointerException - 如果參數為 null

從以下版本開始：

1.5

另請參見：

Comparable