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