cpiAddAsFirstChild

Zweck

Fügt der Syntaxelementbaumstruktur ein neues (und derzeit noch nicht angehängtes) Syntaxelement als erstes untergeordnetes Element des angegebenen Zielelements hinzu.

Syntax

void cpiAddAsFirstChild(
  int*         Rückkehrcode,
  CciElement*  Zielelement,
  CciElement*  neues Element);

Parameter

Rückkehrcode
Empfängt den Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
Zielelement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
neues Element
Gibt die Adresse des neuen Syntaxelementobjekts an, die zur Baumstruktur hinzugefügt werden muss (Eingabe).

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Rückkehrcode den Grund für den Fehler an.

Beispielprogramm

Dieses Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c (Zeile 675 bis 698):

void cpiSetElementValue(
  CciParser*       Parser,
  CciElement*      Element,
  CciElementValue* Wert
){
  CciElement* neues Element;
  int         rc;

  if ((cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_VALUE) ||
      (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME_VALUE))  {
    cpiSetElementValueValue(&rc, element, value);
  }
  else if (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME) {
    /* Erstellen Sie ein neues Wertelement, fügen Sie es als erstes untergeordnetes Element hinzu, und legen Sie den Wert fest */
    newElement = cpiCreateElement(&rc, parser);
    cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_VALUE);
    cpiSetElementValueValue(&rc, newElement, value);
    cpiAddAsFirstChild(&rc, element, newElement);
  }
  else {
  }

  return;
}
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiAddAsLastChild
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08370_