H5T_COMMIT1 commits the transient datatype (not immutable) to a file, turning it into a named datatype.
dtype_id is committed as a named datatype at the location
loc_id, which is either a file or group identifier, with the name
name can be a relative path based at
loc_id or an absolute path from the root of the file. Use of this function requires that any intermediate groups specified in the path already exist.
As is the case for any object in a group, the length of the name of a named datatype is not limited.
See H5T_COMMIT_ANON for a discussion of the differences between H5T_COMMIT and H5T_COMMIT_ANON.
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.