ToString
Description
Converts a value to a string.
Returns
A string.
Category
Conversion
functions,
Function syntax
ToString(any_value[, encoding])
See also
ToBase64,
ToBinary
History
ColdFusion MX:
•
Changed Unicode support: ColdFusion supports the Java UCS-2 representation of Unicode
character values 0–65535. (ColdFusion 5 and earlier releases supported ASCII values 1–255.)
•
Added the
encoding
Parameters
Parameter
any_value
encoding
Usage
This function can convert simple values and binary values that do not contain Byte zero. If this
function cannot convert a value, it throws an exception. This function can convert an XML
document object to a string representation.
Note: You can use this function to reverse Base64 encoding of a string. Convert the Base64
encoded object to a binary object, then use this function to convert the binary object to a string.
Other
functions,
attribute.
Description
Value to convert to a string
The character encoding (character set) of the string. The following list includes
commonly used values:
• utf-8
• iso-8859-1
• windows-1252
• us-ascii
• shift_jis
• iso-2022-jp
• euc-jp
• euc-kr
• big5
• euc-cn
• utf-16
For more information on character encoding, see:
www.w3.org/International/O-charset.html.
Default: the encoding of the page on which the function is called. See
on page
87.
String functions
cfcontent
ToString
725