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