Last modified: 9 October 2014
Name: H5Dcreate_anon
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` )

Purpose:
  Creates a dataset in a file without linking it into the file structure.

Description:
  `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.

Parameters:

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.

Returns:
  Returns a dataset identifier if successful; otherwise returns a negative value.

Fortran90 Interface: h5dcreate_anon_f

      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

See Also:
  `H5Olink`
  `H5Dcreate`
  “Using Identifiers”

History:

  Release | C
  1.8.0 | Function introduced in this release.