CHOOSE
Chooses a value or action to perform from a list of values, based on an index number.
Syntax
expression.CHOOSE(arg1, args);
expression - A variable that represents a ApiWorksheetFunction class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| arg1 | Required | ApiRange | ApiName | number | The position of the value in the list of values, a numeric value greater than or equal to 1 but less than the number of values in the list of values. | |
| args | Required | number | string | ApiRange | ApiName | Up to 254 values or the selected range of cells to analyze. The first argument is required, subsequent arguments are optional. Arguments can be numbers, ranges, names, or text strings. |
Returns
number
Example
This example shows how to choose a value or action to perform from a list of values, based on an index number.
- Code
- Result
// How to choose a value or action to perform from a list of values, based on an index number.
// Use function to choose a value or action to perform from a list of values, based on an index number.
let worksheet = Api.GetActiveSheet();
let func = Api.GetWorksheetFunction();
worksheet.GetRange("A1").SetValue(func.CHOOSE(2, 3, 4, 89, 76, 0));