range

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

Synopsis

range([ local ], low\_integer, high\_integer )

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())