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 的逻辑异或