Parameter
Description
This function takes a value and returns "true" or "false" depending on the value.
Returns
True, for a non-zero value; False for zero, false, and an empty string ("" ).
BooleanFormat(25) returns true. BooleanFormat(false) returns false.
The function throws an exception when you pass any string other than empty string ("" ).
For example, BooleanFormat("Hello") throws an exception.
But, BooleanFormat("true") or BooleanFormat("yes") returns true.
Similarly, BooleanFormat("false") or BooleanFormat("no") returns false.
Null value
- BooleanFormat("null"): Throws an exception because null is treated as a string.
- BooleanFormat(null): Null is treated as a variable, so will search for the value. If no such variable exists, an exception is thrown.
- BooleanFormat(javacast("null","null")): Here actual null is being passed, and hence it will return false.
Category
History
New in Adobe ColdFusion (2016 release)
Syntax
BooleanFormat(value)
Parameters
|
Description |
value |
A number, boolean value, null, or an empty string. |
Example
<cfscript> val=0; str="1123"; writeoutput(BooleanFormat(val)); // returns false writeoutput(BooleanFormat(str)); // returns true </cfscript>
Using member function
<cfscript> val=false; WriteOutput(val.BooleanFormat()); </cfscript>