|
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. |