diff options
| author | Robb Matzke <matzke@llnl.gov> | 1998-07-20 21:01:32 (GMT) |
|---|---|---|
| committer | Robb Matzke <matzke@llnl.gov> | 1998-07-20 21:01:32 (GMT) |
| commit | 2423411a647cff2bc2c37789fc9973ed4a683348 (patch) | |
| tree | 562aba5c2f3d8aabf164d81122b8531947dd4b68 /doc/html/Groups.html | |
| parent | 00aa39c66f9e6a7cdf594533eadfaac74896898b (diff) | |
| download | hdf5-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.html | 28 |
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> |