H5T_CREATE

Creates a new datatype

Procedure:

H5T_CREATE(class, size)

Signature:

hid_t H5Tcreate( H5T_class_t class, size_tsize )

SUBROUTINE h5tcreate_f(class, size, type_id, hdferr) 
  IMPLICIT NONE
  INTEGER, INTENT(IN) :: class             ! Datatype class can be one of
                                           !    H5T_COMPOUND_F
                                           !    H5T_OPAQUE_F
                                           !    H5T_ENUM_F
                                           !    H5T_STRING_F
  INTEGER(SIZE_T), INTENT(IN) :: size      ! Size of the datatype
  INTEGER(HID_T), INTENT(OUT) :: type_id   ! Datatype identifier
  INTEGER, INTENT(OUT) :: hdferr           ! Error code
                                           ! 0 on success and -1 on failure
END SUBROUTINE h5tcreate_f

Parameters:

H5T_class_t `class`	IN: Class of datatype to create; valid values include: `H5T_COMPOUND` `H5T_OPAQUE` `H5T_ENUM` `H5T_STRING`
size_t `size`	IN: Size, in bytes, of the datatype being created

Description:

H5T_CREATE creates a new datatype of the specified class with the specified number of bytes. This function is used only with the following datatype classes:

H5T_COMPOUND
H5T_OPAQUE
H5T_ENUM
H5T_STRING

Other datatypes, including integer and floating-point datatypes, are typically created by using H5Tcopy to copy and modify a predefined datatype.

When creating a variable-length string datatype, size must be H5T_VARIABLE; see Creating variable-length string datatypes.

When creating a fixed-length string datatype, size will be the length of the string in bytes. The length of the string in characters will depend on the encoding used; see H5P_SET_CHAR_ENCODING .

ENUMs created with this function have a signed native integer base datatype. Use H5T_ENUM_CREATE if a different integer base datatype is required.

The datatype identifier returned from this function should be released with H5T_CLOSE or resource leaks will result.

Returns:

Returns datatype identifier if successful; otherwise returns a negative value.

Example:

Coming Soon!

History:

Release	Change
1.8.8	String datatype capability added to function in this release.

--- Last Modified: May 10, 2019 | 02:31 PM

Page tree

H5T_CREATE

Procedure:

Signature:

Parameters:

Description:

Returns:

Example:

History:

The HDF Group

Site

Resources

Connect