ts_last_elem() 函数

ts_last_elem() 函数返回时间系列中的最后一个元素。

语法

ts_tselem 
ts_last_elem(ts_tsdesc *tsdesc, 
              mi_integer *STATUS, 
              mi_integer *off)

tsdesc

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

STATUS

mi_integer 值的指针。有关 STATUS 的描述，请参阅 ts_hide_elem() 函数。

off

如果时间系列是规则的，那么 off 将设置为所返回元素的偏移量。如果时间系列不规则，或者如果时间系列为空，那么 off 将设置为 -1。此参数可作为 NULL 传递。

描述

如果 off 不为 NULL 且时间系列是规则的，那么此函数使用元素的偏移量填充 off，并且它将设置 STATUS 以指示元素为 NULL 还是被隐藏。

等效 SQL 函数是 GetLastElem。

返回结果

指定的时间系列的最后一个元素、其偏移量以及该元素为 NULL 还是被隐藏。如果时间系列不规则，那么偏移量将设置为 -1。该值不得由调用者释放。在使用此 tsdesc（时间系列描述符）访存元素的两次调用后将会覆盖该元素。