ts_previous_valid() 函数

ts_previous_valid() 函数返回给定时间戳记之前的最后一个元素。

语法

ts_tselem 
ts_previous_valid(ts_tsdesc   *tsdesc, 
                   mi_datetime *tstamp, 
                   mi_integer  *STATUS, 
                   mi_integer  *off)

tsdesc

ts_open() 返回的时间系列描述符。

tstamp

指向返回的元素之后的时间戳记。

STATUS

返回时指向填充的 mi_integer 值。如果时间戳记前不存在元素，或者如果时间戳记在时间系列原点的前面，那么 STATUS 将设置为非零值。有关 STATUS 的描述，请参阅 ts_hide_elem() 函数。

off

对于规则时间系列，off 在返回时指向填充的 mi_integer 值以及所返回元素的偏移量。对于不规则的时间系列，off 设置为 -1。此参数可作为 NULL 传递。

描述

等效 SQL 函数是 GetPreviousValid。

返回结果

给定时间戳记前面的元素（如果有）。返回的元素不得由调用者释放。在使用此 tsdesc（时间系列描述符）访存元素的两次调用后将会覆盖该元素。

对于不规则的时间系列，如果给定的时间戳记前面没有有效元素，将返回 NULL。如果给定的时间戳记早于或等于时间系列的原点，那么也将返回 NULL。