JavaTM 2 Platform
Standard Ed. 5.0

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 的字段。

此外,此类还为 booleanString 的相互转换提供了许多方法,并提供了处理 boolean 时非常有用的其他一些常量和方法。

从以下版本开始:
JDK1.0
另请参见:
序列化表格

字段摘要
static Boolean FALSE
          对应基值 falseBoolean 对象。
static Boolean TRUE
          对应基值 trueBoolean 对象。
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
对应基值 trueBoolean 对象。


FALSE

public static final Boolean FALSE
对应基值 falseBoolean 对象。


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") 生成一个表示 trueBoolean 对象。
new Boolean("yes") 生成一个表示 falseBoolean 对象。

参数:
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 - 布尔值。
返回:
一个表示 bBoolean 实例。
从以下版本开始:
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。(从 JavaTM 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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策