[Back to Interface] [Prev] [Next]

Vinsert/vfinsrt

int32 Vinsert(int32 vgroup_id, int32 v_id)

vgroup_id IN:

Vgroup identifier returned by Vattach

v_id IN:

Identifier of the vdata or vgroup

Purpose

Inserts a vdata or vgroup into a vgroup.

Return value

Returns the position (index) of the inserted element within the vgroup if successful and FAIL (or -1) otherwise.

Description

Vinsert inserts the vdata or vgroup identified by the parameter v_id into the vgroup identified by the parameter vgroup_id.

Essentially, Vinsert only inserts a vgroup or vdata. To insert any objects into a vgroup, use Vaddtagref.

The returned value, index, is either 0 or a positive value, which indicates the position of the inserted element in the vgroup.

FORTRAN

integer function vfinsrt(vgroup_id, v_id)

integer vgroup_id, v_id



[Back to Interface] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF Reference Manual - 07/29/98, NCSA HDF Development Group.