Whatever message this page gives is out now! Go check it out!
XmlFormat
Last update:
May 18, 2026
Note: Adobe recommends that you use the EncodeForXML function, not the XmlFormat function, to escape special characters in a string for use in XML in all new applications.
Description
Escapes special XML characters in a string so that the string can be used as text in XML.
Returns
A copy of the string parameter that is safe to use as text in XML.
Category
Function syntax
XmlFormat(string, escapeChars)See also
History
ColdFusion MX: Added this function.
Parameters
Parameter | Description |
string | A string or a variable that contains one |
escapeChars | Set to true to escape the characters restricted as per XML standards. For details, see http://www.w3.org/TR/2006/REC-xml11-20060816/#NT-RestrictedChar. |
Usage
This function escapes characters as follows:
Text character | Escaped representation |
Greater than symbol (>) | > |
Less than symbol (<) | < |
Single-quotation mark (') | ' |
Double-quotation mark (") | " |
Ampersand symbol (&) | & |
Carriage return (but not line feed) | Removed from the text. |
High ASCII characters in the range 159-255. | Replaced by unicode escape sequence; for example, (capital E with an Acute symbol) is replaced by É. |
Example
The following example shows how XmlFormat escapes special XML characters. Use the View Source command in the browser to see the results. ColdFusion interprets the "" in the second text string as representing a single-quotation mark in text before it applies the XmlFormat function.
<?xml version = "1.0"?>
<cfoutput>
<someXML>
<someElement someAttribute="#XmlFormat("'a quoted value'", "true")#">
#XmlFormat("Body of element with <, >, "" and & goes here.", "true")#
</someElement>
</someXML>
</cfoutput>
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
