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