ts_row_to_elem() 函数

ts_row_to_elem() 函数将 MI_ROW 结构转换为新的 ts_tselem 结构。新元素不会覆盖任何其他时间系列 API 函数返回的元素。

语法

ts_tselem 
ts_row_to_elem(ts_tsdesc  *tsdesc, 
                MI_ROW     *row, 
                mi_integer *offset_ptr)

tsdesc

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

row

MI_ROW 结构的指针。行必须与时间系列的子类型属于相同类型。

offset_ptr

如果时间系列是规则的，那么时间系列中元素的偏移量会在 offset_ptr 中返回。在这种情况下，列 0（时间戳记列）不得为 NULL。如果时间系列不规则，将在 offset_ptr 中返回 -1。

offset_ptr 参数可以是 NULL。在这种情况下，将不进行日历计算并且列 0 可以是 NULL。

返回结果

元素及其偏移量。如果时间系列是规则的，那么元素的列 0（时间戳记列）为 NULL。

此元素必须由调用者使用 ts_free_elem() 过程释放。