[Back to Interface] [Prev] [Next]

VSsetname/vsfsnam

int32 VSsetname(int32 vdata_id, char *vdata_name)

vdata_id IN:

Vdata identifier returned by VSattach

vdata_name IN:

Name of the vdata

Purpose

Assigns a name to a vdata.

Return value

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

Description

VSsetname sets the name of the vdata identified by the parameter vdata_id to the value of the parameter vdata_name.

At creation, the name of the vdata is NULL. The name may be reset more than once. Vdata names, like class names, can be any character string. They exist solely as a meaningful label for user applications and are not used by the HDF library in any way. Vdata names will be truncated to VSNAMELENMAX (or 64) characters.

FORTRAN

integer function vsfsnam(vdata_id, vdata_name)

integer vdata_id

character*(*) vdata_name



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.