SUBROUTINE h5tcommit_anon_f(loc_id, dtype_id, hdferr, tcpl_id, tapl_id)
INTEGER(HID_T), INTENT(IN) :: loc_id ! A file or group identifier specifying
! the file in which the new named
! datatype is to be created.
INTEGER(HID_T), INTENT(IN) :: dtype_id
! Datatype identifier
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: tcpl_id
! A datatype creation property
! list identifier.
! H5P_DEFAULT_F = default property list
INTEGER(HID_T), OPTIONAL, INTENT(IN) :: tapl_id
! A datatype access property list id
END SUBROUTINE h5tcommit_anon_f
IN: A file or group identifier specifying the file in which the new named datatype is to be created.
IN: A datatype identifier.
IN: A datatype creation property list identifier. (H5P_DEFAULTfor the default property list.)
IN: A datatype access property list identifier. Currently unused; should always be passed as the valueH5P_DEFAULT.
H5Tcommit_anoncommits a transient datatype (not immutable) to a file, turning it into a named datatype with the specified creation and property lists. With default property lists,H5P_DEFAULT,H5Tcommit_anonprovides similar functionality to that ofH5Tcommit, with the differences described below.
The datatype access property list identifier,tapl_id, is provided for future functionality and is not used at this time. This parameter should always be passed as the valueH5P_DEFAULT.
Note thatH5Tcommit_anondoes not link this newly-committed datatype into the file. After theH5Tcommit_anoncall, the datatype identifierdtype_idmustbe linked into the HDF5 file structure withH5Olinkor it will be deleted from the file when the file is closed.
The differences between this function andH5Tcommitare as follows:
H5Tcommit_anonexplicitly includes property lists, which provides for greater control of the creation process and of the properties of the new named datatype.H5Tcommitalways uses default properties.
H5Tcommit_anonneither provides the new named datatype’s name nor links it into the HDF5 file structure; those actions must be performed separately through a call toH5Olink, which offers greater control over linking.
This function will not accept a datatype that cannot actually hold data. This currently includes compound datatypes with no fields and enumerated datatypes with no members.
Returns a non-negative value if successful; otherwise returns a negative value.
Function modified in this release to reject datatypes that will not accomodate actual data, such as a compound datatype with no fields or an enumerated datatype with no members.