[Top]
[Prev]
[Next]
[Bottom]
DFSDgetdimstrs/dsgdist
intn DFSDgetdimstrs(intn
dim
, char *
label
, char *
unit
, char *
format
)
dim
IN:
Dimension this label, unit and format refer to
label
OUT:
Label that describes this dimension
unit
OUT:
Unit to be used with this dimension
format
OUT:
Format to be used in displaying scale for this dimension
Purpose
Retrieves the label, unit, and format attribute strings corresponding to the specified dimension.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
The space allocated for the label, unit, and format string must be at least one byte larger than the length of the string to accomodate the null termination . If the length is unknown when the program is written, declare the array size as 1+maxlen_label, maxlen_unit, or maxlen_format after they are set by
DFSDsetlengths
. The maximum default string length is 255.
FORTRAN
integer function dsgdist(dim, label, unit, format)
integer dim
character* (*) label, unit, format
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.