SUBROUTINE h5gcreate_anon_f(loc_id, grp_id, hdferr, gcpl_id, gapl_id)
INTEGER(HID_T), INTENT(IN) :: loc_id ! Location identifier
INTEGER(HID_T), INTENT(OUT) :: grp_id ! Group identifier
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: gcpl_id
! Property list for group creation
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: gapl_id
! Property list for group access
END SUBROUTINE h5gcreate_anon_f
IN: Object identifier specifying the file in which the new group is to be created; may be a file, group, dataset, named datatype or attribute
IN: Group creation property list identifier (H5P_DEFAULT for the default property list)
IN: Group access property list identifier (No group access properties have been implemented at this time; use H5P_DEFAULT.)
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 gcpl_id and gapl_id, respectively.
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.
Returns a new group identifier if successful; otherwise returns a negative value.