Removes a conversion function


H5T_UNREGISTER ( type, name, src_id, dst_id, func)


<pre><code class="language-c">herr_t H5Tunregister( H5T_pers_t type, const char *name, hid_t src_id, hid_t dst_id, H5T_conv_t func )</code></pre>

H5T_pers_t typeIN: Conversion function type:
H5T_PERS_HARD for hard conversion functions or 
H5T_PERS_SOFT for soft conversion functions
const char *nameIN: Name displayed in diagnostic output
hid_t src_idIN: Identifier of source datatype
hid_t dst_idIN: Identifier of destination datatype
H5T_conv_t func    IN: Function to convert between source and destination datatypes


 H5T_UNREGISTER removes a conversion function matching criteria such as soft or hard conversion, source and destination types, and the conversion function.

If a user is trying to remove a conversion function he registered, all parameters can be used. If he is trying to remove a library’s default conversion function, there is no guarantee the name and func parameters will match the user’s chosen values. Passing in some values may cause this function to fail. A good practice is to pass in NULL as their values.

All parameters are optional. The missing parameters will be used to generalize the search criteria.

The conversion function pointer type declaration is described in H5Tregister.


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


Coming Soon!

Release    Change
1.6.3The following change occurred in the H5Tconv_t function:
   nelmts parameter type changed to size_t.