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

SDattrinfo/sfgainfo

intn SDattrinfo(int32 [file, sds, dim]_id, int32 attr_index, char *attr_name, int32 *data_type, int32 *count)
[file, sds, dim]_id

IN:

Identifier of the object the attribute is to be attached to: an file_id for a file, an sds_id for an SDS or a dim_id for a dimension

attr_index

IN:

Index of the attribute to read

attr_name

OUT:

Name assigned to the attribute/dataset/dimension

data_type

OUT:

Data type of the attribute values

count

OUT:

Total number of values in the specified attribute

Purpose

Retrieves information about a global or local attribute.

Return value

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

Description

This routine should be used before reading the value of an attribute with SDreadattr. SDreadattr requires a buffer to hold the values of the attribute. The size of this buffer should be at least count*DFKNTsize(data_type) bytes long.

FORTRAN

integer function sfgainfo([file, sds, dim]_id, attr_index, attr_name, data_type, count)

character* (*) attr_name

integer [file, sds, dim]_id, attr_index, data_type, count



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

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