index_object:tuple_pos()

index_object

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

Returns

a tuple's position in a space

Return type

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]...