|
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) |