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

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 number 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 "Using Expressions and Number Signs" in the ColdFusion Developer's Guide.

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>
    <p>Your variable, #varName#
    <p>The value of #varName# is #varNameValue#
</cfoutput>
</cfif>