Boolean

java.lang.Object

|---java.lang.Boolean

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

Boolean 类将原始类型 boolean 的值包装在一个对象中。 Boolean 类型的对象包含一个类型为 boolean 的字段。

此外，该类提供了许多用于将布尔值转换为字符串和将字符串转换为布尔值的方法，以及在处理布尔值时有用的其他常量和方法。

字段摘要

修饰符和类型	字段	描述
static Boolean	FALSE	对应于原始值 false 的布尔对象。
static Boolean	TRUE	对应于原始值 true 的布尔对象。
static ClassBoolean	TYPE	表示基本类型 boolean 的 Class 对象。

构造函数摘要

构造函数	描述
Boolean(boolean value)	分配一个表示值参数的布尔对象。
Boolean(String s)	如果字符串参数不为 null 且等于（忽略大小写）字符串“true”，则分配表示值 true 的布尔对象。

方法总结

修饰符和类型	方法	描述
boolean	booleanValue()	将此布尔对象的值作为布尔原语返回。
static int	compare(boolean x, boolean y)	比较两个布尔值。
int	compareTo(Boolean b)	将此布尔实例与另一个进行比较。
boolean	equals(Object obj)	当且仅当参数不为 null 并且是表示与此对象相同的布尔值的布尔对象时才返回 true。
static boolean	getBoolean(String name)	当且仅当由参数命名的系统属性存在并且等于字符串“true”时才返回 true。
int	hashCode()	返回此布尔对象的哈希码。
static int	hashCode(boolean value)	返回布尔值的哈希码； 与 Boolean.hashCode() 兼容。
static boolean	logicalAnd(boolean a, boolean b)	返回将逻辑 AND 运算符应用于指定的布尔操作数的结果。
static boolean	logicalOr(boolean a, boolean b)	返回将逻辑 OR 运算符应用于指定的布尔操作数的结果。
static boolean	logicalXor(boolean a, boolean b)	返回将逻辑 XOR 运算符应用于指定布尔操作数的结果。
static boolean	parseBoolean(String s)	将字符串参数解析为布尔值。
String	toString()	返回表示此布尔值的 String 对象。
static String	toString(boolean b)	返回表示指定布尔值的 String 对象。
static Boolean	valueOf(boolean b)	返回一个表示指定布尔值的布尔实例。
static Boolean	valueOf(String s)	返回一个布尔值，其值由指定字符串表示。

从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

FALSE

public static final Boolean FALSE

对应于原始值 false 的布尔对象。

TRUE

public static final Boolean TRUE

对应于原始值 true 的布尔对象。

TYPE

public static final ClassBoolean TYPE

表示基本类型 boolean 的 Class 对象。

构造函数详细信息

Boolean

public Boolean(boolean value)

分配一个表示值参数的布尔对象。

注意：很少使用这个构造函数。 除非需要新实例，否则静态工厂 valueOf(boolean) 通常是更好的选择。 它可能会产生明显更好的空间和时间性能。

参数：

参数名称	参数描述
value	布尔值。

Boolean

public Boolean(String s)

如果字符串参数不为 null 并且忽略大小写等于字符串“true”，则分配表示值 true 的布尔对象。 否则，分配一个表示值 false 的布尔对象。 例子：

new Boolean("True") 产生一个表示真的布尔对象。 new Boolean("yes") 产生一个表示假的布尔对象。

参数：

参数名称	参数描述
s	要转换为布尔值的字符串。

方法详情

parseBoolean

public static boolean parseBoolean(String s)

将字符串参数解析为布尔值。 返回的布尔值表示如果字符串参数不为空且等于字符串“true”，则忽略大小写，则返回值 true。

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

参数：

参数名称	参数描述
s	包含要解析的布尔表示的字符串

返回:

由字符串参数表示的布尔值

booleanValue

public boolean booleanValue()

将此布尔对象的值作为布尔原语返回。

返回:

此对象的原始布尔值。

valueOf

public static Boolean valueOf(boolean b)

返回一个表示指定布尔值的布尔实例。 如果指定的布尔值为真，则此方法返回 Boolean.TRUE； 如果为 false，则此方法返回 Boolean.FALSE。 如果不需要新的 Boolean 实例，则通常应优先使用此方法而不是构造函数 Boolean(boolean)，因为此方法可能会产生明显更好的空间和时间性能。

