H5G_CREATE_ANON creates a new empty group in the file specified by
loc_id. With default settings, H5G_CREATE_ANON provides similar functionality to that provided by H5G_CREATE, with the differences described below.
The new group’s creation and access properties are specified in
H5G_CREATE_ANON returns a new group identifier. This identifier must be linked into the HDF5 file structure with H5O_LINK or it will be deleted from the file when the file is closed.
The differences between this function and H5G_CREATE1 are as follows:
- H5G_CREATE1 does not provide for the use of custom property lists; H5G_CREATE1 always uses default properties.
- H5G_CREATE_ANON neither provides the new group’s name nor links it into the HDF5 file structure; those actions must be performed separately through a call to H5O_LINK, which offers greater control over linking.
- H5G_CREATE_ANON does not directly provide a hint mechanism for the group’s heap size. Comparable information can be included in the group creation property list
gcpl_id through a H5P_SET_LOCAL_HEAP_SIZE_HINT call.
A group created with this function should be closed with H5G_CLOSE when the group is no longer needed so that resource leaks will not develop.