Last modified: 14 October 2014
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:

unsigned char *`buf` | IN: Buffer for the datatype object to be decoded.

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

See Also:
  “Using Identifiers”