Please, help us to better know about our user community by answering the following short survey: https://www.hdfgroup.org/website-survey/
HDF5  1.8.23
C-API Reference
Opaque Datatypes

Detailed Description

Functions

herr_t H5Tset_tag (hid_t type, const char *tag)
 Tags an opaque datatype. More...
 
char * H5Tget_tag (hid_t type)
 Gets the tag associated with an opaque datatype. More...
 

Function Documentation

◆ H5Tget_tag()

char * H5Tget_tag ( hid_t  type)

Gets the tag associated with an opaque datatype.

Parameters
[in]typeDatatype identifier of an opaque datatype
Returns
Returns a pointer to an allocated string if successful; otherwise returns NULL.

H5Tget_tag() returns the tag associated with the opaque datatype type.

Attention
The tag is returned via a pointer to an allocated string, which the caller must free.

◆ H5Tset_tag()

herr_t H5Tset_tag ( hid_t  type,
const char *  tag 
)

Tags an opaque datatype.

Parameters
[in]typeDatatype identifier of an opaque datatype
[in]tagDescriptive ASCII string with which the opaque datatype is to be tagged
Returns
Returns a non-negative value if successful; otherwise returns a negative value.

H5Tset_tag() tags an opaque datatype type with a descriptive ASCII identifier, tag.

tag is intended to provide a concise description; the maximum size is hard-coded in the HDF5 library as 256 bytes (H5T_OPAQUE_TAG_MAX).

Version
1.6.5 The H5T_OPAQUE_TAG_MAX macro constant, specifying the maximum size of an opaque datatype tag, was added in H5Tpublic.h.