HDF_DFAN_PUTLABEL

The HDF_DFAN_PUTLABEL procedure writes a label for the given tag and reference number in an HDF file.

Known Issues

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 
; Specify tag and reference numbers: 
tag = 105 & ref = 40 
; Make label "XXXX": 
HDF_DFAN_PUTLABEL, file, tag, ref, 'XXXX' 
; Label now "YY": 
HDF_DFAN_PUTLABEL, file, tag, ref, 'YY' 
; Delete the file: 
OPENU, unit, file, /DELETE, /GET & CLOSE, unit 
; Now try to re-use label "XXXX": 
HDF_DFAN_PUTLABEL, file, tag, ref, 'XXXX' 

IDL Output

% HDF_DFAN_PUTLABEL: Failed to write label 
% Execution halted at:  $MAIN$  

Syntax

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.

Keywords

None.

Version History

Introduced: 4.0