You are viewing an old version of this page. View the current version.
Version 1 Current »
Combines records from two tables into a third.
H5TB_COMBINE_TABLES(loc_id1, dset_name1, loc_id2, dset_name2, dset_name3)
herr_t H5TBcombine_tables ( hid_t loc_id1, const char *dset_name1, hid_t loc_id2, const char *dset_name2, const char *dset_name3 )
IN: Identifier of the file or group in which the first table is located.
const char *dset_name1
IN: The name of the first table to combine.
IN: Identifier of the file or group in which the second table is located.
const char *dset_name2
IN: The name of the second table to combine.
const char *dset_name3
IN: The name of the new table.
H5TBcombine_tables combines records from two datasets named dset_name1 and dset_name2, to a new table named dset_name3. These tables can be located on different files, identified by loc_id1 and loc_id2 (identifiers obtained with H5Fcreate). They can also be located on the same file. In this case one uses the same identifier for both parameters loc_id1 and loc_id2. If two files are used, the third table is written on the first file.
Returns a non-negative value if successful; otherwise returns a negative value.