From f17e2d273e083a5ac35975d90c9c74c1480e7d3c Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Fri, 17 Dec 1999 10:33:08 -0500 Subject: [svn-r1885] RM_H5.html H5check_version: Grammar correction. RM_H5A.html H5Acreate: Restructured and expanded the Description section, with particular attention to the fact that the attribute name specified in H5Acreate must be unique. --- doc/html/RM_H5.html | 3 ++- doc/html/RM_H5A.html | 32 +++++++++++++++++++------------- 2 files changed, 21 insertions(+), 14 deletions(-) diff --git a/doc/html/RM_H5.html b/doc/html/RM_H5.html index 6457994..18d23b5 100644 --- a/doc/html/RM_H5.html +++ b/doc/html/RM_H5.html @@ -188,7 +188,8 @@ and it users.
H5check_version verifies that the arguments match the version numbers compiled into the library. This function is intended to be called by the user to verify that the version of the header files - compiled into the application match the version of the HDF5 library being used. + compiled into the application matches the version of the HDF5 library + being used.

Due to the risks of data corruption or segmentation faults, H5check_version causes the application to abort if the diff --git a/doc/html/RM_H5A.html b/doc/html/RM_H5A.html index e452644..9425dff 100644 --- a/doc/html/RM_H5A.html +++ b/doc/html/RM_H5A.html @@ -152,22 +152,28 @@ See Attributes in the

Creates a dataset as an attribute of another group, dataset, or named datatype.
Description: -
H5Acreate creates an attribute which is attached - to the object specified with loc_id. - loc_id is an identifier of a group, dataset, - or named datatype. The name specified with name - for each attribute for an object must be unique for that object. +
H5Acreate creates an attribute named name + and attached to the object specified with loc_id. + loc_id is a group, dataset, or named datatype identifier. +

+ The attribute name specified in 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 H5Adelete then recreate + the attribute with H5Acreate. +

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 create_plist_id property list - is currently unused, but will be used int the future for optional - properties of attributes. The attribute identifier returned from - this function must be released with H5Aclose or - resource leaks will develop. Attempting to create an attribute - with the same name as an already existing attribute will fail, - leaving the pre-existing attribute in place. +

+ Currently only simple dataspaces are allowed for attribute dataspaces. +

+ The create_plist_id property list is currently unused; + it will be used in the future for optional attribute properties. +

+ The attribute identifier returned from this function must be released + with H5Aclose or resource leaks will develop.

Parameters:
hid_t loc_id -- cgit v0.12