ToString

Description

Attempts to convert a value of any type, including a binary value, into a string.

Syntax


ToString(any_value)

Parameters

Parameter

Description

any_value
The value to convert to a string

Parameter	Description
any_value	The value to convert to a string

Usage

If ToString cannot convert the value into a string, it throws an exception. Simple values can be converted into a string. Binary values that do not contain byte zero can be converted.

Note

You can use the ToString function to reverse the Base64 encoding of a string. First, convert the Base64 encoded object into a binary object, and then convert the binary object into a string using ToString.

Example

<!--- This example shows the use of ToBase64, ToBinary and ToString --->

<html>

<head>

<title>

ToString Example

</title>

</head>



<body bgcolor = silver>

<H3>ToString Example</H3>



<!---------------------------------------------------------------------

Initialize data.

---------------------------------------------------------------------->

<cfset charData = "">

<!---------------------------------------------------------------------

Create string of ASCII characters (32-255) and concatenate them.

---------------------------------------------------------------------->

<CFLOOP index = "data" from = "32" to = "255">

  <cfset ch = chr(data)>

  <cfset charData = charData & ch>

</CFLOOP>

<P>

The following string is the concatenation of characters (32 to 

255) from the ASCII table.<BR>

<cfoutput>#charData#</cfoutput>

</P>





<!--------------------------------------------------------------------

Create a Base64 representation of this string.

---------------------------------------------------------------------->

<cfset data64 = toBase64(#charData#)>

<P>

The following string is the Base64 representation of the 

original string.<BR>

<cfoutput>#data64#</cfoutput>

</P>

<!--------------------------------------------------------------------

Create a binary representation of Base64 data.

---------------------------------------------------------------------->

<cfset dataBinary = toBinary(data64)>



<!--------------------------------------------------------------------

Create the string repesentation of the binary data.

---------------------------------------------------------------------->

<cfset dataString = toString(dataBinary)>

<P>

The following is the string representation of the binary data.<BR>

<cfoutput>#dataString#</cfoutput>

</P>

</body>

</html>