H5Pfree_merge_committed_dtype_paths(
hid_t ocpypl_id
)
ocpypl_id.
These are the suggested paths previously set with
H5Padd_merge_committed_dtype_path.
H5Pfree_merge_committed_dtype_paths clears the
suggested paths stored in the object copy property list
ocpypl_id.
hid_t ocpypl_id
| IN: Object copy property list identifier. |
H5Pfree_merge_committed_dtype_paths will fail if the
object copy property list is invalid.
int main(void) {
hid_t ocpypl_id = H5Pcreate(H5P_OBJECT_COPY);
/* Enable the merging committed datatype feature. */
H5Pset_copy_object(ocpypl_id, H5O_COPY_MERGE_COMMITTED_DTYPE_FLAG);
/* Add a path to search for a matching committed datatype. */
H5Padd_merge_committed_dtype_path(ocpypl_id, "/group/committed_dtypeA");
/* Do the copy. */
H5Ocopy(...ocpypl_id...);
...
...
/* Free the previous suggested path. */
H5Pfree_merge_committed_dtype_paths(ocpypl_id);
/* Add a path to search for a matching committed datatype. */
H5Padd_merge_committed_dtype_path(ocpypl_id, "/group2/committed_dtypeB");
/* Do the copy. */
H5Ocopy(...ocpypl_id...);
...
...
}
H5Ocopy
H5Pset_copy_object
|
H5Pset_mcdt_search_cb
H5Padd_merge_committed_dtype_path
|
|
Copying Committed Datatypes with H5Ocopy
|
A comprehensive discussion of copying committed datatypes (PDF) in Advanced Topics in HDF5 |
| Release | Change |
| 1.8.9 | C function introduced in this release. |