Language enhancements

In Adobe ColdFusion (2016 release), the language enhancements that have been introduced are safe navigation operator (“?.”) and collections support along with some other minor enhancements. 

Safe navigation (?.)

You can use the safe navigation operator to access members of a Struct or values of an object.

Instead of ".", using the safe operator ensures that exception is not thrown when the variable is not defined.

Sample usage - 1

This code does not throw exception even if variable employee is not defined. If employee is defined, then it works like a dot operator.

Simple usage

Chaining

writeOutput(employee?.name?.firstname?.trim());

The above code does not output any value if any of the following is undefined/null:
employee OR
employee.name OR
employee.name.firstname.

writeOuptut(employee?.name.firstname.trim());

This code throws an exception if employee is defined but employee.name is undefined.

Sample usage - 2

Current code

<cffunction name="employee">

    <cfreturn >

</cffunction>

<cfoutput>#employee()#</cfoutput>  //prints empty string(default behavior)

<cfoutput>#employee().trim()#</cfoutput> //throws error - Value must be initialized before use

Safe Navigation Operator code

<cffunction name="employee">

    <cfreturn >

</cffunction>

<cfoutput>#employee()?.trim()#</cfoutput>  //Does not print any output

Scope search

Generally, a referenced variable is searched in various scopes before a match is found. In cases where a variable is not found in common scopes like function, local scope, and variable scopes, the search continues in implicit scopes, which can take a while. Implicit scope search can be disabled by using a new application setting called searchImplicitScopes in Application.cfc. It accepts a boolean value.

When set to false, an unscoped variable is not searched in implicit scopes and helps to find variables defined in the application faster.

For more information, see ColdFusion application variables.

Collection support (Ordered)

StructNew("Ordered") creates a struct that maintains insertion order.

All other ways of creating struct make normal struct without breaking backward compatibility.

Currently, keys are fetched in random order while looping over the struct. But, when you loop over the struct using StructNew(“Ordered”), keys are fetched according to the insertion order.

All other properties and functions work as a normal struct.

Example

Literal syntax

In the 2016 release of ColdFusion, you can create an empty ordered structure implicitly, as in the following example:

<cfset myStruct = [:]> OR <cfset myStruct = [=]>

The following example shows how to create struct from literal syntax:

departments = [Marketing = "John", Sales : [Executive : "Tom", Assistant = "Mike"]];

Arrays

Pass by reference

By default, arrays are passed by value, which is slower as compared to passing arrays by reference. You can now choose to pass arrays by reference by using a new application setting called passArrayByReference. It accepts a boolean value.

When set to true, if an array is passed as a UDF argument, it is passed by reference.

Whitespace management

Adobe ColdFusion (2016 release) has a new way of managing whitespaces. In the administrator, the server level setting that used to suppress whitespaces at runtime can suppress them now at compile time.

Other enhancements

Adobe ColdFusion (2016 release) includes the following enhancements:

ArrayFindNoCase

Array(first argument) should be array of Strings or Boolean or Numeric only. And object to search(second argument) should be either String or Boolean or Numeric. Otherwise it throws an exception.

replaceListNoCase

It is the non case-sensitive version of replaceList.

cfloop tag

A new attribute "item" is introduced in array cfloop for file and list. Earlier, only index was supported in cfloop which was not a clean behavior. Now, you can use both item and index or either of them.

• If item and index are present, item holds the element and index holds the index.
• If only item is present, item holds the element.
• If only index is present, index holds the element (to support backward compatibility)

cfcollection tag

In Adobe ColdFusion (2016 release), the path attribute is ignored. All the collections are created in the collections directory at the location specified in Solr_Home field in the ColdFusion administrator.

For more information, see cfcollection.

arrayNew

ColdFusion 2016 comes with support for unsynchronized arrays. You can create unsynchronized arrays by passing a special flag to the arrayNew function. By default, the arrays are synchronized for backward compatibility. Note that unsynchronized arrays are not thread safe. You should use them when you do not need thread safety.

Set the isSynchronized flag to false to create an unsynchronized array.

Syntax:

ar_obj = arrayNew(numeric dimension, boolean isSynchronized);

For more information, see arrayNew.

Miscellaneous fixes