TipcMsgNextXml

Name

TipcMsgNextXml — get the next XML string from a message

Synopsis

T_BOOL TipcMsgNextXml(msg, xml_return) 
T_IPC_MSG msg; 
T_XML xml_return; 

Arguments

msg — message from which to get the field

xml_return — storage for XML value from field

Return Values

TRUE if the field was successfully retried from the message, FALSE otherwise.

Diagnostics

If TipcMsgNextXml fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcMsgNextXml retrieves the value of the current field of a message, which must be an XML field. If TipcMsgNextXml succeeds, it advances the current field to the next field in the message.

Caution

If TipcmsgNextXml returns FALSE, it does not store a value in xml_return.

Do not modify the value stored in xml_return. It points directly into an internal data structure.

See Also

TipcMsgAppendXml; see the TIBCO SmartSockets Utilities for information on TutXmlCreate.

Examples

T_IPC_MT mt; 
T_IPC_MSG msg; 
T_XML xml, xml_val; 
 
T_XML xml_val; 
#define USER_MT_XML_TEST 100 
mt = TipcMtCreate("xml_test", USER_MT_XML_TEST, "xml"); 
if (mt == NULL) { 
return;  /* error */ 
} 
msg = TipcMsgCreate(mt); 
if (msg == NULL) { 
return;  /* error */ 
} 
xml = TutXmlCreate(“<data><data1><temp=\”hot\”/></data1></data>”); 
if (xml == NULL) { 
  return;  /* error */ 
} 
if (!TipcMsgAppendXml(msg, xml)) { 
return;  /* error */ 
} 
if (!TipcMsgSetCurrent(msg, 0)) { 
return;  /* error */ 
} 
if (!TipcMsgNextXml(msg, &xml_val)) { 
return;  /* error */ 
}