OUT: Buffer for the text description of the datatype.
IN: The language used to describe the datatype. The currently supported language isH5LT_DDL.
OUT: the size of buffer needed to store the text description.
Given an HDF5 datatype identifier, this function creates a description of this datatype inlang_typelanguage format.
A preliminaryH5LTdtype_to_textcall can be made to determine the size of the buffer needed with aNULLpassed in forstr. This value is returned aslen. That value can then be assigned tolenfor a secondH5Ttype_to_textcall, which will retrieve the actual text description for the datatype.
Iflenis not big enough for the description, the text description will be truncated to fit in the buffer.
Currently only DDL (H5LT_DDL) is supported forlang_type. The complete DDL definition of HDF5 data types can be found in the last chapter of theHDF5 User’s Guide. An example of DDL definition ofenumtype is shown as follows.