Breadcrumbs

integerSequence() Operation

Generates an integer number sequence from a defined begin, end, and step between the numbers.

Syntax

integerSequence(aLimit)
integerSequence(aLimit, aStart)
integerSequence(aLimit, aStart, aStep)

Semantics

Generates an integer number sequence from a defined end, begin, and step between the numbers. Returns an array.

  • If no start value is given, the number sequence starts from 0.

  • The number sequence always ends with a value that is lower or equal to the defined end value for ascending sequences resp. higher or equal for descending sequences.

  • You can create descending number sequences by giving a negative step value.

Substitutables

aLimit, aStart, aStep

Can be any variable or literal having the type Integer. 

Error Codes

Find the related error codes on System Errors of domain FUMSM.

FUMSM/35

Step value cannot be zero in integer sequence

FUMSM/36

The integer sequence is not convergent

Examples

Simple ascending number sequence

set anArray = integerSequence(5);

Result:

JSON
{"anArray": [0, 1, 2, 3, 4, 5]}

Simple ascending number sequence from a start number

set anArray = integerSequence(5, 3);

Result:

JSON
{"anArray": [3, 4, 5]}

Ascending number sequence with steps

set anArray = integerSequence(20, 2, 3);

Result:

JSON
{"anArray": [2, 5, 8, 11, 14, 17, 20]}

Descending number sequence

set anArray = integerSequence(2, 20, -2);

Result:

JSON
{"anArray": [20, 18, 16, 14, 12, 10, 8, 6, 4, 2]}


Step is greater than limit

set anArray = integerSequence(8, 1, 10);

Result:

JSON
{"anArray": [1]}
📗