index_object:tuple_pos()

object index_object¶

index_object:tuple_pos(tuple)¶

Return a tuple’s position for an index. This value can be passed to the after option of the select and pairs methods:

• index_object:select and space_object:select
• index_object:pairs and space_object:pairs

Note that tuple_pos does not work with functional and multikey indexes.

Parameters:	index_object (index_object) – an object reference tuple (scalar/table) – a tuple whose position should be found
Return:	a tuple’s position in a space
Rtype:	base64-encoded string

Example:

To try out this example, you need to bootstrap a Tarantool instance as described in Using data operations.

-- Insert test data --
tarantool> bands:insert{1, 'Roxette', 1986}
           bands:insert{2, 'Scorpions', 1965}
           bands:insert{3, 'Ace of Base', 1987}
           bands:insert{4, 'The Beatles', 1960}
           bands:insert{5, 'Pink Floyd', 1965}
           bands:insert{6, 'The Rolling Stones', 1962}
---
...

-- Get a tuple's position --
tarantool> position = bands.index.primary:tuple_pos({3, 'Ace of Base', 1987})
---
...
-- Pass the tuple's position as the 'after' parameter --
tarantool> bands:select({}, {limit = 3, after = position})
---
- - [4, 'The Beatles', 1960]
  - [5, 'Pink Floyd', 1965]
  - [6, 'The Rolling Stones', 1962]
...