参数：

参数名称	参数描述
b	一个布尔值。

返回:

表示 b 的布尔实例。

valueOf

public static Boolean valueOf(String s)

返回一个布尔值，其值由指定字符串表示。 如果字符串参数不为 null 并且忽略大小写，则返回的布尔值与字符串“true”相等，则表示一个真值。

参数：

参数名称	参数描述
s	一个字符串。

返回:

字符串表示的布尔值。

toString

public static String toString(boolean b)

返回表示指定布尔值的 String 对象。 如果指定的布尔值为真，则返回字符串“true”，否则返回字符串“false”。

参数：

参数名称	参数描述
b	要转换的布尔值

返回:

指定布尔值的字符串表示

toString

public String toString()

返回表示此布尔值的 String 对象。 如果此对象表示值 true，则返回等于“true”的字符串。 否则，返回等于“false”的字符串。

覆盖：

类 Object 中的 toString

返回:

此对象的字符串表示形式。

hashCode

public int hashCode()

返回此布尔对象的哈希码。

覆盖：

类 Object 中的 hashCode

返回:

如果此对象表示 true，则为整数 1231； 如果此对象表示 false，则返回整数 1237。

hashCode

public static int hashCode(boolean value)

返回布尔值的哈希码； 与 Boolean.hashCode() 兼容。

参数：

参数名称	参数描述
value	要散列的值

返回:

布尔值的哈希码值。

equals

public boolean equals(Object obj)

当且仅当参数不为 null 并且是表示与此对象相同的布尔值的布尔对象时，才返回 true。

覆盖：

类 Object 中的等于

参数：

参数名称	参数描述
obj	比较的对象。

返回:

如果布尔对象表示相同的值，则为 true； 否则为假。

getBoolean

public static boolean getBoolean(String name)

当且仅当由参数命名的系统属性存在并且等于字符串“true”时才返回 true。 （从 JavaTM 平台的 1.0.2 版开始，此字符串的测试不区分大小写。）系统属性可通过 getProperty 访问，getProperty 是由 System 类定义的方法。

如果没有具有指定名称的属性，或者指定名称为空或 null，则返回 false。

参数：

参数名称	参数描述
name	系统属性名称。

返回:

系统属性的布尔值。

Throws:

Throw名称	Throw描述
SecurityException	出于与 System#getProperty(String) 相同的原因

compareTo

public int compareTo(Boolean b)

将此布尔实例与另一个进行比较。

指定者：

接口 ComparableBoolean 中的 compareTo

参数：

参数名称	参数描述
b	要比较的布尔实例

返回:

如果此对象表示与参数相同的布尔值，则为零； 如果此对象表示真且参数表示假，则为正值； 如果此对象表示 false 并且参数表示 true，则为负值

Throws:

Throw名称	Throw描述
NullPointerException	如果参数为空

compare

public static int compare(boolean x, boolean y)

比较两个布尔值。 返回的值与通过以下方式返回的值相同：

    Boolean.valueOf(x).compareTo(Boolean.valueOf(y)) 

参数:

参数名称	参数描述
x	第一个要比较的布尔值
y	要比较的第二个布尔值

返回:

如果 x == y，则值为 0； 如果 !x && y; 则小于 0 的值 如果 x && !y 则值大于 0

logicalAnd

public static boolean logicalAnd(boolean a, boolean b)

返回将逻辑 AND 运算符应用于指定的布尔操作数的结果。

参数：

参数名称	参数描述
a	第一个操作数
b	第二个操作数

返回:

a 和 b 的逻辑与

logicalOr

public static boolean logicalOr(boolean a, boolean b)

返回将逻辑 OR 运算符应用于指定的布尔操作数的结果。

参数：

参数名称	参数描述
a	第一个操作数
b	第二个操作数

返回:

a 和 b 的逻辑或

logicalXor

public static boolean logicalXor(boolean a, boolean b)

返回将逻辑 XOR 运算符应用于指定布尔操作数的结果。

参数：

参数名称	参数描述
a	第一个操作数
b	第二个操作数

返回:

a 和 b 的逻辑异或