cpiAddAsLastChild

Zweck

Diese Funktion fügt ein neues (und derzeit nicht zugeordnetes) Syntaxelement als letztes untergeordnetes Element des angegebenen Zielelements zur Syntaxelementstruktur hinzu.

Syntax

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

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
newElement
Gibt die Adresse des neuen Syntaxelementobjekts an, das der Baumstruktur hinzugefügt werden soll (Eingabe).

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt returnCode die Fehlerursache an.

Beispiel

Dieses Beispiel wurde aus der Parser-Beispieldatei BipSampPluginParser.c entnommen (Zeile 209 bis 228):

/* Attributwert in Brokerform konvertieren */
data = CciNString((char *)startMarker, markedSize, pc->iCcsid);
/* Neues Namenswert-Element für das Attribut erstellen */
newElement = cpiCreateElement(&rc, parser);
cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
cpiSetElementName(&rc, newElement, data);
/* Geben Sie den in 'CciNString()' erstellten Speicherplatz frei */
free((void *)data);
/* Element hinzufügen */
cpiAddAsLastChild(&rc, element, newElement);
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiAddAsFirstChild
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08380_