ts_open() 函数

ts_open() 函数用于打开时间系列。

语法

ts_tsdesc *
ts_open(MI_CONNECTION *conn, 
        ts_timeseries *ts, 
        MI_TYPEID     *type_id, 
        mi_integer    flags)

conn: 数据库连接。此参数不在服务器中使用。
ts: 要打开的时间系列。
type_id: 要打开的时间系列的类型标识。此标识一般通过查看 MI_FPARAM 结构确定。
flags: flags 参数的有效值在 tseries.h 中定义。

`flags` 参数值

flags 参数的有效值在文件 tseries.h 中定义。（用于 flags 参数的整数值是所需值的总和）。有效选项包括：

TSOPEN_RDWRITE: 用于打开时间系列的缺省方式。指示时间系列可以读取和写入。
TSOPEN_READ_HIDDEN: 指示应将隐藏的元素视为未隐藏来处理。
TSOPEN_READ_ONLY: 指示只能读取该时间系列。
TSOPEN_WRITE_HIDDEN: 允许隐藏的元素写入但先不显示。
TSOPEN_WRITE_AND_HIDE: 导致任何写入时间系列的元素也会被标记成隐藏。
TSOPEN_WRITE_AND_REVEAL: 显示任何写入的隐藏元素。
TSOPEN_NO_NULLS: 影响从未被分配的元素 (TS_NULL_NOTALLOCATED) 的返回方式。通常，如果一个元素未被分配，它会作为 NULL 返回。如果设置 TSOPEN_NO_NULLS，那么会返回每列都设为 NULL 的元素。

这些标志可任意组合使用，但不能使用以下四种组合：

TSOPEN_WRITE_HIDDEN 和 TSOPEN_WRITE_AND_HIDE
TSOPEN_WRITE_HIDDEN 和 TSOPEN_WRITE_AND_REVEAL
TSOPEN_WRITE_AND_REVEAL 和 TSOPEN_WRITE_AND_HIDE
TSOPEN_WRITE_HIDDEN、TSOPEN_WRITE_AND_HIDE 和 TSOPEN_WRITE_AND_REVEAL

TSOPEN_WRITE_HIDDEN、TSOPEN_WRITE_AND_REVEAL 和 TSOPEN_WRITE_AND_HIDE 标志不能与 TSOPEN_READ_HIDDEN 一起使用。

描述

几乎所有其他函数都取决于这个首先调用的函数。

使用 ts_close 可关闭时间系列。

返回结果

所打开时间系列的描述符。

示例

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