Go to the first, previous, next, last section, table of contents.


putann

int putann(DB_Annotator an, DB_Annotation *annot)

Return:

0
Success
-1
Failure: write error
-2
Failure: incorrect annotator number specified

This function writes the next annotation for the output annotator specified by an from the annotation structure pointed to by annot. Output annotators are numbered 0, 1, 2, etc. The caller must fill in all fields of the annotation structure. Using version 9.7 and later versions of the DB library, annotations may be written in any order (see section Annotation Order). Earlier versions require that annotations be supplied to putann in canonical order, and return an error code of -3 if an out-of-order annotation is supplied. All programs that write signals or annotations must invoke dbquit to close the output files properly (see section dbquit). Several of the example programs in chapter 6 illustrate the use of putann; for example, see section Example 1: An Annotation Filter.


Go to the first, previous, next, last section, table of contents.



George B. Moody (george@hstbme.mit.edu)