Name: H5Tcommit2
Signature:
herr_t H5Tcommit2( hid_t loc_id, const char *name, hid_t dtype_id, hid_t lcpl_id, hid_t tcpl_id, hid_t tapl_id )

Purpose:
Commits a transient datatype, linking it into the file and creating a new named datatype.

Description:
H5Tcommit2 saves a transient datatype as an immutable named datatype in a file. The datatype specified by dtype_id is committed to the file with the name name at the location specified by loc_id and with the datatype creation and access property lists tcpl_id and tapl_id, respectively.

loc_id may be a file identifier, or a group identifier within that file. name may be either an absolute path in the file or a relative path from loc_id naming the newly-commited datatype.

The link creation property list, lcpl_id, governs creation of the link(s) by which the new named datatype is accessed and the creation of any intermediate groups that may be missing.

Once commited, this datatype may be used to define the datatype of any other dataset or attribute in the file.

Parameters:
hid_t loc_id IN: Location identifier
const char *name     IN: Name given to committed datatype
hid_t dtype_id IN: Identifier of datatype to be committed
hid_t lcpl_id IN: Link creation property list
hid_t tcpl_id IN: Datatype creation property list
hid_t tapl_id IN: Datatype access property list

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface: See listing under H5Tcommit.

History:
Release     C
1.8.0 Function introduced in this release.