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

VSgetattr/vsfgnat/vsfgcat

intn VSgetattr(int32 vdata_id, int32 field_index, int32 attr_index, VOIDP values)
vdata_id

IN:

Vdata identifier returned from VSattach

field_index

IN:

Index of the target field

attr_index

IN:

Index of the target attribute

values

OUT:

Buffer containing the attribute values

Purpose

Returns the values of the specified attribute of the specified vdata field or vdata.

Return value

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

Description

The attr_index parameter is the ordinal, zero-based (as with field_index in VSsetattr and this routine) index of the target attribute.

If field_index is set to _HDF_ENTIRE_VDATA, the value of the attribute attached to the vdata referred to by the value of vdata_id is returned. 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 attribute located at the ordinal position specified by attr_index will be returned.

FORTRAN

integer function vsfgnat(vdata_id, field_index, attr_index, values)

integer vdata_id, field_index, attr_index

<valid numeric data type> values(*)

integer function vsfgcat(vdata_id, field_index, attr_index, values)

integer vdata_id, n_records, interlace

character* (*) values



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

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