CFML Reference

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.

Return value

The new value of the variable.

Category

Dynamic evaluation functions

Syntax

SetVariable(name, value) 

See also

DE, Evaluate, IIf

Parameters

Parameter	Description
name	Variable name
value	A string, the name of a string, or a number

Usage

Before this function is called, the client variable must exist, and the cfapplication tag ClientManagement attribute must be set to "Yes".

Note:   If you concatenate string elements to form the name parameter, you can improve performance using the cfset tag, instead.

For example:

    <cfset "myVar#i#" = myVal>

is faster than:

    SetVariable("myVar" & i, myVal)

For more information, see Developing ColdFusion MX Applications with CFML.

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>

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments