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.
5.9.2 Determining the Number of Members and Vgroup Name: Vinquire
Vinquire retrieves the number of data objects and the name of the vgroup identified by the parameter 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
). SUCCEED
(or 0
) or FAIL
(or -1
). The parameters of this routines are further defined in Table 5N.
TABLE 5N - Vgetnext and Vinquire Parameter Lists