%XML_STRING_APPEND

Append a Synergy alpha string to an XML string

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
status = %XML_STRING_APPEND(xml_string, synergy_string[, length])

Return value

status

XML_SUCCESS if the string was appended successfully.

Arguments

xml_string

The XML string instance to which the Synergy string will be appended. (XML_STRING_TYPE)

synergy_string

The Synergy string to append to the XML string. (a)

length

(optional) The length of the Synergy string. (n)

Discussion

When you call %XML_STRING_APPEND, a copy of the Synergy string data is added to the end of the specified XML string. You can use %XML_STRING_APPEND to append a Synergy alpha string to an XML string created with %XML_STRING_CREATE.

This function is defined as ^VAL.

Examples

Assuming we have the following:

string1         ,a3 
xmlstring       ,XML_STRING_TYPE

xmlstring = %xml_string_create 
xcall xml_string_append(xmlstring, "hey ") 
string1 = "you" 
xcall xml_string_append(xmlstring, string1)

the contents of xmlstring become “hey you”.