Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The IIF
function returns one of two values, depending on whether the Boolean expression evaluates to true or false.
Syntax
IIF(<boolean_expr>, <true_expr>, <false_expr>)
Arguments
Description | |
---|---|
boolean_expr |
The Boolean expression to evaluate. |
true_expr |
The value returned if the Boolean expression evaluates to true. |
false_expr |
The value returned if the Boolean expression evaluates to false. |
Return types
Returns the value of true_expr
if the Boolean expression is true; otherwise, returns the value of false_expr
.
Examples
This section contains examples of how to use this query language construct.
Conditional evaluation
In this example, the IIF
function is used to return different values based on the Boolean expression.
SELECT VALUE {
evalTrue: IIF(true, 123, 456),
evalFalse: IIF(false, 123, 456),
evalNumberNotTrue: IIF(123, 123, 456),
evalStringNotTrue: IIF("ABC", 123, 456),
evalArrayNotTrue: IIF([1,2,3], 123, 456),
evalObjectNotTrue: IIF({"name": "Alice", "age": 20}, 123, 456)
}
[
{
"evalTrue": 123,
"evalFalse": 456,
"evalNumberNotTrue": 456,
"evalStringNotTrue": 456,
"evalArrayNotTrue": 456,
"evalObjectNotTrue": 456
}
]