The ts_copy() function

The ts_copy() function makes and returns a copy of the given time series of the type in the type_id argument.

Syntax

ts_timeseries *
ts_copy(MI_CONNECTION *conn, 
       ts_timeseries *ts, 
       MI_TYPEID     *typeid)

conn

A valid DataBlade API connection.

ts

The time series to be copied.

typeid

The ID of the row type of the time series to be copied.

Description

Since values returned by mi_value() are valid only until the next mi_next_row() or mi_query_finish() call, it is sometimes necessary to use ts_copy() to access a time series outside an mi_get_result() loop.

On the client, you must use the ts_copy() function to make a copy of a time series before you pass the time series as an argument to the mi_exec_prepare() statement.

Returns

A copy of the given time series. This value must be freed by the user by calling ts_free().