2015-06-11 12:02:27 +10:00
|
|
|
{
|
2015-09-20 17:12:43 +02:00
|
|
|
"name": "coalesce",
|
|
|
|
"type": "function",
|
2020-07-02 01:46:48 +01:00
|
|
|
"groups": ["Conditionals"],
|
2015-06-11 12:02:27 +10:00
|
|
|
"description": "Returns the first non-NULL value from the expression list.<br>This function can take any number of arguments.",
|
|
|
|
"variableLenArguments": true,
|
2022-01-07 08:33:29 -05:00
|
|
|
"arguments": [{
|
|
|
|
"arg": "expression1",
|
|
|
|
"syntaxOnly": true
|
|
|
|
}, {
|
|
|
|
"arg": "expression2",
|
|
|
|
"syntaxOnly": true
|
|
|
|
}, {
|
|
|
|
"arg": "expression",
|
|
|
|
"descOnly": true,
|
|
|
|
"description": "any valid expression or value, regardless of type."
|
|
|
|
}],
|
|
|
|
"examples": [{
|
|
|
|
"expression": "coalesce(NULL, 2)",
|
|
|
|
"returns": "2"
|
|
|
|
}, {
|
|
|
|
"expression": "coalesce(NULL, 2, 3)",
|
|
|
|
"returns": "2"
|
|
|
|
}, {
|
|
|
|
"expression": "coalesce(7, NULL, 3*2)",
|
|
|
|
"returns": "7"
|
|
|
|
}, {
|
|
|
|
"expression": "coalesce(\"fieldA\", \"fallbackField\", 'ERROR')",
|
|
|
|
"returns": "value of fieldA if it is non-NULL else the value of \"fallbackField\" or the string 'ERROR' if both are NULL"
|
|
|
|
}],
|
2022-01-11 11:17:49 -05:00
|
|
|
"tags": ["list", "first", "arguments", "null"]
|
2015-06-11 12:02:27 +10:00
|
|
|
}
|