int drms_appendcomment ( DRMS_Record_t rec,
const char *  str,
int  newline 
)

Append a text string to the COMMENT keyword's value.

If the record rec has an COMMENT keyword, and if the COMMENT keyword has an existing non-empty-string value, the text string str will be appended to the existing text string. If the COMMENT keyword has no existing text-string value, then str will become the COMMENT keyword value.

If newline is set to 1, then prior to appending str, a newline character will be appended to an existing text-string value. If there is no existing text-string value, then newline has no effect.

Parameters:
rec The record whose COMMENT keyword is being modified.
str The text string to append to the COMMENT keyword.
newline If set to 1, then a newline will be appended to the COMMENT keyword's value before str is appended.
Returns:
The DRMS status (see drms_statuscodes.h).

Definition at line 1460 of file drms_keyword.c.


Generated on Mon Apr 24 07:00:41 2017 for JSOC_Documentation by  doxygen 1.5.7.1