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

SDgetinfo/sfginfo

intn SDgetinfo(int32 sds_id, char *sds_name, int32 *rank, int32 dimsizes[], int32 *data_type, int32 *nattrs)
sds_id

IN:

Dataset identifier returned from SDselect

sds_name

OUT:

Buffer for the name, if any, of the dataset

rank

OUT:

Buffer for the number of dimensions in the dataset

dimsizes

OUT:

Buffer for the size of each dimension in the dataset

data_type

OUT:

Buffer for the data type for the data stored in the dataset

nattrs

OUT:

Buffer for the number of "netCDF-style" attributes for this dataset

Purpose

Retrieves the name, rank, dimension sizes, data type and attribute count for the specified dataset.

Return value

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

Description

Returns basic information about a given dataset. All fields must be provided. The dataset name can be at most MAX_NC_NAME characters long and the rank of the dataset is limited to MAX_VAR_DIMS.

In the case of unlimited dimensions, the dimsizes[0] argument returns the number of records in the dimension

FORTRAN

integer function sfginfo(sds_id, sds_name, rank, dimsizes, data_type, nattrs)

character* (*) sds_name

integer sds_id, rank, dimsizes(*)

integer data_type, nattrs



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

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