# Range¶

Range is a type that represents a sequence of scalar whole numbers. The sequence can start and finish at any whole number, can be either descending or ascending and can skip numbers.

Note

This is one of the few places in kOS where there is a distinction between decimal (floating point, or fractional) scalar numbers and whole (integer, or round) scalar numbers. Using a decimal scalar will not throw an error, however it may give unexpected results due to rounding.

There are 3 ways of constructing a Range:

• RANGE(START, STOP, STEP)

Will create a sequence of numbers that starts counting with START, and stops counting just before but not including STOP, counting by increments of size STEP. In formal mathematics terms, the bounds are [START,STOP), rather than [START,STOP].

RANGE(3,8,1) will contain numbers 3, 4, 5, 6, and 7.

RANGE(3,8,2) will contain numbers 3, 5 and 7.

Will count backward automatically if need be: If START > STOP then the sequence will be descending. STEP should always be > 0 even when the sequence counts backward like this.

RANGE(2,-9,3) will contain numbers 2, -1, -4 and -7.

• RANGE(START, STOP)

Same as above but STEP is assumed to be 1.

• RANGE(STOP)

Same as above but STEP is assumed to be 1, and START is assumed to be 0.

## Code examples¶

FOR I IN RANGE(5) {
PRINT I.
}
// will print numbers 0,1,2,3,4

FOR I IN RANGE(2, 5) {
PRINT I*I.
}
// will print 4, 9 and 16


## Structure¶

structure Range
Members
Suffix Type Description
All suffixes of Enumerable   Range objects are a type of Enumerable
START scalar initial element of the range
STOP scalar range limit
STEP scalar step size

Note

This type is serializable.

Range:START
Type: scalar Get only

Returns the initial element of the range. Must be a round number.

Range:STOP
Type: scalar Get only

Returns the range limit. Must be a round number.

Range:STEP
Type: scalar Get only

Returns the step size. Must be a round number.