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