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) 返回一个用指定的 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 对象。

注：一般情况下都不宜使用该构造方法。若不需要新 的实例，则静态工厂 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 值。

参数：

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)

返回一个用指定的 String 表示值的 Boolean 值。如果 String 参数不为 null 且在忽略大小写时等于 "true"，则返回的 Boolean 表示 true 值。

例子：Boolean.valueOf("True") 返回 true。
例子：Boolean.valueOf("yes") 返回 false。

参数：

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