The ts_elem_to_row() function

The ts_elem_to_row() function converts a time series element into a new row.

Syntax

MI_ROW * 
ts_elem_to_row(ts_tsdesc  *tsdesc, 
                   ts_tselem  elem, 
                mi_integer off)

tsdesc

The descriptor for a time series returned by ts_open().

elem

A time series element. It must agree in type with the time series described by tsdesc.

off

If the time series is regular and off is non-negative, off is used to compute the time stamp value placed in the first column of the returned row.

If the time series is regular and off is negative, column 0 of the resulting row will be taken from column 0 of the elem parameter (which will be NULL if the element was created for or extracted from a regular time series).

If the time series is irregular, the off parameter is ignored.

Returns

A row. The row must be freed by the caller using the mi_row_free() procedure.