range

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

Synopsis

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:

g.V().valueMap().
   select('country').
   range(local, 0, 2)

Find the first two countries that each person has lived in ordered by startYear:

g.V().hasLabel('person').
   local(properties('country').order().by('startYear').range(0, 2).value().fold())