Creates a text description of an HDF5 datatype


H5LT_DTYPE_TO_TEXT (datatype, str, lang_type, len)


<pre><code class="language-c">herr_t H5LTdtype_to_text(hid_t datatype, char* str, H5LT_lang_t lang_type, size_t* len)</code></pre>

hid_t datatypeIN: Identifier of the datatype to be converted
char* strOUT: Buffer for the text description of the datatype
H5LT_lang_t lang_type    IN: The language used to describe the datatype. The currently supported language is H5LT_DDL
size_t* lenOUT: the size of buffer needed to store the text description


Given an HDF5 datatype identifier, this function creates a description of this datatype in lang_type language format.

A preliminary H5LTdtype_to_text call can be made to determine the size of the buffer needed with a NULL passed in for str. This value is returned as len. That value can then be assigned to len for a second H5Ttype_to_text call, which will retrieve the actual text description for the datatype.

If len is not big enough for the description, the text description will be truncated to fit in the buffer.

Currently only DDL (H5LT_DDL) is supported for lang_type. The complete DDL definition of HDF5 data types can be found in the last chapter of the HDF5 User’s Guide. An example of DDL definition of enum type is shown as follows.

            “Bob”        0;
            “Elena”      1;
            “Quincey”    2;      
            “Frank”      3;      }”


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


Coming Soon!