XmlFormat

Description

Escapes special XML characters in a string, so that the string is safe to use with XML.

Return value

A copy of string that is safe to use with XML.

Syntax

XmlFormat(string)

History

New in ColdFusion MX: this function is new.

Parameters

Parameter Description

string
A string or a variable that contains one

Parameter	Description
string	A string or a variable that contains one

Usage

The characters that this function escapes include the following:

Greater than symbol (>)
Less than symbol (<)
Single quotation mark (')
Double quotation mark (")
Ampersand symbol (&)

Example

<h3>XMLFormat</h3>
<p>This example shows how XMLFormat is used to escape special 
XML characters and make the use of XML with ColdFusion easy.</p>
<XMP>
<?xml version = "1.0"?> 
<cfoutput>
<someXML>
  <someElement someAttribute = "#XMLFormat("'a quoted value'")#> 
    #XMLFormat(  "Body of element to be passed here.")#
  </someElement>
</someXML>  
</cfoutput>
</XMP>