ts_last_valid() 函数

ts_last_valid() 函数抽取特定时间点的条目。

语法

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

tsdesc: ts_open() 返回的时间系列的描述符。
tstamp: 关注的时间戳记。
STATUS: mi_integer 值的指针。有关 STATUS 的描述，请参阅 ts_hide_elem() 函数。
off: 如果时间系列是规则的，那么 off 将设置为所返回元素的偏移量。如果时间系列不规则，或者如果时间系列为空，那么 off 将设置为 -1。此参数可作为 NULL 传递。

描述

对于规则的时间系列，此函数返回时间戳记早于或等于 tstamp 的第一个元素。对于不规则的时间系列，将返回给定时间戳记或之前的最新元素。

返回结果

在给定时间戳记或之前的最近元素。如果没有早于时间戳记的此类元素，将返回 NULL。

如果符合以下条件，将返回 NULL：

时间点处的元素是 NULL，且时间系列是规则的。
时间点早于原点。
时间系列不规则，且在给定的时间戳记或之前都没有元素。

该元素不得由调用者释放。在从描述符访存下一个元素之前，此元素都有效。