Whatever message this page gives is out now! Go check it out!
ToString
Last update:
May 18, 2026
Description
Converts a value to a string.
Returns
A string.
Category
Function syntax
ToString(value[, encoding]) |
See also
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 parameter.
- Added ability to convert an XML document object to a string.
Parameters
Parameter | Description |
value | Value to convert to a string; can be a simple value such as an integer, a binary object, or an XML document object. |
encoding | The character encoding (character set) of the string. Optional for binary data, Generates an error if used for a simple value or XML document object.The following list includes commonly used values:
For more information on character encoding, see: www.w3.org/International/O-charset.en.html. The default value is the encoding of the page on which the function is called. See cfcontent. |
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 also convert an XML document object to a string XML representation.Adobe recommends that you use the CharsetEncode function to convert binary data to a string.
Example
<cfscript>
myString="Hello ColdFusion, how are you?"
base64Value = toBase64(myString)
binaryValue = toBinary(base64Value)
stringValue = toString(binaryValue);
writeOutput(stringValue);
</cfscript>
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
|
