H5G_GET_COMMENT retrieves the comment for the the object specified by
name. The comment is returned in the buffer
loc_id can specify any object in the file.
name can be one of the following:
— The name of the object relative to
— An absolute name of the object, starting from
/, the file’s root group
— A dot (
loc_id fully specifies the object
bufsize characters, including a null terminator, are returned in
comment. The returned value is not null terminated if the comment is longer than the supplied buffer. If the size of the comment is unknown, a preliminary
H5Gget_comment call will return the size of the comment, including space for the null terminator.
If an object does not have a comment, the empty string is returned in