[Back to Interface] [Prev] [Next]

Vattrinfo/vfainfo

intn Vattrinfo(int32 vgroup_id, intn attr_index, char *attr_name, int32 *data_type, int32 *count, int32 *size)

vgroup_id IN:

Vgroup identifier returned by Vattach

attr_index IN:

Index of the attribute

attr_name OUT:

Name of the attribute

data_type OUT:

Data type of the attribute

count OUT:

Number of values in the attribute

size OUT:

Size, in bytes, of the attribute values.

Purpose

Retrieves the name, data type, number of values, and value size of an attribute for a vgroup.

Return value

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

Description

Vattrinfo retrieves the name, datatype, number of values, and value size of an attribute identified by its index, attr_index, in the vgroup, vgroup_id. Name, data type, number of values and size are retrieved into the parameters attr_name, data_type, count, and size, respectively.

If the attribute's name, data type, number of values, or value size are not needed, the corresponding output parameters can be set to NULL.

The valid value attr_index range from 0 to the total number of attributes attached to a vgroup - 1. The number of vgroup attributes can be obtained using Vnattrs.

FORTRAN

integer function vfainfo(vgroup_id, attr_index, attr_name, data_type, count, size)

integer vgroup_id, attr_index, data_type, count, size

character*(*) attr_name



[Back to Interface] [Prev] [Next]

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