[Back to Interface] [Prev] [Next]

DFANaddfid/daafid

intn DFANaddfid(int32 file_id, char *label)

file_id IN:

The file identifier returned by Hopen.

label IN:

A null-terminated string.

Purpose

Writes a file label to a file.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

These annotations are associated with the file, not with any particular object within the file. The label must be a single string. Use the general purpose routines Hopen and Hclose to manage file access because the file annotation routines will not open and close HDF files for you.

In the FORTRAN-77 version, the string length for the label should be close to the actual expected string length, because in FORTRAN-77 string lengths generally are assumed to be the declared length of the array that holds the string.

FORTRAN

integer function daafid(file_id, label)

integer file_id

character*(*) label



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.