[Back to Interface] [Prev] [Next]

SDnametoindex/sfn2index

int32 SDnametoindex(int32 sd_id, char *sds_name)

sd_id IN:

SD interface identifier returned by SDstart

sds_name IN:

Name of the data set

Purpose

Determines the index of a data set given its name.

Return value

Returns the index of the data set (sds_index) if the data set is found and FAIL (or -1) otherwise.

Description

SDnametoindex returns the index of the data set with the name specified by the parameter sds_name. The routine does not accept wildcards in the specified data set name. It also searches on that name in a case-sensitive manner. If there are more than one data set with the same name, the routine will return the index of the first one.

FORTRAN

integer function sfn2index(sd_id, sds_name)

integer sd_id

character*(*) sds_name



[Back to Interface] [Prev] [Next]

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