The H5A_CREATE function creates a dataset as an attribute of another group or dataset.
Note: Attributes are intended to be small objects with a maximum size of 16 kilobytes, data sizes greater than this limit will cause the attribute creation to fail. A large dataset intended as meta data for another dataset can be stored as an additional dataset. An attribute can then be attached to the original dataset as an object reference pointer to the desired supplemental dataset.
Example
See the example under H5_CREATE.
Syntax
Result = H5A_CREATE(Loc_id, Name, Datatype_id, Dataspace_id)
Return Value
The Result gives the attribute identifier number. This identifier should be released with the H5A_CLOSE procedure.
Arguments
Loc_id
An integer giving the identifier of the group, dataset, or named datatype to which the attribute will be attached
Name
A string giving the name of the attribute to create.
Datatype_id
An integer giving the datatype identifier of the new attribute.
Dataspace_id
An integer giving the dataspace identifier of the new attribute.
Keywords
None
Version History
See Also
H5A_CLOSE, H5S_CREATE_SIMPLE, H5T_IDL_CREATE