H5TBcombine_tables

herr_t H5TBcombine_tables(hid_t loc_id1, const char *dset_name1, hid_t loc_id2, const char *dset_name2, const char *dset_name3)

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.

Synopsis:

Combines records from two tables into a third.

Parameters:

• loc_id1 – IN: Identifier of the file or group in which the first table is located.
• dset_name1 – IN: The name of the first table to combine.
• loc_id2 – IN: Identifier of the file or group in which the second table is located.
• dset_name2 – IN: The name of the second table to combine.
• dset_name3 – IN: The name of the new table.

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.