|
|
Purpose
|
Retrieves the tag/reference number pair of an annotation given its index and type. |
|
|
Return value
|
Returns SUCCEED (or 0) if successful or FAIL (or -1) otherwise. |
|
|
Description
|
ANget_tagref retrieves the tag and reference number of the annotation identified by its index, the parameter index, and by its annotation type, the parameter annot_type. The tag is stored in the parameter ann_tag and the reference number is stored in the parameter ann_ref. |
|
|
|
The parameter index is a nonnegative integer and is less than the total number of annotations of type annot_type in the file. Use ANfileinfo to obtain the total number of annotations of each type in the file. |
|
|
|
The following table lists the valid values of the parameter annot_type in the left column, and the corresponding values of the parameter ann_tag in the right column. |