Filter only a specified number of objects into the next step.


range([ local ], low_integer, high_integer )
Table 1. Legend
Syntax conventions Description
Lowercase and uppercase Literal keyword. Includes ().
Italics Variable value. Replace with a user-defined value.
[] Optional. Square brackets ( [] ) surround optional command arguments. Do not type the square brackets.
{} Group. Braces ( {} ) identify a group to choose from. Do not type the braces.
| Or. A vertical bar ( | ) separates alternative elements. Type any one of the elements. Do not type the vertical bar.
... Repeatable. An ellipsis ( ... ) indicates that you can repeat the syntax element as often as required.


The range() step is a filter step that allows only the specified number of objects to pass onto the next step.


Find the first two countries listed for each person:
   range(local, 0, 2)
Find the first two countries that each person has lived in ordered by startYear:
   local(properties('country').order().by('startYear').range(0, 2).value().fold())