cniParent

Returns the address of the syntax element object that is the parent of the specified syntax element.

Syntax

CciElement* cniParent(
  int*         returnCode,
  CciElement*  targetElement);

Parameters

returnCode
The return code from the function (output).
targetElement
The address of the target syntax element object (input).

Return values

  • If successful, the address of the requested syntax element is returned.
  • If there is no parent element, zero is returned.
  • If an error occurs, zero (CCI_NULL_ADDR) is returned, and the returnCode parameter indicates the reason for the error.

Related concepts
User-defined message processing nodes
User-defined output nodes

Related tasks
Creating a message processing node in C

Related reference
C language node utility functions
cniFirstChild
cniLastChild
cniNextSibling
cniPreviousSibling
cniRootElement
cniSearchElement group