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