cpiSetElementValue

Zweck

Optionale Funktion zum Festlegen des Werts eines angegebenen Elements. Sie wird vom Broker aufgerufen, wenn der Wert eines Syntaxelements festgelegt werden soll. Sie bietet einem Plug-in-Parser die Möglichkeit, das Verhalten beim Festlegen von Elementwerten außer Kraft zu setzen.

Definiert in Typ Mitglied
CPI_VFT Optional iFpSetElementValue

Syntax

void cpiSetElementValue(
  CciParser*        parser,
  CciElement*       currentElement,
  CciElementValue*  value);

Parameter

parser
Die Adresse des Parser-Objekts (Eingabe).
currentElement
Die Adresse des aktuellen Syntaxelements (Eingabe).
value
Der Wert (Eingabe).

Rückgabewerte

Keine.

Beispiel

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

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) {
    /* Create a new value element, add as a first child, and set the value */
    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
cpiElementValue
C-Parser-Implementierungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as08190_