/
SubList Macro

SubList Macro

Script

The following script extracts a set of values from a list or array of values, to create a sublist.

do(
  $list = $args[1],
  $startPosition = $args[2],
  $endPosition = $args[3],
  $subList = [],

  forEach($i,$startPosition..$endPosition,
    $subList = addElement($subList, getElement($list,$i)),
    _NULL
  ),

  $subList
)

Using the Script as a Macro

Save this script into a macro named subList.

Set Minimum Parameters and Maximum Parameters to 3.

In an expression, use the following syntax to run the subList macro in order to return a sub-list extracted from the supplied list. 

Syntax

subList([value1, value2, value3,...], <startPosition>, <endPosition>)


ArgumentType
valuenA value of any type
startPositionInteger representing where to start extracting values.Cannot be zero or a negative number.
endPositionInteger representing where to stop extracting values. 

Example

subList([1,2,3,4,5,6,7,8,9,10],6,9) 

returns the portion of the supplied List between element positions 6 and 9: [6,7,8,9]




Related content

range
range
More like this
Maths Functions
Maths Functions
Read with this
SubList Macro
SubList Macro
More like this
popElement
popElement
Read with this
SubList Macro
SubList Macro
More like this
countElements
countElements
Read with this