MobilityDB 1.1

◆ tsequenceset_find_timestamp()

bool tsequenceset_find_timestamp ( const TSequenceSet ss,
TimestampTz  t,
int *  loc 
)

Basic functions for temporal sequence sets.

Basic functions for temporal sequence sets.

Return the location of a timestamp in a temporal sequence set using binary search

If the timestamp is contained in the temporal sequence set, the index of the sequence is returned in the output parameter. Otherwise, returns a number encoding whether the timestamp is before, between two sequences, or after the temporal sequence set. For example, given a value composed of 3 sequences and a timestamp, the value returned in the output parameter is as follows:

0 1 2
|-----| |-----| |-----|
1) t^ => loc = 0
2) t^ => loc = 1
3) t^ => loc = 1
4) t^ => loc = 2
5) t^ => loc = 3
Parameters
[in]ssTemporal sequence set
[in]tTimestamp
[out]locLocation
Returns
Return true if the timestamp is contained in the temporal sequence set