Numeric ranges
Factor documentation > Factor handbook > The language > Collections > Sequence operations
Prev:Counted loops
Next:Control flow with sequences


A range is a virtual sequence with real number elements ranging from a to b by step. Ascending as well as descending ranges are supported.

The class of ranges:
range


Creating ranges with integer end-points. The standard mathematical convention is used, where ( or ) denotes that the end-point itself is not part of the range; [ or ] denotes that the end-point is part of the range:
[a,b] ( a b -- range )

(a,b] ( a b -- range )

[a,b) ( a b -- range )

(a,b) ( a b -- range )

[0,b] ( b -- range )

[1,b] ( b -- range )

[0,b) ( b -- range )


Creating general ranges:
<range> ( a b step -- range )


Ranges are most frequently used with sequence combinators as a means of iterating over integers. For example,
3 10 [a,b] [ sqrt ] map

Computing the factorial of 100 with a descending range:
100 1 [a,b] product

A range can be converted into a concrete sequence using a word such as >array. In most cases this is unnecessary since ranges implement the sequence protocol already. It is necessary if a mutable sequence is needed, for use with words such as set-nth or map!.