MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 694 / 1108

694 Chapter 3: ColdFusion Functions
IsXML
Description
Determines whether a string is well-formed XML text.
Returns
True, if the function parameter is a string that contains well-formed XML text; False, otherwise.
Category
Decision functions , XML functions
Function syntax
IsXML ( value )
See also
IsXmlAttribute
,
IsXmlDoc
,
IsXmlElem
,
IsXmlNode
,
IsXmlRoot
,
XmlParse
,
XmlValidate
;
Chapter 35, “Using XML and WDDX” in ColdFusion MX Developer’s Guide
History
ColdFusion MX 7: Added this function.
Parameters
Usage
This function determines whether text is well-formed XML, that is, it conforms to all XML
syntax and structuring rules. The string does not have to be a complete XML document. The
function does not validate against a Document Type Definition (DTD) or XML Schema.
Example
The following example creates two strings, and tests whether they are well-formed XML text:
<!--- A well formed XML string --->
<cfset xmlString1='<order id="4323251">
<customer firstname="Philip" lastname="Cramer" accountNum="21"/>
<items>
<item id="43">
<quantity>1</quantity>
<unitprice>15.95</unitprice>
</item>
</items>
</order>'
>
<!--- An invalid XML string, missing the </item> close tag --->
<cfset xmlString2='<order id="4323251">
<customer firstname="Philip" lastname="Cramer" accountNum="21"/>
<items>
Parameter Description
value A string containing the XML document text