C: ref_num = Vgetnext(vgroup_id, v_ref);
FORTRAN: ref_num = vfgnxt(vgroup_id, v_ref)Vgetnext searches the vgroup, identified by the parameter
vgroup_id
, for the vgroup or vdata whose reference number is specified by the parameter v_ref
. If this vgroup or vdata is found, Vgetnext finds the next vgroup or vdata and returns its reference number. If v_ref
is set to -1
, the routine will return the reference number of the first vgroup or vdata in the vgroup.Vgetnext is now obsolete as the routine Vgettagref provides the same functionality. In addition, Vgettagref is not restricted to searching for members that are vgroups or vdatas.
Vgetnext returns a reference number if the next vgroup or vdata is found, or FAIL
(or -1
) when an error occurs or when there are no more vdatas or vgroups in the vgroup. The parameters of Vgetnext are further defined in Table 5N.
vgroup_id
. The syntax for Vinquire is as follows:C: status = Vinquire(vgroup_id, &n_members, vgroup_name);
FORTRAN: status = vfinq(vgroup_id, n_members, vgroup_name)Vinquire stores the number of data objects and the vgroup name in the parameters
n_members
and vgroup_name
, respectively. In C, if either n_members
or vgroup_name
is set to NULL
, the corresponding data is not returned. The maximum length of the vgroup's name is defined by VGNAMELENMAX
(or 64
). Vinquire is now obsolete as the Vntagrefs routine can be used to get the number of data objects in a vgroup and Vgetname can be used to retrieve the name of a vgroup.
Vinquire returns either SUCCEED
(or 0
) or FAIL
(or -1
). The parameters of this routines are further defined in Table 5N.