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

# HDF_DFAN_GETLABEL

The HDF_DFAN_GETLABEL procedure reads the label for the given tag-reference pair in an HDF file.

## Examples

fid = HDF_OPEN('test.hdf', /ALL)

label = 'TEST LABEL'

tag = 105 ; The annotation tag.

ref = 2 ; Choose a reference number.

; Write the label:

HDF_DFAN_PUTLABEL, 'test.hdf', tag, ref, label

; Read back the label:

HDF_DFAN_GETLABEL, 'test.hdf', tag, ref, outl

HELP, outl ; They look the same...

; Close the HDF file:

HDF_CLOSE, fid

## Syntax

HDF_DFAN_GETLABEL, Filename, Tag, Ref, Label

## Arguments

### Filename

A scalar string that contains the name of the file to be read.

### Tag

The tag number.

### Reference

The reference number.

### Label

A named variable in which the label is returned as a string.

## Keywords

None

## Version History

4.0 | Introduced

## See Also

HDF_DFAN_GETDESC, HDF_DFAN_LABLIST, HDF_DFAN_PUTDESC, HDF_DFAN_PUTLABEL