This function returns the address of the syntax element object that is the first child of the specified target element.
CciElement* cpiFirstChild(
int* returnCode,
const CciElement* targetElement);
The address of the requested syntax element object is returned, unless there is no child in which case zero is returned. If an error occurs, zero (CCI_NULL_ADDR) is returned and returnCode indicates the reason for the error.
This example is taken from the sample node file BipSampPluginParser.c:
while ((!cpiElementCompleteNext(&rc, element)) &&
(!cpiFirstChild(&rc, element)) &&
(pc->iCurrentElement))