H5A_CREATE1 creates the attribute attr_name attached to the object specified with loc_id . 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, type_id and 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. |