H5A_CREATE1 creates the attribute
attr_name attached to the object specified with
The attribute name specified in
attr_name must be unique. Attempting to create an attribute with the same name as an already existing attribute will fail, leaving the pre-existing attribute in place. To overwrite an existing attribute with a new attribute of the same name, first call H5A_DELETE then recreate the attribute with H5A_CREATE1.
The datatype and dataspace identifiers of the attribute,
space_id, respectively, are created with the H5T and H5S interfaces, respectively.
Currently only simple dataspaces are allowed for attribute dataspaces.
The attribute creation property list,
acpl_id, is currently unused; it may be used in the future for optional attribute properties. At this time,
H5P_DEFAULT is the only accepted value. The attribute identifier returned from this function must be released with
H5Aclose or resource leaks will develop.