From 9ed500a8aa9eeab2c1d6b3279dc36b6cf99387bb Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Wed, 16 Jan 2002 13:14:44 -0500 Subject: [svn-r4832] Purpose: Bugfix and clarification. Description: H5Aclose -- Changed statement regarding future use of a released attribute identifier. H5Acreate -- Corrected create_plist_id reference and listed H5P_DEFAULT as only currently-accepted value. Platforms tested: IE 5 --- doc/html/RM_H5A.html | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/html/RM_H5A.html b/doc/html/RM_H5A.html index e36f24f..86e8813 100644 --- a/doc/html/RM_H5A.html +++ b/doc/html/RM_H5A.html @@ -169,8 +169,10 @@ See Attributes in the

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 creation property list, create_plist, + 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. @@ -185,7 +187,8 @@ See Attributes in the

hid_t space_id
IN: Identifier of dataspace for attribute.
hid_t create_plist -
IN: Identifier of creation property list (currently not used). +
IN: Identifier of creation property list. (Currently unused; + the only accepted value is H5P_DEFAULT.)
Returns:
Returns an attribute identifier if successful; @@ -624,9 +627,10 @@ See Attributes in the
Closes the specified attribute.
Description:
H5Aclose terminates access to the attribute - specified by its identifier, attr_id. - Further use of the attribute identifier will result in - undefined behavior. + specified by attr_id by releasing the identifier. +

+ Further use of a released attribute identifier is illegal; + a function using such an identifier will fail.

Parameters:
hid_t attr_id @@ -685,7 +689,7 @@ H5A   HDF Help Desk
-Last modified: 6 July 2000 +Last modified: 18 Dec 2001
Describes HDF5 Release 1.5, Unreleased Development Branch -- cgit v0.12