cniAddBefore

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

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

Syntax

void cniAddBefore(
  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.