User Guide

680 Chapter 3: ColdFusion Functions
SetVariable
Description
This function is no longer required in well-formed ColdFusion pages.
Sets a variable in the
name parameter to the value of the value parameter.
Returns
The new value of the variable.
Category
Dynamic evaluation functions
Function syntax
SetVariable(name, value)
See also
DE, Evaluate, IIf
Parameters
Usage
Before this function is called, the client variable must exist, and the cfapplication tag
ClientManagement attribute must be set to "Yes".
You can use direct assignment statements in place of this function to set values of dynamically
named variables. To do so, put the dynamically named variable in quotation marks and pound
signs (#); for example:
<cfset DynamicVar2 = "ABD">
<cfset "#DynamicVar2#" = "Test Value2">
Also, the following lines are equivalent:
<cfset "myVar#i#" = myVal>
SetVariable("myVar" & i, myVal)
For more information, see Chapter 4, “Using Expressions and Pound Signs,” in Developing
ColdFusion MX Applications.
Example
<h3>SetVariable Example</h3>
<cfif IsDefined("FORM.myVariable")>
<!--- strip out url, client., cgi., session., caller. --->
<!--- This example only lets you set form variables --->
<cfset myName = ReplaceList(FORM.myVariable,
"url,client,cgi,session,caller", "FORM,FORM,FORM,FORM,FORM")>
<cfset temp = SetVariable(myName, FORM.myValue)>
<cfset varName = myName>
<cfset varNameValue = Evaluate(myName)>
<cfoutput>
Parameter Description
name Variable name
value A string, the name of a string, or a number