Previous Scientific Data Formats: Hierarchical Data Format Next

HDF_DFAN_ADDFID

Syntax | Arguments | Keywords | Examples | Version History

The HDF_DFAN_ADDFID procedure adds a file annotation to an HDF file. A file can have multiple annotations added.

Syntax

HDF_DFAN_ADDFID, Filename, Label

Arguments

Filename

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

Label

A string containing the annotation string.

Keywords

None

Examples

; Open the HDF file:  
filename = 'FID.hdf'  
hid = HDF_OPEN(filename,/CREATE)  
; Write two file annotations:  
HDF_DFAN_ADDFID, filename, 'File Annotation #1'  
HDF_DFAN_ADDFID, filename, 'File Annotation #2'  
; Read the two annotations back:  
HDF_DFAN_GETFID, filename, fid1  
HDF_DFAN_GETFID, filename, fid2  
HELP, fid1, fid2  
; Try to read a non-existent FID:  
HDF_DFAN_GETFID, filename, fid3  
; Read the FIRST fid again, using the FIRST keyword:  
HDF_DFAN_GETFID, filename, fid4, /FIRST  
HELP, fid4  
; Close the HDF file:  
HDF_CLOSE, hid  
IDL Output
FID1            STRING    = 'File Annotation #1'  
FID2            STRING    = 'File Annotation #2'  
  
% HDF_DFAN_GETFID: Could not read ID length  
  
FID4            STRING    = 'File Annotation #1'  

Version History

4.0
Introduced

  IDL Online Help (March 06, 2007)