Class BooleanUtils


  • @Deprecated(since="2021-04-30")
    public class BooleanUtils
    extends java.lang.Object
    Deprecated.
    Commons Lang 2 is in maintenance mode. Commons Lang 3 should be used instead.

    Operations on boolean primitives and Boolean objects.

    This class tries to handle null input gracefully. An exception will not be thrown for a null input. Each method documents its behaviour in more detail.

    #ThreadSafe#

    Since:
    2.0
    • Constructor Summary

      Constructors 
      Constructor Description
      BooleanUtils()
      Deprecated.
      BooleanUtils instances should NOT be constructed in standard programming.
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static boolean isFalse​(java.lang.Boolean bool)
      Deprecated.
      Checks if a Boolean value is false, handling null by returning false.
      static boolean isNotFalse​(java.lang.Boolean bool)
      Deprecated.
      Checks if a Boolean value is not false, handling null by returning true.
      static boolean isNotTrue​(java.lang.Boolean bool)
      Deprecated.
      Checks if a Boolean value is not true, handling null by returning true.
      static boolean isTrue​(java.lang.Boolean bool)
      Deprecated.
      Checks if a Boolean value is true, handling null by returning false.
      static java.lang.Boolean negate​(java.lang.Boolean bool)
      Deprecated.
      Negates the specified boolean.
      static boolean toBoolean​(int value)
      Deprecated.
      Converts an int to a boolean using the convention that zero is false.
      static boolean toBoolean​(int value, int trueValue, int falseValue)
      Deprecated.
      Converts an int to a boolean specifying the conversion values.
      static boolean toBoolean​(java.lang.Boolean bool)
      Deprecated.
      Converts a Boolean to a boolean handling null by returning false.
      static boolean toBoolean​(java.lang.Integer value, java.lang.Integer trueValue, java.lang.Integer falseValue)
      Deprecated.
      Converts an Integer to a boolean specifying the conversion values.
      static boolean toBoolean​(java.lang.String str)
      Deprecated.
      Converts a String to a boolean (optimised for performance).
      static boolean toBoolean​(java.lang.String str, java.lang.String trueString, java.lang.String falseString)
      Deprecated.
      Converts a String to a Boolean throwing an exception if no match found.
      static boolean toBooleanDefaultIfNull​(java.lang.Boolean bool, boolean valueIfNull)
      Deprecated.
      Converts a Boolean to a boolean handling null.
      static java.lang.Boolean toBooleanObject​(boolean bool)
      Deprecated.
      Boolean factory that avoids creating new Boolean objecs all the time.
      static java.lang.Boolean toBooleanObject​(int value)
      Deprecated.
      Converts an int to a Boolean using the convention that zero is false.
      static java.lang.Boolean toBooleanObject​(int value, int trueValue, int falseValue, int nullValue)
      Deprecated.
      Converts an int to a Boolean specifying the conversion values.
      static java.lang.Boolean toBooleanObject​(java.lang.Integer value)
      Deprecated.
      Converts an Integer to a Boolean using the convention that zero is false.
      static java.lang.Boolean toBooleanObject​(java.lang.Integer value, java.lang.Integer trueValue, java.lang.Integer falseValue, java.lang.Integer nullValue)
      Deprecated.
      Converts an Integer to a Boolean specifying the conversion values.
      static java.lang.Boolean toBooleanObject​(java.lang.String str)
      Deprecated.
      Converts a String to a Boolean.
      static java.lang.Boolean toBooleanObject​(java.lang.String str, java.lang.String trueString, java.lang.String falseString, java.lang.String nullString)
      Deprecated.
      Converts a String to a Boolean throwing an exception if no match.
      static int toInteger​(boolean bool)
      Deprecated.
      Converts a boolean to an int using the convention that zero is false.
      static int toInteger​(boolean bool, int trueValue, int falseValue)
      Deprecated.
      Converts a boolean to an int specifying the conversion values.
      static int toInteger​(java.lang.Boolean bool, int trueValue, int falseValue, int nullValue)
      Deprecated.
      Converts a Boolean to an int specifying the conversion values.
      static java.lang.Integer toIntegerObject​(boolean bool)
      Deprecated.
      Converts a boolean to an Integer using the convention that zero is false.
      static java.lang.Integer toIntegerObject​(boolean bool, java.lang.Integer trueValue, java.lang.Integer falseValue)
      Deprecated.
      Converts a boolean to an Integer specifying the conversion values.
      static java.lang.Integer toIntegerObject​(java.lang.Boolean bool)
      Deprecated.
      Converts a Boolean to a Integer using the convention that zero is false.
      static java.lang.Integer toIntegerObject​(java.lang.Boolean bool, java.lang.Integer trueValue, java.lang.Integer falseValue, java.lang.Integer nullValue)
      Deprecated.
      Converts a Boolean to an Integer specifying the conversion values.
      static java.lang.String toString​(boolean bool, java.lang.String trueString, java.lang.String falseString)
      Deprecated.
      Converts a boolean to a String returning one of the input Strings.
      static java.lang.String toString​(java.lang.Boolean bool, java.lang.String trueString, java.lang.String falseString, java.lang.String nullString)
      Deprecated.
      Converts a Boolean to a String returning one of the input Strings.
      static java.lang.String toStringOnOff​(boolean bool)
      Deprecated.
      Converts a boolean to a String returning 'on' or 'off'.
      static java.lang.String toStringOnOff​(java.lang.Boolean bool)
      Deprecated.
      Converts a Boolean to a String returning 'on', 'off', or null.
      static java.lang.String toStringTrueFalse​(boolean bool)
      Deprecated.
      Converts a boolean to a String returning 'true' or 'false'.
      static java.lang.String toStringTrueFalse​(java.lang.Boolean bool)
      Deprecated.
      Converts a Boolean to a String returning 'true', 'false', or null.
      static java.lang.String toStringYesNo​(boolean bool)
      Deprecated.
      Converts a boolean to a String returning 'yes' or 'no'.
      static java.lang.String toStringYesNo​(java.lang.Boolean bool)
      Deprecated.
      Converts a Boolean to a String returning 'yes', 'no', or null.
      static boolean xor​(boolean[] array)
      Deprecated.
      Performs an xor on a set of booleans.
      static java.lang.Boolean xor​(java.lang.Boolean[] array)
      Deprecated.
      Performs an xor on an array of Booleans.
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • BooleanUtils

        public BooleanUtils()
        Deprecated.

        BooleanUtils instances should NOT be constructed in standard programming. Instead, the class should be used as BooleanUtils.toBooleanObject(true);.

        This constructor is public to permit tools that require a JavaBean instance to operate.

    • Method Detail

      • negate

        public static java.lang.Boolean negate​(java.lang.Boolean bool)
        Deprecated.

        Negates the specified boolean.

        If null is passed in, null will be returned.

           BooleanUtils.negate(Boolean.TRUE)  = Boolean.FALSE;
           BooleanUtils.negate(Boolean.FALSE) = Boolean.TRUE;
           BooleanUtils.negate(null)          = null;
         
        Parameters:
        bool - the Boolean to negate, may be null
        Returns:
        the negated Boolean, or null if null input
      • isTrue

        public static boolean isTrue​(java.lang.Boolean bool)
        Deprecated.

        Checks if a Boolean value is true, handling null by returning false.

           BooleanUtils.isTrue(Boolean.TRUE)  = true
           BooleanUtils.isTrue(Boolean.FALSE) = false
           BooleanUtils.isTrue(null)          = false
         
        Parameters:
        bool - the boolean to check, null returns false
        Returns:
        true only if the input is non-null and true
        Since:
        2.1
      • isNotTrue

        public static boolean isNotTrue​(java.lang.Boolean bool)
        Deprecated.

        Checks if a Boolean value is not true, handling null by returning true.

           BooleanUtils.isNotTrue(Boolean.TRUE)  = false
           BooleanUtils.isNotTrue(Boolean.FALSE) = true
           BooleanUtils.isNotTrue(null)          = true
         
        Parameters:
        bool - the boolean to check, null returns true
        Returns:
        true if the input is null or false
        Since:
        2.3
      • isFalse

        public static boolean isFalse​(java.lang.Boolean bool)
        Deprecated.

        Checks if a Boolean value is false, handling null by returning false.

           BooleanUtils.isFalse(Boolean.TRUE)  = false
           BooleanUtils.isFalse(Boolean.FALSE) = true
           BooleanUtils.isFalse(null)          = false
         
        Parameters:
        bool - the boolean to check, null returns false
        Returns:
        true only if the input is non-null and false
        Since:
        2.1
      • isNotFalse

        public static boolean isNotFalse​(java.lang.Boolean bool)
        Deprecated.

        Checks if a Boolean value is not false, handling null by returning true.

           BooleanUtils.isNotFalse(Boolean.TRUE)  = true
           BooleanUtils.isNotFalse(Boolean.FALSE) = false
           BooleanUtils.isNotFalse(null)          = true
         
        Parameters:
        bool - the boolean to check, null returns true
        Returns:
        true if the input is null or true
        Since:
        2.3
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(boolean bool)
        Deprecated.

        Boolean factory that avoids creating new Boolean objecs all the time.

        This method was added to JDK1.4 but is available here for earlier JDKs.

           BooleanUtils.toBooleanObject(false) = Boolean.FALSE
           BooleanUtils.toBooleanObject(true)  = Boolean.TRUE
         
        Parameters:
        bool - the boolean to convert
        Returns:
        Boolean.TRUE or Boolean.FALSE as appropriate
      • toBoolean

        public static boolean toBoolean​(java.lang.Boolean bool)
        Deprecated.

        Converts a Boolean to a boolean handling null by returning false.

           BooleanUtils.toBoolean(Boolean.TRUE)  = true
           BooleanUtils.toBoolean(Boolean.FALSE) = false
           BooleanUtils.toBoolean(null)          = false
         
        Parameters:
        bool - the boolean to convert
        Returns:
        true or false, null returns false
      • toBooleanDefaultIfNull

        public static boolean toBooleanDefaultIfNull​(java.lang.Boolean bool,
                                                     boolean valueIfNull)
        Deprecated.

        Converts a Boolean to a boolean handling null.

           BooleanUtils.toBooleanDefaultIfNull(Boolean.TRUE, false) = true
           BooleanUtils.toBooleanDefaultIfNull(Boolean.FALSE, true) = false
           BooleanUtils.toBooleanDefaultIfNull(null, true)          = true
         
        Parameters:
        bool - the boolean to convert
        valueIfNull - the boolean value to return if null
        Returns:
        true or false
      • toBoolean

        public static boolean toBoolean​(int value)
        Deprecated.

        Converts an int to a boolean using the convention that zero is false.

           BooleanUtils.toBoolean(0) = false
           BooleanUtils.toBoolean(1) = true
           BooleanUtils.toBoolean(2) = true
         
        Parameters:
        value - the int to convert
        Returns:
        true if non-zero, false if zero
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(int value)
        Deprecated.

        Converts an int to a Boolean using the convention that zero is false.

           BooleanUtils.toBoolean(0) = Boolean.FALSE
           BooleanUtils.toBoolean(1) = Boolean.TRUE
           BooleanUtils.toBoolean(2) = Boolean.TRUE
         
        Parameters:
        value - the int to convert
        Returns:
        Boolean.TRUE if non-zero, Boolean.FALSE if zero, null if null
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(java.lang.Integer value)
        Deprecated.

        Converts an Integer to a Boolean using the convention that zero is false.

        null will be converted to null.

           BooleanUtils.toBoolean(new Integer(0))    = Boolean.FALSE
           BooleanUtils.toBoolean(new Integer(1))    = Boolean.TRUE
           BooleanUtils.toBoolean(new Integer(null)) = null
         
        Parameters:
        value - the Integer to convert
        Returns:
        Boolean.TRUE if non-zero, Boolean.FALSE if zero, null if null input
      • toBoolean

        public static boolean toBoolean​(int value,
                                        int trueValue,
                                        int falseValue)
        Deprecated.

        Converts an int to a boolean specifying the conversion values.

           BooleanUtils.toBoolean(0, 1, 0) = false
           BooleanUtils.toBoolean(1, 1, 0) = true
           BooleanUtils.toBoolean(2, 1, 2) = false
           BooleanUtils.toBoolean(2, 2, 0) = true
         
        Parameters:
        value - the Integer to convert
        trueValue - the value to match for true
        falseValue - the value to match for false
        Returns:
        true or false
        Throws:
        java.lang.IllegalArgumentException - if no match
      • toBoolean

        public static boolean toBoolean​(java.lang.Integer value,
                                        java.lang.Integer trueValue,
                                        java.lang.Integer falseValue)
        Deprecated.

        Converts an Integer to a boolean specifying the conversion values.

           BooleanUtils.toBoolean(new Integer(0), new Integer(1), new Integer(0)) = false
           BooleanUtils.toBoolean(new Integer(1), new Integer(1), new Integer(0)) = true
           BooleanUtils.toBoolean(new Integer(2), new Integer(1), new Integer(2)) = false
           BooleanUtils.toBoolean(new Integer(2), new Integer(2), new Integer(0)) = true
           BooleanUtils.toBoolean(null, null, new Integer(0))                     = true
         
        Parameters:
        value - the Integer to convert
        trueValue - the value to match for true, may be null
        falseValue - the value to match for false, may be null
        Returns:
        true or false
        Throws:
        java.lang.IllegalArgumentException - if no match
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(int value,
                                                        int trueValue,
                                                        int falseValue,
                                                        int nullValue)
        Deprecated.

        Converts an int to a Boolean specifying the conversion values.

           BooleanUtils.toBooleanObject(0, 0, 2, 3) = Boolean.TRUE
           BooleanUtils.toBooleanObject(2, 1, 2, 3) = Boolean.FALSE
           BooleanUtils.toBooleanObject(3, 1, 2, 3) = null
         
        Parameters:
        value - the Integer to convert
        trueValue - the value to match for true
        falseValue - the value to match for false
        nullValue - the value to to match for null
        Returns:
        Boolean.TRUE, Boolean.FALSE, or null
        Throws:
        java.lang.IllegalArgumentException - if no match
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(java.lang.Integer value,
                                                        java.lang.Integer trueValue,
                                                        java.lang.Integer falseValue,
                                                        java.lang.Integer nullValue)
        Deprecated.

        Converts an Integer to a Boolean specifying the conversion values.

           BooleanUtils.toBooleanObject(new Integer(0), new Integer(0), new Integer(2), new Integer(3)) = Boolean.TRUE
           BooleanUtils.toBooleanObject(new Integer(2), new Integer(1), new Integer(2), new Integer(3)) = Boolean.FALSE
           BooleanUtils.toBooleanObject(new Integer(3), new Integer(1), new Integer(2), new Integer(3)) = null
         
        Parameters:
        value - the Integer to convert
        trueValue - the value to match for true, may be null
        falseValue - the value to match for false, may be null
        nullValue - the value to to match for null, may be null
        Returns:
        Boolean.TRUE, Boolean.FALSE, or null
        Throws:
        java.lang.IllegalArgumentException - if no match
      • toInteger

        public static int toInteger​(boolean bool)
        Deprecated.

        Converts a boolean to an int using the convention that zero is false.

           BooleanUtils.toInteger(true)  = 1
           BooleanUtils.toInteger(false) = 0
         
        Parameters:
        bool - the boolean to convert
        Returns:
        one if true, zero if false
      • toIntegerObject

        public static java.lang.Integer toIntegerObject​(boolean bool)
        Deprecated.

        Converts a boolean to an Integer using the convention that zero is false.

           BooleanUtils.toIntegerObject(true)  = new Integer(1)
           BooleanUtils.toIntegerObject(false) = new Integer(0)
         
        Parameters:
        bool - the boolean to convert
        Returns:
        one if true, zero if false
      • toIntegerObject

        public static java.lang.Integer toIntegerObject​(java.lang.Boolean bool)
        Deprecated.

        Converts a Boolean to a Integer using the convention that zero is false.

        null will be converted to null.

           BooleanUtils.toIntegerObject(Boolean.TRUE)  = new Integer(1)
           BooleanUtils.toIntegerObject(Boolean.FALSE) = new Integer(0)
         
        Parameters:
        bool - the Boolean to convert
        Returns:
        one if Boolean.TRUE, zero if Boolean.FALSE, null if null
      • toInteger

        public static int toInteger​(boolean bool,
                                    int trueValue,
                                    int falseValue)
        Deprecated.

        Converts a boolean to an int specifying the conversion values.

           BooleanUtils.toInteger(true, 1, 0)  = 1
           BooleanUtils.toInteger(false, 1, 0) = 0
         
        Parameters:
        bool - the to convert
        trueValue - the value to return if true
        falseValue - the value to return if false
        Returns:
        the appropriate value
      • toInteger

        public static int toInteger​(java.lang.Boolean bool,
                                    int trueValue,
                                    int falseValue,
                                    int nullValue)
        Deprecated.

        Converts a Boolean to an int specifying the conversion values.

           BooleanUtils.toInteger(Boolean.TRUE, 1, 0, 2)  = 1
           BooleanUtils.toInteger(Boolean.FALSE, 1, 0, 2) = 0
           BooleanUtils.toInteger(null, 1, 0, 2)          = 2
         
        Parameters:
        bool - the Boolean to convert
        trueValue - the value to return if true
        falseValue - the value to return if false
        nullValue - the value to return if null
        Returns:
        the appropriate value
      • toIntegerObject

        public static java.lang.Integer toIntegerObject​(boolean bool,
                                                        java.lang.Integer trueValue,
                                                        java.lang.Integer falseValue)
        Deprecated.

        Converts a boolean to an Integer specifying the conversion values.

           BooleanUtils.toIntegerObject(true, new Integer(1), new Integer(0))  = new Integer(1)
           BooleanUtils.toIntegerObject(false, new Integer(1), new Integer(0)) = new Integer(0)
         
        Parameters:
        bool - the to convert
        trueValue - the value to return if true, may be null
        falseValue - the value to return if false, may be null
        Returns:
        the appropriate value
      • toIntegerObject

        public static java.lang.Integer toIntegerObject​(java.lang.Boolean bool,
                                                        java.lang.Integer trueValue,
                                                        java.lang.Integer falseValue,
                                                        java.lang.Integer nullValue)
        Deprecated.

        Converts a Boolean to an Integer specifying the conversion values.

           BooleanUtils.toIntegerObject(Boolean.TRUE, new Integer(1), new Integer(0), new Integer(2))  = new Integer(1)
           BooleanUtils.toIntegerObject(Boolean.FALSE, new Integer(1), new Integer(0), new Integer(2)) = new Integer(0)
           BooleanUtils.toIntegerObject(null, new Integer(1), new Integer(0), new Integer(2))          = new Integer(2)
         
        Parameters:
        bool - the Boolean to convert
        trueValue - the value to return if true, may be null
        falseValue - the value to return if false, may be null
        nullValue - the value to return if null, may be null
        Returns:
        the appropriate value
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(java.lang.String str)
        Deprecated.

        Converts a String to a Boolean.

        'true', 'on' or 'yes' (case insensitive) will return true. 'false', 'off' or 'no' (case insensitive) will return false. Otherwise, null is returned.

           BooleanUtils.toBooleanObject(null)    = null
           BooleanUtils.toBooleanObject("true")  = Boolean.TRUE
           BooleanUtils.toBooleanObject("false") = Boolean.FALSE
           BooleanUtils.toBooleanObject("on")    = Boolean.TRUE
           BooleanUtils.toBooleanObject("ON")    = Boolean.TRUE
           BooleanUtils.toBooleanObject("off")   = Boolean.FALSE
           BooleanUtils.toBooleanObject("oFf")   = Boolean.FALSE
           BooleanUtils.toBooleanObject("blue")  = null
         
        Parameters:
        str - the String to check
        Returns:
        the Boolean value of the string, null if no match or null input
      • toBooleanObject

        public static java.lang.Boolean toBooleanObject​(java.lang.String str,
                                                        java.lang.String trueString,
                                                        java.lang.String falseString,
                                                        java.lang.String nullString)
        Deprecated.

        Converts a String to a Boolean throwing an exception if no match.

           BooleanUtils.toBooleanObject("true", "true", "false", "null")  = Boolean.TRUE
           BooleanUtils.toBooleanObject("false", "true", "false", "null") = Boolean.FALSE
           BooleanUtils.toBooleanObject("null", "true", "false", "null")  = null
         
        Parameters:
        str - the String to check
        trueString - the String to match for true (case sensitive), may be null
        falseString - the String to match for false (case sensitive), may be null
        nullString - the String to match for null (case sensitive), may be null
        Returns:
        the Boolean value of the string, null if either the String matches nullString or if null input and nullString is null
        Throws:
        java.lang.IllegalArgumentException - if the String doesn't match
      • toBoolean

        public static boolean toBoolean​(java.lang.String str)
        Deprecated.

        Converts a String to a boolean (optimised for performance).

        'true', 'on' or 'yes' (case insensitive) will return true. Otherwise, false is returned.

        This method performs 4 times faster (JDK1.4) than Boolean.valueOf(String). However, this method accepts 'on' and 'yes' as true values.

           BooleanUtils.toBoolean(null)    = false
           BooleanUtils.toBoolean("true")  = true
           BooleanUtils.toBoolean("TRUE")  = true
           BooleanUtils.toBoolean("tRUe")  = true
           BooleanUtils.toBoolean("on")    = true
           BooleanUtils.toBoolean("yes")   = true
           BooleanUtils.toBoolean("false") = false
           BooleanUtils.toBoolean("x gti") = false
         
        Parameters:
        str - the String to check
        Returns:
        the boolean value of the string, false if no match or the String is null
      • toBoolean

        public static boolean toBoolean​(java.lang.String str,
                                        java.lang.String trueString,
                                        java.lang.String falseString)
        Deprecated.

        Converts a String to a Boolean throwing an exception if no match found.

        null is returned if there is no match.

           BooleanUtils.toBoolean("true", "true", "false")  = true
           BooleanUtils.toBoolean("false", "true", "false") = false
         
        Parameters:
        str - the String to check
        trueString - the String to match for true (case sensitive), may be null
        falseString - the String to match for false (case sensitive), may be null
        Returns:
        the boolean value of the string
        Throws:
        java.lang.IllegalArgumentException - if the String doesn't match
      • toStringTrueFalse

        public static java.lang.String toStringTrueFalse​(java.lang.Boolean bool)
        Deprecated.

        Converts a Boolean to a String returning 'true', 'false', or null.

           BooleanUtils.toStringTrueFalse(Boolean.TRUE)  = "true"
           BooleanUtils.toStringTrueFalse(Boolean.FALSE) = "false"
           BooleanUtils.toStringTrueFalse(null)          = null;
         
        Parameters:
        bool - the Boolean to check
        Returns:
        'true', 'false', or null
      • toStringOnOff

        public static java.lang.String toStringOnOff​(java.lang.Boolean bool)
        Deprecated.

        Converts a Boolean to a String returning 'on', 'off', or null.

           BooleanUtils.toStringOnOff(Boolean.TRUE)  = "on"
           BooleanUtils.toStringOnOff(Boolean.FALSE) = "off"
           BooleanUtils.toStringOnOff(null)          = null;
         
        Parameters:
        bool - the Boolean to check
        Returns:
        'on', 'off', or null
      • toStringYesNo

        public static java.lang.String toStringYesNo​(java.lang.Boolean bool)
        Deprecated.

        Converts a Boolean to a String returning 'yes', 'no', or null.

           BooleanUtils.toStringYesNo(Boolean.TRUE)  = "yes"
           BooleanUtils.toStringYesNo(Boolean.FALSE) = "no"
           BooleanUtils.toStringYesNo(null)          = null;
         
        Parameters:
        bool - the Boolean to check
        Returns:
        'yes', 'no', or null
      • toString

        public static java.lang.String toString​(java.lang.Boolean bool,
                                                java.lang.String trueString,
                                                java.lang.String falseString,
                                                java.lang.String nullString)
        Deprecated.

        Converts a Boolean to a String returning one of the input Strings.

           BooleanUtils.toString(Boolean.TRUE, "true", "false", null)   = "true"
           BooleanUtils.toString(Boolean.FALSE, "true", "false", null)  = "false"
           BooleanUtils.toString(null, "true", "false", null)           = null;
         
        Parameters:
        bool - the Boolean to check
        trueString - the String to return if true, may be null
        falseString - the String to return if false, may be null
        nullString - the String to return if null, may be null
        Returns:
        one of the three input Strings
      • toStringTrueFalse

        public static java.lang.String toStringTrueFalse​(boolean bool)
        Deprecated.

        Converts a boolean to a String returning 'true' or 'false'.

           BooleanUtils.toStringTrueFalse(true)   = "true"
           BooleanUtils.toStringTrueFalse(false)  = "false"
         
        Parameters:
        bool - the Boolean to check
        Returns:
        'true', 'false', or null
      • toStringOnOff

        public static java.lang.String toStringOnOff​(boolean bool)
        Deprecated.

        Converts a boolean to a String returning 'on' or 'off'.

           BooleanUtils.toStringOnOff(true)   = "on"
           BooleanUtils.toStringOnOff(false)  = "off"
         
        Parameters:
        bool - the Boolean to check
        Returns:
        'on', 'off', or null
      • toStringYesNo

        public static java.lang.String toStringYesNo​(boolean bool)
        Deprecated.

        Converts a boolean to a String returning 'yes' or 'no'.

           BooleanUtils.toStringYesNo(true)   = "yes"
           BooleanUtils.toStringYesNo(false)  = "no"
         
        Parameters:
        bool - the Boolean to check
        Returns:
        'yes', 'no', or null
      • toString

        public static java.lang.String toString​(boolean bool,
                                                java.lang.String trueString,
                                                java.lang.String falseString)
        Deprecated.

        Converts a boolean to a String returning one of the input Strings.

           BooleanUtils.toString(true, "true", "false")   = "true"
           BooleanUtils.toString(false, "true", "false")  = "false"
         
        Parameters:
        bool - the Boolean to check
        trueString - the String to return if true, may be null
        falseString - the String to return if false, may be null
        Returns:
        one of the two input Strings
      • xor

        public static boolean xor​(boolean[] array)
        Deprecated.

        Performs an xor on a set of booleans.

           BooleanUtils.xor(new boolean[] { true, true })   = false
           BooleanUtils.xor(new boolean[] { false, false }) = false
           BooleanUtils.xor(new boolean[] { true, false })  = true
         
        Parameters:
        array - an array of booleans
        Returns:
        true if the xor is successful.
        Throws:
        java.lang.IllegalArgumentException - if array is null
        java.lang.IllegalArgumentException - if array is empty.
      • xor

        public static java.lang.Boolean xor​(java.lang.Boolean[] array)
        Deprecated.

        Performs an xor on an array of Booleans.

           BooleanUtils.xor(new Boolean[] { Boolean.TRUE, Boolean.TRUE })   = Boolean.FALSE
           BooleanUtils.xor(new Boolean[] { Boolean.FALSE, Boolean.FALSE }) = Boolean.FALSE
           BooleanUtils.xor(new Boolean[] { Boolean.TRUE, Boolean.FALSE })  = Boolean.TRUE
         
        Parameters:
        array - an array of Booleans
        Returns:
        true if the xor is successful.
        Throws:
        java.lang.IllegalArgumentException - if array is null
        java.lang.IllegalArgumentException - if array is empty.
        java.lang.IllegalArgumentException - if array contains a null