ts_make_elem() 函数

ts_make_elem() 函数从值和空值数组创建元素。每个数组具有元素中每一列的一个值。

语法

ts_tselem 
ts_make_elem(ts_tsdesc *tsdesc, 
              MI_DATUM   *values,
              mi_boolean *nulls, 
              mi_integer *off)

tsdesc

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

values

要放在元素中的数据数组。按值显示的数据会放入数组中，而按引用显示的数据将存储指针。

nulls

存储元素中应为 NULL 的列。

off

对于规则时间系列，off 在返回时包含元素的偏移量。对于不规则的时间系列，off 设置为 -1。此参数可以是 NULL。

返回结果

元素及其偏移量。如果 tsdesc 是规则时间系列的描述符，那么元素中的时间戳记列将设置为 NULL；如果 tsdesc 是不规则时间系列的描述符，那么时间戳记列将设置为 values[0] 中的任意值。此元素必须由调用者使用 ts_free_elem() 释放。