H5Tcommit1
(
hid_t loc_id
,
const char * name
,
hid_t dtype_id
)
H5Tcommit2
.
H5Tcommit1
commits the transient datatype
(not immutable) to a file, turning it into a named datatype.
The 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
.
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 H5Tcommit_anon
for a discussion of the differences between H5Tcommit
and H5Tcommit_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.
hid_t loc_id |
IN: File or group identifier |
const char * name |
IN: Name given to committed datatype |
hid_t dtype_id |
IN: Identifier of datatype to be committed and, upon function’s return, identifier for the committed datatype |
H5Tcommit
.
Release | C |
1.8.0 |
The function H5Tcommit renamed to
H5Tcommit1 and deprecated in this release. |
1.8.7 | 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. |