[Top] [Prev] [Next] [Bottom]

SDfileinfo/sffinfo

intn SDfileinfo(int32 sd_id, int32 *ndatasets, int32 *nglobal_attr)
sd_id

IN:

SD interface identifier returned from SDstart

ndatasets

OUT:

Number of datasets in the file

nglobal_attr

OUT:

Number of global attributes in the file

Purpose

Determines the number of datasets and global attributes in a file.

Return value

Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise.

Description

SDfileinfo returns the number of currently defined datasets and global attributes in the file. "Global attributes" refer to attributes assigned to the file as opposed to "local attributes" which are assigned to specific datasets. For example, "file_creator_date" would be a global attribute, while "units" would typically be dataset-specific. Global attributes are created by SDsetattr using the sd_id rather than an sds_id.

FORTRAN

integer function sffinfo(sd_id, ndatasets, nglobal_attr)

integer sd_id, ndatasets, nglobal_attr



[Top] [Prev] [Next] [Bottom]

hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.