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.
negate
public static Boolean negate(Boolean bool)
Negates the specified boolean.
If
null
is passed in,
null
will be returned.
bool
- the Boolean to negate, may be null
- the negated Boolean, or
null
if null
input
toBoolean
public static boolean toBoolean(Boolean bool)
Converts a Boolean to a boolean handling null
by returning false
.
bool
- the boolean to convert
true
or false
,
null
returns false
toBoolean
public static boolean toBoolean(Integer value,
Integer trueValue,
Integer falseValue)
Converts an Integer to a boolean specifying the conversion values.
value
- the Integer to converttrueValue
- the value to match for true
,
may be null
falseValue
- the value to match for false
,
may be null
toBoolean
public static boolean toBoolean(String str)
Converts a String to a boolean.
'true'
,
'on'
or
'yes'
(case insensitive) will return
true
. Otherwise,
false
is returned.
str
- the String to check
- the boolean value of the string,
false
if no match
toBoolean
public static boolean toBoolean(String str,
String trueString,
String falseString)
Converts a String to a Boolean throwing an exception if no match found.
null is returned if there is no match.
str
- the String to checktrueString
- the String to match for true
(case sensitive), may be null
falseString
- the String to match for false
(case sensitive), may be null
- the boolean value of the string
toBoolean
public static boolean toBoolean(int value)
Converts an int to a boolean using the convention that zero
is false
.
value
- the int to convert
true
if non-zero, false
if zero
toBoolean
public static boolean toBoolean(int value,
int trueValue,
int falseValue)
Converts an int to a boolean specifying the conversion values.
value
- the Integer to converttrueValue
- the value to match for true
falseValue
- the value to match for false
toBooleanDefaultIfNull
public static boolean toBooleanDefaultIfNull(Boolean bool,
boolean valueIfNull)
Converts a Boolean to a boolean handling null
.
bool
- the boolean to convertvalueIfNull
- the boolean value to return if null
toBooleanObject
public static Boolean toBooleanObject(Integer value)
Converts an Integer to a Boolean using the convention that
zero
is
false
.
null
will be converted to
null
.
value
- the Integer to convert
- Boolean.TRUE if non-zero, Boolean.FALSE if zero,
null
if null
input
toBooleanObject
public static Boolean toBooleanObject(Integer value,
Integer trueValue,
Integer falseValue,
Integer nullValue)
Converts an Integer to a Boolean specifying the conversion values.
value
- the Integer to converttrueValue
- 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
- Boolean.TRUE, Boolean.FALSE, or
null
toBooleanObject
public static Boolean toBooleanObject(String str)
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.
str
- the String to check
- the Boolean value of the string,
null
if no match or null
input
toBooleanObject
public static Boolean toBooleanObject(String str,
String trueString,
String falseString,
String nullString)
Converts a String to a Boolean throwing an exception if no match.
str
- the String to checktrueString
- 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
- the Boolean value of the string,
null
if no match or null
input
toBooleanObject
public static Boolean toBooleanObject(boolean bool)
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.
bool
- the boolean to convert
- Boolean.TRUE or Boolean.FALSE as appropriate
toBooleanObject
public static Boolean toBooleanObject(int value)
Converts an int to a Boolean using the convention that zero
is false
.
value
- the int to convert
- Boolean.TRUE if non-zero, Boolean.FALSE if zero,
null
if null
toBooleanObject
public static Boolean toBooleanObject(int value,
int trueValue,
int falseValue,
int nullValue)
Converts an int to a Boolean specifying the conversion values.
value
- the Integer to converttrueValue
- the value to match for true
falseValue
- the value to match for false
nullValue
- the value to to match for null
- Boolean.TRUE, Boolean.FALSE, or
null
toInteger
public static int toInteger(Boolean bool,
int trueValue,
int falseValue,
int nullValue)
Converts a Boolean to an int specifying the conversion values.
bool
- the Boolean to converttrueValue
- the value to return if true
falseValue
- the value to return if false
nullValue
- the value to return if null
toInteger
public static int toInteger(boolean bool)
Converts a boolean to an int using the convention that
zero
is false
.
bool
- the boolean to convert
- one if
true
, zero if false
toInteger
public static int toInteger(boolean bool,
int trueValue,
int falseValue)
Converts a boolean to an int specifying the conversion values.
bool
- the to converttrueValue
- the value to return if true
falseValue
- the value to return if false
toIntegerObject
public static Integer toIntegerObject(Boolean bool)
Converts a Boolean to a Integer using the convention that
zero
is
false
.
null
will be converted to
null
.
bool
- the Boolean to convert
- one if Boolean.TRUE, zero if Boolean.FALSE,
null
if null
toIntegerObject
public static Integer toIntegerObject(Boolean bool,
Integer trueValue,
Integer falseValue,
Integer nullValue)
Converts a Boolean to an Integer specifying the conversion values.
bool
- the Boolean to converttrueValue
- 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
toIntegerObject
public static Integer toIntegerObject(boolean bool)
Converts a boolean to an Integer using the convention that
zero
is false
.
bool
- the boolean to convert
- one if
true
, zero if false
toIntegerObject
public static Integer toIntegerObject(boolean bool,
Integer trueValue,
Integer falseValue)
Converts a boolean to an Integer specifying the conversion values.
bool
- the to converttrueValue
- the value to return if true
,
may be null
falseValue
- the value to return if false
,
may be null
toString
public static String toString(Boolean bool,
String trueString,
String falseString,
String nullString)
Converts a Boolean to a String returning one of the input Strings.
bool
- the Boolean to checktrueString
- 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
- one of the three input Strings
toString
public static String toString(boolean bool,
String trueString,
String falseString)
Converts a boolean to a String returning one of the input Strings.
bool
- the Boolean to checktrueString
- the String to return if true
,
may be null
falseString
- the String to return if false
,
may be null
- one of the two input Strings
toStringOnOff
public static String toStringOnOff(Boolean bool)
Converts a Boolean to a String returning 'on'
,
'off'
, or null
.
bool
- the Boolean to check
toStringOnOff
public static String toStringOnOff(boolean bool)
Converts a boolean to a String returning 'on'
or 'off'
.
bool
- the Boolean to check
toStringTrueFalse
public static String toStringTrueFalse(Boolean bool)
Converts a Boolean to a String returning 'true'
,
'false'
, or null
.
bool
- the Boolean to check
toStringTrueFalse
public static String toStringTrueFalse(boolean bool)
Converts a boolean to a String returning 'true'
or 'false'
.
bool
- the Boolean to check
toStringYesNo
public static String toStringYesNo(Boolean bool)
Converts a Boolean to a String returning 'yes'
,
'no'
, or null
.
bool
- the Boolean to check
toStringYesNo
public static String toStringYesNo(boolean bool)
Converts a boolean to a String returning 'yes'
or 'no'
.
bool
- the Boolean to check
xor
public static Boolean xor(Boolean[] array)
Performs an xor on an array of Booleans.
array
- an array of Boolean
s
true
if the xor is successful.
xor
public static boolean xor(boolean[] array)
Performs an xor on a set of booleans.
array
- an array of boolean
s
true
if the xor is successful.