[Top]
[Prev]
[Next]
[Bottom]
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
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.