IN: A datatype access property list identifierCurrently unused; should always be passed as the valueH5P_DEFAULT.

Hdf rm anchor

AnchorName

description

Description:

HTML Wrap

class

hdf-rm-section

H5T_COMMIT_ANON commits 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,H5T_COMMIT_ANON provides similar functionality to that of H5T_COMMIT, 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 thatH5T_COMMIT_ANON does not link this newly-committed datatype into the file. After theH5T_COMMIT_ANON call, the datatype identifierdtype_idmustbe linked into the HDF5 file structure with H5O_LINKor it will be deleted from the file when the file is closed.

The differences between this function and H5T_COMMITare as follows:

H5T_COMMIT_ANON explicitly includes property lists, which provides for greater control of the creation process and of the properties of the new named datatype. H5T_COMMITalways uses default properties.H5T_COMMIT_ANON neither provides the new named datatype’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.

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.