Diese Funktion fügt der Syntaxelement-Baumstruktur ein neues (und derzeit noch nicht angehängtes) Syntaxelement als letztes untergeordnetes Element des angegebenen Zielelements hinzu.
void cpiAddAsLastChild(
int* returnCode,
CciElement* targetElement,
CciElement* newElement);
Keine. Wenn ein Fehler auftritt, gibt returnCode den Grund für den Fehler an.
Das folgende Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c:
/* Attributwert in Brokerform konvertieren */
data = CciNString((char *)startMarker, markedSize, pc->iCcsid);
/* Neues Name/Wert-Element für das Attribut erstellen */
newElement = cpiCreateElement(&rc, parser);
cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
cpiSetElementName(&rc, newElement, data);
/* In CciNString() erstellen Speicherplatz freigeben */
free((void *)data);
/* Element hinzufügen */
cpiAddAsLastChild(&rc, element, newElement);