Module  java.base
软件包  java.lang

Class Boolean

  • All Implemented Interfaces:
    SerializableComparable<Boolean>


    public final class Boolean
    extends Object
    implements Serializable, Comparable<Boolean>
    布尔类包装一个对象中的基元类型boolean的值。 类型为Boolean的对象包含一个单一字段,其类型为boolean

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

    从以下版本开始:
    1.0
    另请参见:
    Serialized Form
    • Field Summary

      Fields  
      Modifier and Type Field 描述
      static Boolean FALSE
      Boolean对象对应于原始值 false
      static Boolean TRUE
      Boolean对象对应于原始值 true
      static Class<Boolean> TYPE
      表示原始类型的类对象布尔值。
    • 构造方法摘要

      构造方法  
      Constructor 描述
      Boolean​(boolean value)
      已过时。
      很少使用这个构造函数。 静态工厂valueOf(boolean)通常是一个更好的选择,因为它可能产生明显更好的空间和时间性能。 还可以考虑使用最终字段TRUEFALSE
      Boolean​(String s)
      已过时。
      很少使用这个构造函数。 使用parseBoolean(String)将字符串转换为boolean原语,或使用valueOf(String)将字符串转换为Boolean对象。
    • 方法摘要

      所有方法  静态方法  接口方法  具体的方法 
      Modifier and Type 方法 描述
      boolean booleanValue​()
      将此 Boolean对象的值作为 Boolean元返回。
      static int compare​(boolean x, boolean y)
      比较两个 boolean值。
      int compareTo​(Boolean b)
      将此 Boolean实例与另一个实例进行比较。
      boolean equals​(Object obj)
      返回 true当且仅当参数不是 null并且是一个 Boolean对象,该对象表示与此对象相同的值时, boolean值为 boolean
      static boolean getBoolean​(String name)
      返回 true当且仅当由参数命名的系统属性存在且等于忽略大小写时,字符串为 "true"
      int hashCode​()
      返回此 Boolean对象的哈希码。
      static int hashCode​(boolean value)
      返回一个boolean值的哈希码; 兼容Boolean.hashCode()
      static boolean logicalAnd​(boolean a, boolean b)
      返回将逻辑AND运算符应用于指定的 boolean操作数的结果。
      static boolean logicalOr​(boolean a, boolean b)
      返回将逻辑OR运算符应用于指定的 boolean操作数的结果。
      static boolean logicalXor​(boolean a, boolean b)
      返回将逻辑XOR运算符应用于指定的 boolean操作数的结果。
      static boolean parseBoolean​(String s)
      将字符串参数解析为布尔值。
      String toString​()
      返回表示此布尔值的一个 String对象。
      static String toString​(boolean b)
      返回表示指定布尔值的 String对象。
      static Boolean valueOf​(boolean b)
      返回表示 boolean值的 Boolean实例。
      static Boolean valueOf​(String s)
      返回一个 Boolean ,其值由指定的字符串表示。
    • 字段详细信息

      • TRUE

        public static final Boolean TRUE
        Boolean对象对应于原始值 true
      • FALSE

        public static final Boolean FALSE
        Boolean对象对应于原始值 false
      • TYPE

        public static final Class<Boolean> TYPE
        表示原始类型的类对象布尔值。
        从以下版本开始:
        1.1
    • 构造方法详细信息

      • Boolean

        @Deprecated(since="9")
        public Boolean​(boolean value)
        已过时。 很少使用这个构造函数。 静态工厂valueOf(boolean)通常是一个更好的选择,因为它可能产生明显更好的空间和时间性能。 还可以考虑使用最终的字段TRUEFALSE
        分配一个表示 value参数的 Boolean对象。
        参数
        value - 的价值 Boolean
      • Boolean

        @Deprecated(since="9")
        public Boolean​(String s)
        已过时。 很少使用这个构造函数。 使用parseBoolean(String)将字符串转换为boolean原语,或使用valueOf(String)将字符串转换为Boolean对象。
        如果字符串参数不是null并且等于忽略大小写,则分配一个Boolean对象,表示值为true ,表示为字符串"true" 否则,分配一个Boolean对象,代表值false
        参数
        s - 要转换为 Boolean的字符串。
    • 方法详细信息

      • parseBoolean

        public static boolean parseBoolean​(String s)
        将字符串参数解析为布尔值。 返回的boolean表示值为true如果字符串参数不是null ,并且等于,忽略大小写, "true"字符串"true" 否则返回false值,包括空参数。

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

        参数
        s - 包含要解析的布尔表示的 String
        结果
        由字符串参数表示的布尔值
        从以下版本开始:
        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
        从以下版本开始:
        1.4
      • valueOf

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

        public static String toString​(boolean b)
        返回表示指定布尔值的String对象。 如果指定的Boolean是true ,那么字符串"true"将被退回,否则该字符串"false"将被退回。
        参数
        b - 要转换的布尔值
        结果
        指定的字符串表示为 boolean
        从以下版本开始:
        1.4
      • toString

        public String toString​()
        返回表示此布尔值的一个String对象。 如果此对象表示值true ,则返回等于"true"的字符串。 否则返回等于"false"的字符串。
        重写:
        toStringObject
        结果
        该对象的字符串表示形式。
      • hashCode

        public static int hashCode​(boolean value)
        返回值为boolean的哈希码; 兼容Boolean.hashCode()
        参数
        value - 要进行散列的值
        结果
        一个哈希码值为 boolean值。
        从以下版本开始:
        1.8
      • equals

        public boolean equals​(Object obj)
        返回 true当且仅当参数不是 null ,是 Boolean对象,表示同样 boolean值与此对象。
        重写:
        equalsObject
        参数
        obj - 要比较的对象。
        结果
        true如果布尔对象表示相同的值; 否则为false
        另请参见:
        Object.hashCode()HashMap
      • compareTo

        public int compareTo​(Boolean b)
        将此 Boolean与另一个实例进行比较。
        Specified by:
        compareTo在接口 Comparable<Boolean>
        参数
        b - 要比较的 Boolean实例
        结果
        如果此对象表示与参数相同的布尔值,则为零; 如果此对象表示true并且该参数表示false,则为正值; 如果此对象表示false并且该参数表示为true,则为负值
        异常
        NullPointerException - 如果参数是 null
        从以下版本开始:
        1.5
        另请参见:
        Comparable
      • compare

        public static int compare​(boolean x,
                                  boolean y)
        比较两个boolean值。 返回的值与以下内容相同:
          Boolean.valueOf(x).compareTo(Boolean.valueOf(y)) 
        参数
        x - 第一个 boolean进行比较
        y - 第二个 boolean进行比较
        结果
        0如果是x == y ; 一个值小于0如果是!x && y ; 和值大于0如果x && !y
        从以下版本开始:
        1.7
      • logicalAnd

        public static boolean logicalAnd​(boolean a,
                                         boolean b)
        返回将逻辑AND运算符应用于指定的 boolean操作数的结果。
        参数
        a - 第一个操作数
        b - 第二个操作数
        结果
        逻辑AND为 ab
        从以下版本开始:
        1.8
        另请参见:
        BinaryOperator
      • logicalOr

        public static boolean logicalOr​(boolean a,
                                        boolean b)
        返回将逻辑OR运算符应用于指定的 boolean操作数的结果。
        参数
        a - 第一个操作数
        b - 第二个操作数
        结果
        逻辑OR为 ab
        从以下版本开始:
        1.8
        另请参见:
        BinaryOperator
      • logicalXor

        public static boolean logicalXor​(boolean a,
                                         boolean b)
        返回将逻辑XOR运算符应用于指定的 boolean操作数的结果。
        参数
        a - 第一个操作数
        b - 第二个操作数
        结果
        逻辑XOR为 ab
        从以下版本开始:
        1.8
        另请参见:
        BinaryOperator