H5Gcreate_anon(
hid_t loc_id,
hid_t gcpl_id,
hid_t gapl_id
)
H5Gcreate_anon creates a new empty group
in the file specified by loc_id.
With default settings, H5Gcreate_anon provides
similar functionality to that provided by H5Gcreate,
with the differences described below.
The new group’s creation and access properties are specified in
gcpl_id and gapl_id, respectively.
H5Gcreate_anon returns a new group identifier.
This identifier must be linked into the HDF5 file structure
with H5Lcreate_hard
or it will be deleted from the file when the file is closed.
The differences between this function and H5Gcreate1
are as follows:
H5Gcreate1 does not provide for the use of
custom property lists;
H5Gcreate1 always uses default properties.
H5Gcreate_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
H5Lcreate_hard,
which offers greater control over linking.
H5Gcreate_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
H5Pset_local_heap_size_hint call.
hid_t loc_id
|
IN: File or group identifier specifying the file in which the new group is to be created |
hid_t gcpl_id
|
IN: Group creation property list identifier
( H5P_DEFAULT for the default property list)
|
hid_t gapl_id
|
IN: Group access property list identifier
(No group access properties have been implemented at this time; use H5P_DEFAULT.)
|
SUBROUTINE h5gcreate_anon_f(loc_id, grp_id, hdferr, gcpl_id, gapl_id)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: loc_id ! File or group 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
| Release | C |
| 1.8.0 | Function introduced in this release. |