[Back to Interface] [Prev] [Next]

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



[Back to Interface] [Prev] [Next]

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