H5Tcreate
(
H5T_class_t class
,
size_tsize
)
H5Tcreate
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
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
H5Pset_char_encoding
.
ENUMs created with this function have
a signed native integer base datatype.
Use H5Tenum_create
if a different integer base datatype is required.
The datatype identifier returned from this function should be
released with H5Tclose
or resource leaks will result.
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 |
H5Pset_char_encoding
H5Tcopy
H5Tenum_create
| |
Creating
variable-length string datatypes
HDF5 Predefined Datatypes |
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
Release | Change |
1.8.8 | String datatype capability added to function in this release. |