HDF_DFAN_GETLABEL

The HDF_DFAN_GETLABEL procedure reads the label for the given tag-reference pair in a Hierarchical Data Format file.

Calling Sequence

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.

Ref

The reference number.

Label

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

Example

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

label = 'TEST LABEL'

tag = 105 ; The annotation tag.

ref = 2 ; Choose a reference number.

HDF_DFAN_PUTLABEL, 'test.hdf', tag, ref, label
; Write the label.

HDF_DFAN_GETLABEL, 'test.hdf', tag, ref, outl
; Read the label back.

HELP, outl ; They look the same...

OUTL STRING = 'TEST LABEL'

HDF_CLOSE, fid ; Close the file.

See Also

HDF_DFAN_GETDESC , HDF_DFAN_LABLIST , HDF_DFAN_PUTDESC , HDF_DFAN_PUTLABEL