ts_next() 函数

使用 ts_begin_scan() 开始扫描后，可以使用 ts_next() 从时间系列检索元素。

语法

mi_integer
ts_next(ts_tscan  *tscan, 
        ts_tselem *tselem)

tscan

指定的扫描。

tselem

ts_next() 填充的元素的指针。

描述

返回时，ts_tselem 包含时间系列中的下一个元素（如果有）。

当 ts_tselem 有效时，它可以传递给时间系列 API 中的其他例程，例如 ts_put_elem()、ts_get_col_by_name() 和 ts_get_col_by_number()。

返回结果

TS_SCAN_ELEM

包含有效元素的 tselem 参数。

TS_SCAN_NULL

元素中的值为 NULL 或被隐藏。如果 tselem 不为 NULL，那么元素被隐藏；否则元素为 NULL。

TS_SCAN_EOS

扫描已完成；tselem 无效。

返回值不得由调用者释放；当扫描结束时，将释放该值。调用两次 ts_next() 后将覆盖该值。

示例

请参阅 ts_interp() 函数（Interp 函数示例）中的 ts_next() 示例。