cpiAddBefore

Zweck

Diese Funktion fügt ein neues (und derzeit nicht zugeordnetes) Syntaxelement vor dem angegebenen Zielelement zur Syntaxelementstruktur hinzu. Das neu hinzugefügte Element wird das vorherige gleichgeordnete Element des Zielelements.

Syntax

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

void cpiSetElementValue(
  CciParser*       parser,
  CciElement*      element,
  CciElementValue* value
){
  CciElement* newElement;
  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, 2005 Letzte Aktualisierung: Nov 17, 2005
as08360_