cniAddAfter

Use this function to add an unattached syntax element after a specified syntax element. The currently unattached syntax element, and all child elements it possesses, is connected to the syntax element tree after the specified target element.

The added element becomes the next sibling of the target element. The target element must be attached to a tree (that is, it must have a parent element).

Syntax

void cniAddAfter(
int*         returnCode,
CciElement*  targetElement,
CciElement*  newElement);

Parameters

returnCode
The return code from the function (output).
Possible return codes are:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
The address of the target syntax element object (input).
newElement
The address of the new syntax element object that is to be added to the tree structure (input).

Return values

None. If an error occurs, the returnCode parameter indicates the reason for the error.