HDF_DFAN_PUTLABEL

The HDF_DFAN_PUTLABEL procedure writes a label for the given tag and reference number in a Hierarchical Data Format file.

Calling Sequence

HDF_DFAN_PUTLABEL, Filename, Tag, Ref, Label

Arguments

Filename

A scalar string containing the name of the file to be written.

Tag

The tag number.

Ref

The reference number.

Label

A string containing the description to write.

Bugs

Due to a problem in the HDF version 4.0 library, attempting to rewrite a label fails. For example:

file = 'blah.hdf' ; Specify a file.

tag = 105 & ref = 40 ; Specify tag and ref numbers.

HDF_DFAN_PUTLABEL, file, tag, ref, 'XXXX' ; Make label "XXXX"

HDF_DFAN_PUTLABEL, file, tag, ref, 'YY' ; Label now "YY"

The following command deletes the file:

OPENU, unit, file, /DELETE, /GET & CLOSE, unit

Now try to re-use label "XXXX":

HDF_DFAN_PUTLABEL, file, tag, ref, 'XXXX'

IDL prints:

% HDF_DFAN_PUTLABEL: Failed to write label

% Execution halted at: $MAIN$