[Top]
[Prev]
[Next]
[Bottom]
VHmakegroup/vhfmkgp
int32 VHmakegroup(int32
file_id
, int32
tag_array
[], int32
ref_array
[], int32
n_objects
, char *
vgroup_name
, char *
vgroup_class
)
file_id
IN:
File identifier returned by
Hopen
tag_array
IN:
Array of tags to be stored
ref_array
IN:
Array of reference numbers to be stored
n_objects
IN:
Number of data objects to be stored
vgroup_name
IN:
Name of the vgroup to be created
vgroup_class
IN:
Class of the vgroup to be created
Purpose
Groups a collection of data objects within a vgroup.
Return value
Reference number of newly-created vgroup if successful, FAIL (or -1) otherwise.
Description
This routine creates a new vgroup named
vgroup_name
of class
vgroup_class
in the HDF file specified by
file_id
. The
tag_array
and
ref_array
are matched arrays of
n_objects
containing the tags and reference numbers to be added to the new vgroup. A matched array in this case means that
tag_array
[0] and
ref_array
[0] refer to one data object, and
tag_array
[1] and
ref_array
[1] to another, etc.
Because
Vstart
initializes the VH interface, it must precede calls to
VHmakegroup
. It is not necessary, however, to call
Vattach
or
Vdetach
in conjunction with
VHmakegroup
.
FORTRAN
integer function vhfmkgp(file_id, tag_array, ref_array, n_objects, vgroup_name, vgroup_class)
integer file_id, n_objects
character* (*) vgroup_name, vgroup_class
integer tag_array(*), ref_array(*)
[Top]
[Prev]
[Next]
[Bottom]
hdfhelp@ncsa.uiuc.edu
HDF User's Reference Manual, Draft 06/09/97, NCSA HDF Development Group.