Last modified: 29 August 2012
Name: H5Tdecode

Signature:
hid_t H5Tdecode (unsigned char *buf)

Purpose:
Decode a binary object description of datatype and return a new object handle.

Description:
Given an object description of datatype in binary in a buffer, H5Tdecode reconstructs the HDF5 datatype object and returns a new object handle for it. The binary description of the object is encoded by H5Tencode. User is responsible for passing in the right buffer.

The datatype identifier returned by this function can be released with H5Tclose when the identifier is no longer needed so that resource leaks will not develop.

Parameters:

Returns:
Returns an object identifier (non-negative) if successful; otherwise returns a negative value.

Fortran90 Interface: h5tdecode_f
SUBROUTINE h5tdecode_f(buf, obj_id, hdferr)
  IMPLICIT NONE
  CHARACTER(LEN=*), INTENT(IN) :: buf  ! Data space object buffer to be decoded
  INTEGER(HID_T), INTENT(OUT) :: obj_id! Object identifier 
  INTEGER, INTENT(OUT) :: hdferr       ! Error code
                                       ! 0 on success and -1 on failure
END SUBROUTINE h5tdecode_f