- Created by Mike McGreevy, last modified by Barbara Jones on Dec 18, 2018
H5D_CREATE_ANON
Creates a dataset in a file without linking it into the file structure
Procedure:
H5D_CREATE_ANON(loc_id, type_id, space_id, dcpl_id, dapl_id)
Signature:
hid_t H5Dcreate_anon
(
hid_t loc_id,
hid_t type_id,
hid_t space_id,
hid_t dcpl_id,
hid_t dapl_id
)
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
Parameters:
hid_t loc_id | IN: Location identifier; may be a file, group, dataset, named datatype, or attribute |
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 |
Description:
H5D_CREATE_ANON creates a dataset in the file specified by loc_id.
loc_id may be a file, group, dataset, named datatype or attribute. If an attribute, dataset, or named datatype is specified for loc_id then the dataset will be created at the location where the attribute, dataset, or named datatype is attached.
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.
H5D_CREATE_ANON returns a new dataset identifier. Using this identifier, the new dataset must be linked into the HDF5 file structure with H5O_LINK or it will be deleted from the file when the file is closed.
See H5D_CREATE for further details and considerations on the use of H5D_CREATE and H5D_CREATE_ANON.
The differences between this function and H5D_CREATE are as follows:
- H5D_CREATE_ANON explicitly includes a dataset access property list.
H5Dcreatealways uses default dataset access properties. - H5D_CREATE_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 H5O_LINK, which offers greater control over linking.
A dataset created with this function should be closed with H5D_CLOSE when the dataset is no longer needed so that resource leaks will not develop.
Returns:
Returns a dataset identifier if successful; otherwise returns a negative value.
Example:
Coming Soon!
See Also:
-
Page:H5O_LINK — Creates a hard link to an object in an HDF5 file
-
Page:H5D_CREATE — Creates a new dataset and links it to a location in the file
-
Page:Using Identifiers — Identifier behavior and management within application programs.
History:
| Release | Change |
|---|---|
| 1.8.0 | Function introduced in this release. |
--- Last Modified: December 18, 2018 | 01:19 PM