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

VSfindattr/vsffdat

intn VSfindattr(int32 vdata_id, int32 field_index, char *attr_name)
vdata_id

IN:

Vdata identifier returned from VSattach

field_index

IN:

Index of the target field

attr_name

OUT:

Name of the target attribute

Purpose

Returns the index of an attribute with the specified name.

Return value

Returns the index of the target attribute if successful and FAIL (or -1) otherwise.

Description

The attribute must to attached to the vdata identified by the the specified vdata identifier. If field_index is set to _HDF_ENTIRE_VDATA, the index of the attribute attached to the vdata referred to by the value of vdata_id is returned. When using the Fortran-77 version of this routine, specify a field_index value of -1 to return the vdata attribute indices.

As with VSsetattr, if field_index is set to a zero-based integer value, the value will be used as the index of the target vdata field, and the index of the attribute with the name specifiedby the attr_name parameter will be returned.

FORTRAN

integer function vsffdat(vdata_id, field_index, attr_name)

integer vdata_id, field_index

character* (*) attr_name



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

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