summaryrefslogtreecommitdiffstats
path: root/doc/html/Groups.html
diff options
context:
space:
mode:
authorRobb Matzke <matzke@llnl.gov>1998-07-20 21:01:32 (GMT)
committerRobb Matzke <matzke@llnl.gov>1998-07-20 21:01:32 (GMT)
commit2423411a647cff2bc2c37789fc9973ed4a683348 (patch)
tree562aba5c2f3d8aabf164d81122b8531947dd4b68 /doc/html/Groups.html
parent00aa39c66f9e6a7cdf594533eadfaac74896898b (diff)
downloadhdf5-2423411a647cff2bc2c37789fc9973ed4a683348.zip
hdf5-2423411a647cff2bc2c37789fc9973ed4a683348.tar.gz
hdf5-2423411a647cff2bc2c37789fc9973ed4a683348.tar.bz2
[svn-r522] Changes since 19980720
---------------------- ./src/H5Gpublic.h ./src/H5Gprivate.h ./src/H5G.c ./test/dsets.c ./doc/html/Groups.html Added the H5Gset_comment() and H5Gget_comment() functions described in an earlier e-mail. ./src/H5.c Fixed a bug in the tracing code that caused certain data space enum types to not be printed. Nested case statements can get confusing to the eyes! ./tools/h5ls.c Prints the first 50 bytes or so of object comments.
Diffstat (limited to 'doc/html/Groups.html')
-rw-r--r--doc/html/Groups.html28
1 files changed, 27 insertions, 1 deletions
diff --git a/doc/html/Groups.html b/doc/html/Groups.html
index b1be2f1..5becb8b 100644
--- a/doc/html/Groups.html
+++ b/doc/html/Groups.html
@@ -278,11 +278,37 @@
API.</b>
</dl>
+ <h2>6. Comments</h2>
+
+ <p>Objects can have a comment associated with them. The comment
+ is set and queried with these two functions:
+
+ <dl>
+ <dt><code>herr_t H5Gset_comment (hid_t <em>loc_id</em>, const
+ char *<em>name</em>, const char *<em>comment</em>)</code>
+ <dd>The previous comment (if any) for the specified object is
+ replace with a new comment. If the <em>comment</em> argument
+ is the empty string or a null pointer then the comment message
+ is removed from the object. Comments should be relatively
+ short, null-terminated, ASCII strings.
+
+ <br><br>
+ <dt><code>herr_t H5Gget_comment (hid_t <em>loc_id</em>, const
+ char *<em>name</em>, size_t <em>bufsize</em>, char
+ *<em>comment</em>)</code>
+ <dd>The comment string for an object is returned through the
+ <em>comment</em> buffer. At most <em>bufsize</em> characters
+ including the null terminator are copied, and the result is
+ not null terminated if the comment is longer than the supplied
+ buffer. If an object doesn't have a comment then the empty
+ string is returned.
+ </dl>
+
<hr>
<address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address>
<!-- Created: Tue Jan 27 09:11:27 EST 1998 -->
<!-- hhmts start -->
-Last modified: Tue Mar 24 15:52:14 EST 1998
+Last modified: Mon Jul 20 16:45:40 EDT 1998
<!-- hhmts end -->
</body>
</html>