Example 3: <Data Table> Extraction Functions

SE_Return_Code SE_GetDataTableData

(

SE_Object data_table,

const SE_Data_Table_Sub_Extent *extents_ptr,

SE_Integer_Positive element_count,

const SE_Integer_Positive tbl_prop_descr_num[],

SE_Store store_in,

SE_Data_Table_Data **dt_data_p

);

Returns data as an array of SE_Data_Table_Data structs which is managed by the store. This data struct contains a union with pointers (arrays) for each data type that a data table may hold.

The full extents of the Data Table may be retrieved by setting extents_ptr to the value from SE_GetDataTableSubExtent. Or the user may specify any arbitrary sub-extent of the data table.

All elements in a Data Table may be retrieved by setting element_count and the tbl_prop_descr_num array to values set from SE_GetDataTableSignature. Or any subset of elements from the list of elements may be retrieved.

Returns data as an array of SE_Data_Table_Data structs which is managed by the store. This data struct contains a union with pointers (arrays) for each data type that a data table may hold.