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 benutzerdefinierten 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 Parserobjekts (Eingabe).
currentElement
Die Adresse des aktuellen Syntaxelements (Eingabe).
value
Der Wert (Eingabe).

Rückgabewerte

Keine.

Beispielprogramm

Dieses Beispiel stammt aus der Beispiel-Parserdatei BipSampPluginParser.c (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, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08190_