H5Dcreate_anon
(
hid_t loc_id
,
hid_t type_id
,
hid_t space_id
,
hid_t dcpl_id
,
hid_t dapl_id
)
H5Dcreate_anon
creates a dataset in the file
specified by loc_id
.
loc_id
may be a file identifier or a group identifier
within that file.
The dataset’s datatype and dataspace are specified by
type_id
and space_id
, respectively.
These are the datatype and dataspace of the dataset as it will
exist in the file, which may differ from the datatype and dataspace
in application memory.
Dataset creation properties are specified in the
dataset creation property list dcpl_id
.
Dataset access properties are specified in the
dataset access property list dapl_id
.
H5Dcreate_anon
returns a new dataset identifier.
Using this identifier, the new dataset must be linked
into the HDF5 file structure with
H5Olink
or it will be deleted from the file when the file is closed.
See H5Dcreate
for further details and considerations on the use of
H5Dcreate
and H5Dcreate_anon
.
The differences between this function and
H5Dcreate
are as follows:
H5Dcreate_anon
explicitly includes a dataset
access property list.
H5Dcreate
always uses default dataset access
properties.
H5Dcreate_anon
neither provides the new
dataset’s name nor links it into the HDF5 file structure;
those actions must be performed separately through a call to
H5Olink
,
which offers greater control over linking.
A dataset created with this function should be closed with
H5Dclose
when the dataset is no longer needed so that
resource leaks will not develop.
hid_t loc_id |
IN: Identifier of the file or group within which to create the dataset. |
hid_t type_id |
IN: Identifier of the datatype to use when creating the dataset. |
hid_t space_id |
IN: Identifier of the dataspace to use when creating the dataset. |
hid_t dcpl_id |
IN: Dataset creation property list identifier. |
hid_t dapl_id |
IN: Dataset access property list identifier. |
SUBROUTINE h5dcreate_anon_f(loc_id, type_id, space_id, dset_id, hdferr, & dcpl_id, dapl_id) IMPLICIT NONE INTEGER(HID_T), INTENT(IN) :: loc_id ! File or group identifier. INTEGER(HID_T), INTENT(IN) :: type_id ! Datatype identifier. INTEGER(HID_T), INTENT(IN) :: space_id ! Dataspace identifier. INTEGER(HID_T), INTENT(OUT) :: dset_id ! Dataset identifier. INTEGER, INTENT(OUT) :: hdferr ! Error code. ! 0 on success and -1 on failure INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dcpl_id ! Dataset creation property list ! identifier. INTEGER(HID_T), OPTIONAL, INTENT(IN) :: dapl_id ! Dataset access property list ! identifier. END SUBROUTINE h5dcreate_anon_f
H5Olink
H5Dcreate
Release | C |
1.8.0 | Function introduced in this release. |