[Back to Interface] [Prev] [Next]

VSgetfields/vsfgfld

int32 VSgetfields(int32 vdata_id, char *field_name_list)

vdata_id IN:

Vdata identifier returned by VSattach

field_name_list OUT:

Field name list

Purpose

Retrieves the field names of all of the fields in a vdata.

Return value

Returns the number of fields in the vdata if successful and FAIL (or -1) otherwise.

Description

VSgetfields retrieves the names of the fields in the vdata identified by the parameter vdata_id into the buffer field_name_list.

The parameter field_name_list is a character string containing a comma-separated list of names (e.g., "PX,PY,PZ" in C or `PX,PY,PZ' in Fortran).

The user must allocate the memory space for the buffer vdata_name before calling VSgetfields. If the vdata does not have a name, a null string is returned in the parameter vdata_name . The maximum length of a vdata name is defined by VSNAMELENMAX (or 64)

FORTRAN

integer function vsfgfld(vdata_id, field_name_list)

integer vdata_id

character*(*) field_name_list



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 05/19/99, NCSA HDF Development Group.