Home
Extending HCL OneDB™Beyond standard relational database objects, HCL OneDB™ can be extended to handle specialized data types, access methods, routines, and other objects. HCL OneDB™ includes many built-in extensions that are fully integrated in the database server. HCL OneDB™ also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for HCL OneDB™.
HCL OneDB™ extensions and DataBlade® modulesThese topics describe how to use built-in database extensions and separately installed DataBlade® modules.
TimeSeries Data User's GuideThe HCL OneDB™ TimeSeries Data User's Guide contains information to assist you in using the TimeSeries extension with HCL OneDB™.
Time series API routinesThe time series application programming interface routines allow application programmers to directly access a time series datum.
The ts_get_col_by_name() function

The ts_get_col_by_name() function

The ts_get_col_by_name() function pulls out the individual piece of data from an element in the column with the given name.

Syntax

MI_DATUM
ts_get_col_by_name(ts_tsdesc  *tsdesc, 
                    ts_tselem  tselem, 
                    mi_string  *colname, 
                    mi_boolean *isNull, 
                    mi_integer off)

tsdesc: A pointer returned by ts_open().
tselem: An element to get column data from.
colname: The name of the column in the element.
isNull: A pointer to a null indicator.
off: For a regular time series, off is the offset of the element in the time series. For an irregular time series, off is ignored.

Returns

The data in the specified column. If the type of the column is by reference, a pointer is returned. If the type is by value, the data itself is returned. The caller cannot free this value. On return, isNull is set to indicate whether the column is NULL.