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
H5TB_COMBINE_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 H5F_CREATE). 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 in the first file.
Returns a non-negative value if successful; otherwise returns a negative value.