[Top]
[Prev]
[Next]
[Bottom]
SDgetdatastrs/sfgdtstr
intn SDgetdatastrs(int32
sds_id
, char *
label
, char *
unit
, char *
format
, char *
coordsys
, intn
len
)
sds_id
IN:
Dataset identifier returned from
SDselect
label
OUT:
Label describing the data
unit
OUT:
Unit to be used with the data
format
OUT:
Format to be used in displaying data
coordsys
OUT:
Coordinate system to be used with the data
len
IN:
Maximum length string it is safe to return
Purpose
Returns the data strings associated with the specified dataset.
Return value
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.
Description
SDgetdatastrs
returns the data strings stored by
SDsetdatastrs
. If a particular string was not stored the first character of the return string will be '\0'. Each string buffer is assumed to be at least
len
characters long including the space to hold the '\0' string termination character. If a user does not want a string back, NULL can be passed for any of the string values.
FORTRAN
integer function sfgdtstr(sds_id, label, unit, format, coordsys, len)
integer sds_id, len
character* (*) label, unit, format, coordsys
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.