ToBinary

Description

Returns the binary representation of Base64 encoded data.

Syntax


ToBinary(string_in_Base64 or binary_value)

Parameters

Parameter

Description

string_in_Base64 or binary_value
String in Base64 to convert to binary or binary value to test to ensure that it is an acceptable binary value.

Parameter	Description
string_in_Base64 or binary_value	String in Base64 to convert to binary or binary value to test to ensure that it is an acceptable binary value.

Usage

Base64 provides 6 bit encoding of 8-bit ASCII characters. If you receive data in Base64, you can re-create the actual binary object that it represents, such as a .gif, .jpeg, or executable file, with the ToBinary function.

Example

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

<html>

<head>

<title>

ToBinary Example

</title>

</head>



<BASEFONT FACE = "Arial, Helvetica" SIZE = 2>

<body bgcolor = "#FFFFD5">



<H3>ToBinary Example</H3>



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

Initialize data.

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

<cfset charData = "">

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

Create a string of all ASCII characters (32-255) and 

concatenate them together.

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

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

  <cfset ch = chr(data)>

  <cfset charData = charData & ch>

</CFLOOP>

<P>

The following string is the concatenation of all characters (32 to 255)

from the ASCII table.<BR>

<cfoutput>#charData#</cfoutput>

</P>



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

Create a Base64 representation of this string.

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

<cfset data64 = toBase64(charData)>



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

Convert string to binary.

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

<cfset binaryData = toBinary(data64)>

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

Convert binary back to Base64.

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

<cfset another64 = toBase64(binaryData)>

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

Compare another64 with data64 to ensure that they are equal.

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

<cfif another64 eq data64>

  <H3>Base64 representation of binary data is identical to the Base64 

  representation of string data.</H3>

<cfelse>

  <H3>Conversion error.</H3>

</cfif>

</body>

</html>