switch
- Former user (Deleted)
- Zoe Baldwin
- Dominic Sandhu (Unlicensed)
Function: switch()
Evaluates a set of conditions in turn, and returns the associated result for the first match.
Syntax
switch(
[condition1, result1],
[condition2, result2],
[conditionN, resultN],
defaultResult
)
| Argument | Type | Description |
|---|---|---|
| conditionN | Boolean | The condition to be checked. If it evaluates to true the corresponding result is returned and the switch statements ends. |
| resultN | String | Result to be returned if the condition is True. |
| defaultResult | String | If no previous condition has evaluated to True, this is the result to be returned. |
If only one clause is provided in the switch statement, it is treated as the default clause regardless of its condition.
Examples
Simple
This example shows how attribute in.city, can be used to set a region value. If none of the codes are matched, "Unknown" is the default value returned.
switch( [in.city == "Cambridge", "South"], [in.city == "Manchester", "North"], "Unknown" )
Returns "South" if in.city = "Cambridge".
Combined
This example shows how attribute in.cli, holding a telephone number, can be compared to a number of start codes and resolved to a destination. If none of the codes are matched, "Elsewhere" is the default destination returned.
switch( [startsWith(in.cli, "01223"), "Cambridge"], [startsWith(in.cli, "01604"), "Northampton"], "Elsewhere" )
Returns "Cambridge" if in.cli = "01223456765".
Output to a variable
This example shows how attribute in.city, can be used to set an output variable with a region value. If none of the codes are matched, the output variable is set to "Unknown".
switch( [in.city == "Cambridge", $output = "South"], [in.city == "Manchester", $output = "North"], $output = "Unknown" )
Returns the value set in the output variable. For example if in.city = "Cambridge", $output would be set to "South". This is a useful technique when combining a switch statement with other functions.