[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.