cpiAddBefore

Zweck

Fügt der Syntaxelementbaumstruktur vor dem angegebenen Zielelement ein neues (und derzeit noch nicht angehängtes) Syntaxelement hinzu. Das neu angehängte Element wird das vorherige gleichgeordnete Element des Zielelements.

Syntax

void cpiAddBefore(
  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

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 vor dem aktuellen Wertelement ein,
			und legen Sie den Wert fest */
    newElement = cpiCreateElement(&rc, parser);
    cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_VALUE);
    cpiSetElementValueValue(&rc, newElement, value);
    cpiAddBefore(&rc, element, newElement);
  }
  else {
  }

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