This function reads the HDF AN annotation identified by the annotation identifier and stores the annotation into a variable.

Syntax


Result = HDF_AN_READANN( Annotation_id, annotation [, LENGTH=characters] )

Return Value


Returns SUCCEED (0) if successful or FAIL (-1) otherwise.

Arguments


Annotation_id

Annotation identifier returned by HDF_AN_CREATE, HDF_AN_CREATEF or HDF_AN_SELECT.

Annotation

A named variable that will contain the annotation.

Keywords


LENGTH

Specifies the number of characters to be read from the annotation argument. If LENGTH is not set, or LENGTH is greater than the number of characters in annotation, then the entire annotation is read.

Version History


5.2

Introduced