WebSphere Message Broker, Version 8.0.0.7
Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS
See information about the latest product version
See information about the latest product version
cpiSetElementValue
This optional function sets the value of a specified element.
It called by the broker when the value of a syntax element is to be set. It provides an opportunity for a user-defined parser to override the behavior for setting element values.
Defined In | Type | Member |
---|---|---|
CPI_VFT | Optional | iFpSetElementValue |
Syntax
void cpiSetElementValue(
CciParser* parser,
CciElement* currentElement,
CciElementValue* value);
Parameters
- parser
- The address of the parser object (input).
- currentElement
- The address of the current syntax element (input).
- value
- The value (input).
Return values
None.
Sample
This example is taken from the sample parser file BipSampPluginParser.c:
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;
}