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

VSsetattr/vsfsnat/vsfscat

intn VSsetattr(int32 vdata_id, int32 findex, char *attr_name, int32 data_type, int32 count, VOIDP *values)
vdata_id

IN:

Vdata identifier returned from VSattach

findex

IN:

Number determined by assigning each field in a record a number starting with 0

attr_name

IN:

Name of the attribute

data_type

IN:

Data type of the attribute

count

IN:

Number of attribute values

values

OUT:

Buffer containing the returned values of the attribute

Purpose

Sets an attribute of a vdata or the field of a vdata.

Return value

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

Description

If the field already has an attribute with the same name, the current values will be replaced with the new values if the new data type and order are the same as the current ones. Any changes in the field data type or order will result in an error condition.

An findex value of _HDF_VDATA (0xffffffff) represents the entire vdata.

FORTRAN

integer function vsfsnat(vdata_id, findex, attr_name, data_type, count, values)

integer vdata_id, findex, data_type, count, values

character* (*) attr_name

integer function vsfscat(vdata_id, findex, attr_name, data_type, count, values)

integer vdata_id, findex, data_type, count

character* (*) attr_name, values



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

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