[Top]
[Prev]
[Next]
[Bottom]
SDselect/sfselect
int32 SDselect(int32
sd_id
, int32
sds_index
)
sd_id
IN:
SD interface identifier returned from
SDstart
sds_index
IN:
Index of the dataset
Purpose
Retrieves the
sds_id
for the given dataset.
Return value
Returns the
sds_id
if successful and FAIL (or -1) otherwise.
Description
To get an
sds_id
for the Nth dataset, use N-1 as the index. N must be a number greater than or equal to 0 and less than the total number of datasets in the file. The total number of datasets in a file may be obtained from a call to
SDfileinfo
. The function
SDnametoindex
can be used to find the index of a dataset if its name is known.
The integration with netCDF has required that dimension metadata be stored as "coordinate variables." This sometimes causes problems when calling
SDselect
as the coordinate variables can lead to different dataset ordering than is expected. In situations such as these, users should use the routine
SDiscoordvar
to determine if a given dataset is a coordinate variable or not.
FORTRAN
integer function sfselect(sd_id, sds_index)
integer sd_id, sds_index
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.