vgroup_id
from the file identified by the parameter file_id
. The syntax of Vdelete is as follows:
C: status = Vdelete(file_id, vgroup_id);
FORTRAN: status = vdelete(file_id, vgroup_id)This routine will remove the vgroup from the internal data structures and from the file.
Vdelete returns either
SUCCEED
(or 0
) or FAIL
(or -1
). The parameters of Vdelete are further described in Table 5K on page 203.
5.7.2 Deleting a Data Object from a Vgroup: Vdeletetagref
Vdeletetagref deletes the data object, specified by the parameters obj_tag
and obj_ref
, from the vgroup, identified by the parameter vgroup_id
. The syntax of Vdeletetagref is as follows:C: status = Vdeletetagref(vgroup_id, obj_tag, obj_ref);
FORTRAN: status = vfdtr(vgroup_id, obj_tag, obj_ref)
Vinqtagref should be used to determine whether the tag/reference number pair exists before calling Vdeletetagref. If duplicate tag/reference number pairs are found in the vgroup, Vdeletetagref deletes the first occurrence. Vinqtagref should also be used to determine whether duplicate tag/reference number pairs exist in the vgroup.SUCCEED
(or 0
) or FAIL
(or -1
). The parameters of this routine are further described in Table 5K.
TABLE 5K - Vdelete and Vdeletetagref Parameter Lists