Variables

Learn Modern ColdFusion <CFML> in 100 Minutes
Printed Book Download Book Ortus Solutions
Search…
Variables
In CFML, variables are just pointers to a piece of data. They can hold any value you like and even change it's value or type at runtime. In some languages, you need to specify the type of data you want your variable to hold. In CFML, you do not need to assign one as everything is dynamic. The Lucee server even goes further and infers types according to the initial value you assign to your variable.
1
a = "string"; // string
2
b = now(); // data
3
c = 123; // integer
4
d = 1.34; // float
5
f = false; // boolean
Copied!
Please note that assignments are evaluated from right to left instead of traditional reading which is from left to right.
Open up the CommandBox Shell and go into REPL mode by typing repl. Every time you assign a value to a variable, the CommandBox REPL will output or echo the variable for you. Please note that in REPL mode the termination for a line of code is omitted. A line terminator in ColdFusion is the ;.
As you can see, we can create strings, numerics, arrays, structs and so much more. No need for types or special assignments.
The CommandBox REPL is based on a Lucee 5 server, that is why semi-colons are optional and the default syntax is script and not tags.
Case Insensitive
CFML is a case-insensitive language. Meaning if you create a variable a and reference it as A they are the same. This can be a very big gotcha for developers coming from languages like Java or JavaScript. However, as best practice, we would recommend to ALWAYS use the same case as when you define the variable:
Don't do this
1
a = "Hola Luis";
2
writeOutput( A );
Copied!
Do this
1
a = "Hola Luis";
2
writeOutput( a );
Copied!
Naming Requirements
Most CFML variables have a few requirements imposed by the Virtual Machine (VM)
Must begin with a letter, underscore, or Unicode currency symbol.
Can contain any number of letters, numbers, underscore characters, and Unicode currency symbols.
NO SPACES!
Not case-sensitive
Flexible Typing
You can also create a variable with one type and then switch it to another dynamically:
As you can see, the last equality wins! In this case, a is now an array.
Outputting Variables
You can also output or evaluate variables by using the # operators and using the variable name:
1
a = "Hola Luis";
2
writeoutput( "Welcome to CFML: #a#" );
Copied!
Also note that using the # hashes for output on assignments can be redundant:
Don't do this
1
a = "hello luis";
2
b = #a#;
3
or 
4
b = "#a#";
Copied!
Do this
1
a = "hello luis";
2
b = a;
Copied!
Debugging Variables
CFML offers one of the most used functions/tags ever: <cfdump>, writeDump() and <cfabort>, abort;. These are used to dump the entire contents of a variable to the browser, console or even a file. You can then leverage the abort construct to abort the request and see the output of your dumped variables. This will work with both simple and complex variables. However, be very careful when using it with Nested ORM objects as you can potentially dump your entire database and crash the server. Leverage the top argument to limit the dumping.
1
writeDump( complex );abort;
2
​
3
<cfdump var="#server#" abort=true>
4
​
5
writeDump( var=arrayOfORM, top=5 );abort;
Copied!
Server Debugging Templates
CFML Engines also allow you to turn on/off a debugging template that shows up at the bottom of requests when running in server mode. You can activate this debugging by logging in to the appropriate engine administrator and look for the debugging section. Turn it on and debug like a champ.
Important: Adobe Engines have a very evil setting called Report Execution Times, make sure it is always turned OFF. If you use it with any application that leverages Components, it will slow down your application tremendously.
Paraming Variables
CFML allows you to set default values for variables in case you use a variable and it doesn't exist. You can use the <cfparam> tag or the param construct:
1
<cfparam name="myVariable" default="luis">
Copied!
or
1
param myVariable = "luis";
Copied!
You can even assign types to parameterize variables and much more. Check out the docs for it: https://cfdocs.org/cfparam​
Checking For Existence
You can verify if variables exist in many different ways. The next section showcases how variables are stored in visibility and persistence scopes which are all structures or hash maps in Java terms. Meaning you can leverage structure operations for checking for existence and much more. Below are several ways to verify variable existence:
isDefined() - Evaluates a string value to determine whether the variable
named in it exists.
isNull() - Returns true if the specified object is null, else false.
structKeyExists( key, value ) - Verifies if the specified key variable exists in a structure.
1
// Notice the variable name is in quotes
2
if( isDefined( "myVariable" ) ){
3
    writeOutput( myVariable );
4
} else {
5
    writeOutput( "Not Defined!" );
6
}
7
​
8
// Notice that the variable is NOT in quotes
9
if( isNull( myVariable ) ){
10
    writeOutput( "Not Defined!" );
11
} else {
12
    writeOutput( myVariable );
13
}
14
​
15
// What is this variables scopes???
16
if( structKeyExists( variables, "myVariable" ) ){
17
    writeOutput( myVariable );
18
} else {
19
    writeOutput( "Not Defined!" );
20
}
Copied!
Java Integration
As we have discussed, CFML is a dynamic language built on-top of Java. Thus each variable internally is represented by a native Java data type: String, Int, Float, Array, Vector, HashMap, etc. This is important because each variable you create has member functions available to you that delegate or reflect back to its native Java class.
1
a = "hello";
2
writeOutput( a.getClass().getName() );
Copied!
If you run the script above in the REPL tool, you will see the output as java.lang.String. Therefore, the variable is typed as a String and can call on any method that java.lang.String implements. You can try this for the many types in CFML like structs, arrays, objects, etc.
CFML Member Functions
A part from the native Java member functions available to you, CFML also allows you to call on each variable's data type functions and chain them to create nice language DSLs. This way you do not have to be passing variables into functions, but instead treat the variables as objects. You can see all the member functions available according to data type here: https://cfdocs.org/member​
Here are some examples:
1
// Function passing
2
var myArray = [];
3
ArrayAppend( myArray, "objec_new" );
4
ArraySort( myArray, "ASC" );
5
​
6
// Member Functions
7
myArray.append( "objec_new" );
8
myArray.sort( "ASC" );
9
​
10
// Java Functions + CFML Functions
11
var myProductObject = createObject( "java", "myJavaclass" );
12
myjavaList = myProductObject.getProductList();
13
myjavaList.add( "newProduct" ); // Java API
14
​
15
myjavaList.append( "newProduct" ); // CF API
16
myjavaList.sort( "ASC" );
17
​
18
// DSL Chaining
19
s="the";
20
s = s.listAppend("quick brown fox", " ")
21
     .listAppend("jumps over the lazy dog", " ")
22
     .ucase()
23
     .reverse();
Copied!
Member functions for the following data types are supported:
Array
String
List
Struct
Date
Spreadsheet
XML
Query
Image
Please see https://cfdocs.org/member for further information on member functions.
Naming Coding Standards
At Ortus Solutions we have developed a set of development standards for many languages. You can find our ColdFusion standards here: https://github.com/Ortus-Solutions/coding-standards/blob/master/coldfusion.md​