select-list-values

Description

select-list-values adaptor selects values, based on position, from a list.

Inputs

list Type: list Required: Yes The list containing the values to be selected.

begin Type: number Required: No The position of the first value to be selected. A negative number can be used to count from the end of the list (e.g. -5 would start at the fifth-to-last value). If unspecified, defaults to 1 (first value in list).

end Type: number Required: No The position of the last value to be selected. A negative number can be used to count from the end of the list. If unspecified, defaults to -1 (last value in list).

limit Type: number Required: No A positive number specifying a limit on the number of values to be selected. If unspecified, no limit will be applied.

Outputs

list Type: list A list containing the selected values.

Examples

Example 1: Default behaviour.

Inputs:

list:

1. January

2. February

3. March

4. April

5. May

begin: 1

end: 3

limit: null (empty)

Outputs:

list:

1. January

2. February

3. March

-> Selected values 1 to 3 from the list.

Example 1: Select values from the list with a specific limit.

Inputs:

list:

1. January

2. February

3. March

4. April

5. May

begin: null (empty)

end: null (empty)

limit: 4

Outputs:

list:

1. January

2. February

3. March

4. April

-> Selected values 1 to 4 from the list as the limit was set to 4.

Use Cases

• Use in combination with the sort-list adaptor to divide up an alphabetically sorted list.