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
|
File or group identifier specifying the file in which the new group is to be created |
hid_t gcpl_id
|
Group creation property list identifier
( H5P_DEFAULT for the default property list)
|
hid_t gapl_id
|
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. |