Module java.base
Package java.lang

Class Boolean

java.lang.Object
java.lang.Boolean
所有已实现的接口:
Serializable, Comparable<Boolean>, Constable

public final class Boolean extends Object implements Serializable, Comparable<Boolean>, Constable
Boolean类将原始类型boolean的值包装在对象中。类型为Boolean的对象包含一个类型为boolean的字段。

此外,该类提供了许多方法,用于将boolean转换为String,将String转换为boolean,以及在处理boolean时有用的其他常量和方法。

这是一个基于值的类;程序员应该将相等的实例视为可互换的,并且不应将实例用于同步,否则可能会发生不可预测的行为。例如,在将来的版本中,同步可能会失败。

自:
1.0
参见:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final Boolean
    对应于原始值false的Boolean对象。
    static final Boolean
    对应于原始值true的Boolean对象。
    static final Class<Boolean>
    表示原始类型boolean的Class对象。
  • Constructor Summary

    Constructors
    Constructor
    Description
    Boolean(boolean value)
    已弃用,将来会移除: 该API元素可能会在将来的版本中被移除。
    很少适合使用此构造函数。
    已弃用,将来会移除: 该API元素可能会在将来的版本中被移除。
    很少适合使用此构造函数。
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    将此Boolean对象的值作为boolean原始类型返回。
    static int
    compare(boolean x, boolean y)
    比较两个boolean值。
    int
    将此Boolean实例与另一个实例进行比较。
    返回一个包含此实例的名义描述符的Optional。
    boolean
    equals(Object obj)
    当且仅当参数不为null且为表示与此对象相同boolean值的Boolean对象时,返回true。
    static boolean
    当且仅当由参数指定的系统属性存在且等于字符串"true"(忽略大小写)时,返回true。
    int
    返回此Boolean对象的哈希码。
    static int
    hashCode(boolean value)
    返回boolean值的哈希码;与Boolean.hashCode()兼容。
    static boolean
    logicalAnd(boolean a, boolean b)
    返回将指定的boolean操作数应用逻辑AND运算符的结果。
    static boolean
    logicalOr(boolean a, boolean b)
    返回将指定的boolean操作数应用逻辑OR运算符的结果。
    static boolean
    logicalXor(boolean a, boolean b)
    返回将指定的boolean操作数应用逻辑XOR运算符的结果。
    static boolean
    将字符串参数解析为boolean。
    返回表示此Boolean值的String对象。
    static String
    toString(boolean b)
    返回表示指定boolean的String对象。
    static Boolean
    valueOf(boolean b)
    返回表示指定boolean值的Boolean实例。
    static Boolean
    返回由指定字符串表示的Boolean。

    Methods declared in class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
  • Field Details

    • 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对象。
      自:
      1.1
  • Constructor Details

    • Boolean

      @Deprecated(since="9", forRemoval=true) public Boolean(boolean value)
      Deprecated, for removal: This API element is subject to removal in a future version.
      It is rarely appropriate to use this constructor. The static factory valueOf(boolean) is generally a better choice, as it is likely to yield significantly better space and time performance. Also consider using the final fields TRUE and FALSE if possible.
      分配一个表示value参数的Boolean对象。
      参数:
      value - Boolean的值。
    • Boolean

      @Deprecated(since="9", forRemoval=true) public Boolean(String s)
      Deprecated, for removal: This API element is subject to removal in a future version.
      It is rarely appropriate to use this constructor. Use parseBoolean(String) to convert a string to a boolean primitive, or use valueOf(String) to convert a string to a Boolean object.
      如果字符串参数不为null且等于字符串"true"(忽略大小写),则分配一个表示值为true的Boolean对象。否则,分配一个表示值为false的Boolean对象。
      参数:
      s - 要转换为Boolean的字符串。
  • Method Details

    • parseBoolean

      public static boolean parseBoolean(String s)
      将字符串参数解析为boolean。如果字符串参数不为null且等于字符串"true"(忽略大小写),则返回true值。否则,返回false值,包括对null参数的处理。

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

      参数:
      s - 包含要解析的boolean表示的String。
      返回:
      字符串参数表示的boolean值。
      自:
      1.5
    • booleanValue

      public boolean booleanValue()
      将此Boolean对象的值作为boolean原始类型返回。
      返回:
      该对象的原始boolean值。
    • valueOf

      public static Boolean valueOf(boolean b)
      返回表示指定boolean值的Boolean实例。如果指定的boolean值为true,则此方法返回Boolean.TRUE;如果为false,则返回Boolean.FALSE。如果不需要新的Boolean实例,则通常应优先使用此方法,而不是构造函数Boolean(boolean),因为此方法可能会获得更好的空间和时间性能。
      参数:
      b - 一个boolean值。
      返回:
      表示b的Boolean实例。
      自:
      1.4
    • valueOf

      public static Boolean valueOf(String s)
      返回由指定字符串表示的值的Boolean。返回的Boolean表示如果字符串参数不为null且等于字符串"true"(忽略大小写),则为true值。否则,返回false值,包括对null参数的处理。
      参数:
      s - 一个字符串。
      返回:
      由字符串表示的Boolean值。
    • toString

      public static String toString(boolean b)
      返回表示指定boolean的String对象。如果指定的boolean为true,则返回字符串"true",否则返回字符串"false"。
      参数:
      b - 要转换的boolean。
      返回:
      指定boolean的字符串表示。
      自:
      1.4
    • toString

      public String toString()
      返回表示此Boolean值的String对象。如果此对象表示true值,则返回等于"true"的字符串。否则,返回等于"false"的字符串。
      覆盖:
      toString 在类 Object
      返回:
      此对象的字符串表示。
    • hashCode

      public int hashCode()
      返回此Boolean对象的哈希码。
      覆盖:
      hashCode 在类 Object
      返回:
      如果此对象表示true,则返回整数1231;如果此对象表示false,则返回整数1237。
      参见:
    • hashCode

      public static int hashCode(boolean value)
      返回此Boolean对象的哈希码。
      参数:
      value - 要哈希的值
      返回:
      boolean值的哈希码值。
      自:
      1.8
    • equals

      public boolean equals(Object obj)
      当且仅当参数不为null且为表示与此对象相同boolean值的Boolean对象时,返回true。
      覆盖:
      equals 在类 Object
      参数:
      obj - 要比较的对象。
      返回:
      如果Boolean对象表示相同值,则返回true;否则返回false。
      参见:
    • getBoolean

      public static boolean getBoolean(String name)
      当且仅当由参数指定的系统属性存在且等于字符串"true"(忽略大小写)时,返回true。系统属性可通过System类定义的getProperty方法访问。

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

      参数:
      name - 系统属性名称。
      返回:
      系统属性的boolean值。
      抛出:
      SecurityException - 出现与System.getProperty相同的原因
      参见:
    • compareTo

      public int compareTo(Boolean b)
      将此Boolean实例与另一个进行比较。
      指定者:
      compareTo 在接口 Comparable<Boolean>
      参数:
      b - 要比较的Boolean实例
      返回:
      如果此对象表示与参数相同的布尔值,则为零;如果此对象表示true且参数表示false,则为正值;如果此对象表示false且参数表示true,则为负值
      抛出:
      NullPointerException - 如果参数为null
      自从:
      1.5
      参见:
    • compare

      public static int compare(boolean x, boolean y)
      比较两个boolean值。返回的值与以下内容相同:
          Boolean.valueOf(x).compareTo(Boolean.valueOf(y))
       
      参数:
      x - 要比较的第一个boolean
      y - 要比较的第二个boolean
      返回:
      如果x == y,则返回值0;如果!x && y,则返回小于0的值;如果x && !y,则返回大于0的值
      自从:
      1.7
    • logicalAnd

      public static boolean logicalAnd(boolean a, boolean b)
      返回将指定的boolean操作数应用于逻辑AND运算符的结果。
      参数:
      a - 第一个操作数
      b - 第二个操作数
      返回:
      ab的逻辑AND
      自从:
      1.8
      参见:
    • logicalOr

      public static boolean logicalOr(boolean a, boolean b)
      返回将指定的boolean操作数应用于逻辑OR运算符的结果。
      参数:
      a - 第一个操作数
      b - 第二个操作数
      返回:
      ab的逻辑OR
      自从:
      1.8
      参见:
    • logicalXor

      public static boolean logicalXor(boolean a, boolean b)
      返回将指定的boolean操作数应用于逻辑XOR运算符的结果。
      参数:
      a - 第一个操作数
      b - 第二个操作数
      返回:
      ab的逻辑XOR
      自从:
      1.8
      参见:
    • describeConstable

      public Optional<DynamicConstantDesc<Boolean>> describeConstable()
      返回包含此实例的名义描述符的Optional
      指定者:
      describeConstable 在接口 Constable
      返回:
      描述Boolean实例的Optional
      自从:
      15