Routines (alphabetical) > Routines: H > HDF Routines > HDF_AN_READANN

# HDF_AN_READANN

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