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