Creates an HDF5 datatype given a text description.
Procedure:
H5LT_TEXT_TO_DTYPE(text, lang_type)
Signature:
hid_t H5LTtext_to_dtype( const char *text, H5LT_lang_t lang_type)
Parameters:
const char *str | IN: A character string containing a DDL definition of the datatype to be created. |
H5LT_lang_t lang_type | IN: The language used to describe the datatype. The only currently supported language is H5LT_DDL . |
Description:
Given a text description of a datatype, this function creates an HDF5 datatype and returns the datatype identifier. The text description of the datatype has to comply with the lang_type
definition of HDF5 datatypes. Currently, only the DDL(H5LT_DDL
) is supported. The complete DDL definition of HDF5 datatypes 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.
“H5T_ENUM { H5T_NATIVE_INT;
“Bob” 0;
“Elena” 1;
“Quincey” 2;
“Frank” 3; }”
Returns:
Returns the datatype identifier(non-negative) if successful; otherwise returns a negative value.
Example:
--- Last Modified: December 04, 2017 | 07:15 AM