ColdFusion MX 7 -- Using scopes -- Version 7

The following sections provide details on how you can create and use variables in different scopes.

Evaluating unscoped variables

If you use a variable name without a scope prefix, ColdFusion checks the scopes in the following order to find the variable:

Because ColdFusion must search for variables when you do not specify the scope, you can improve performance by specifying the scope for all variables.

To access variables in all other scopes, you must prefix the variable name with the scope identifier.

Scopes and CFX tags

ColdFusion scopes do not apply to ColdFusion Extension (CFX) tags, custom tags that you write in a programming language such as C++ or Java. The ColdFusion page that calls a CFX tag must use tag attributes to pass data to the CFX tag. The CFX tag must use the Java Request and Response interfaces or the C++ Request class to get and return data.

The Java setVariable Response interface method and C++ CCFX::SetVariable method return data to the Variables scope of the calling page. Therefore, they are equivalent to setting a Caller scope variable in a custom ColdFusion tag.

Using scopes as structures

ColdFusion makes all named scopes available as structures. You cannot access the function-local scope for user defined functions (UDFs) that you define using CFScript as a structure. (In ColdFusion 4.5 and 5, the following scopes are not available as structures: Variables, Caller, Client, and Server.)

You can reference the variables in named scopes as elements of a structure. To do so, specify the scope name as the structure name and the variable name as the key. For example, if you have a MyVar variable in the Request scope, you can refer to it in either of the following ways:

Similarly, you can use CFML structure functions to manipulate the contents of the scope. For more information on using structures, see Using Arrays and Structures.

Caution: Do not call StructClear(Session) to clear session variables. This deletes the SessionID, CFID, and CFtoken built-in variables, effectively ending the session. If you want to use StructClear to delete your application variables, put those variables in a structure in the Session scope, and then clear that structure. For example, put all your application variables in Session.MyVars and then call StructClear(Session.MyVars) to clear the variables.

Comments

deepu_verma said on Feb 15, 2005 at 12:58 AM :

If Cffile scope requires a prefix should this scope be in the Evaluating unscoped variables scope.

halL said on Feb 15, 2005 at 8:00 AM :

The cffile variable can be considered a scope as it does not reside in the variables scope, and it is possible to write user variables to it.
However, we treat it as a parameter returned by the cffile tag, also known as a tag-specific variable.
There are several other tag-specific variables, including cfftp, cfhttp, and cfcatch.
These variables are documented with the corresponding tag, and are listed in CFML Quick Reference and the ColdFusion tag-specific variables page of the CFML Reference, http://livedocs.macromedia.com/coldfusion/7/htmldocs/00000192.htm.

BL_CLEARROCK said on May 21, 2005 at 1:05 AM :

what about the "query" scope?

jrunrandy said on May 25, 2005 at 3:24 PM :

It's not really a scope. Think of it more like a result variable. This is also true for cffile and a few other CFML tags.