Skip to main content
Ben Nadel at cf.Objective() 2014 (Bloomington, MN) with: Jeff McDowell and Jonathan Dowdle and Joel Hill and Josh Siok and Christian Ready and Steve 'Cutter' Blades and Matt Vickers
Ben Nadel at cf.Objective() 2014 (Bloomington, MN) with: Jeff McDowell ( @jeff_s_mcdowell ) Jonathan Dowdle ( @jdowdle ) Joel Hill ( @Jiggidyuo ) Josh Siok ( @siok ) Christian Ready ( @christianready ) Steve 'Cutter' Blades ( @cutterbl ) Matt Vickers ( @envex )

StructCopy() Duplicates Argument-Collection Functionality Without Deep Copy In ColdFusion

Published in Comments (6)

In ColdFusion, the Arguments-Collection object is an objectively awesome object because it allows us to access a function's CFArgument values using either named-keys or ordered-indices. That's way cool! When I was writing my last post on ArraySplice(), I thought it would be nice to be able to duplicate the argument collection without performing a deep copy. My initial concerns over ColdFusion's various copy methods were as follows:

  • StructCopy() - Would return a struct, thereby losing the index-based lookup.
  • Duplicate() - Would perform a deep copy, breaking pass-by-reference bindings.

As it turns out, however, my fear of StructCopy() was unfounded. Apparently, ColdFusion's StructCopy() function will work with both structs as well as argument collections. To see this in action, take a look at this demo:

	hint="I try to copy the arguments scope.">

	<!--- Define arguments. --->
		hint="I am STRUCT object."

	<!--- Copy the arguments. --->
	<cfset var copy = structCopy( arguments ) />

	<!--- Update the first arguments (copy) by index. --->
	<cfset copy[ 1 ].name = "Sarah" />

	<!--- Return out. --->
	<cfreturn />

<!--- ----------------------------------------------------- --->
<!--- ----------------------------------------------------- --->

	Create a struct with a key-value we can manipulate.
	It's important that this is a struct so that it is
<cfset friend = {
	name = "Kate"
	} />

<!--- Call our test method. --->
<cfset doCopy( friend ) />

<!--- Output friend's name. --->

As you can see, I am passing in a struct to the test method; because structs are passed-by-reference, any updates that I make to the struct within the user defined function should be reflected in the original struct. Once inside the UDF, I copy the arguments scope and then update its contents by-index. When running the above code, we get the following output:

Name: Sarah

As you can see, the name of the friend was changed in the original object (from Kate to Sarah) - StructCopy() kept the original references.

This was very surprising! But, when I first saw this, I wanted to be sure that the StructCopy() wasn't merely copying both the keys and indices from the argument collection. To confirm that this wasn't the case, I CFDump'd out the arguments scope and its copy inside the UDF (post-update). Here is what I get:

StructCopy() Of ColdFusion's Arguments Scope (Argument Collection) Returns An Argument Collection Object.

As you can see, there are no visible index values even though we updated the friend's name by way of an index value. StructCopy() truly creates a top-level copy of the ColdFusion's argument collection (and outputting the underlying Java class name confirms this). Sweet ass sweet!

Want to use code from this post? Check out the license.

Reader Comments


wow! have the what I call a quick response xD I save you under my favorites and when i have a question about javascript, i will ask you when you allow ^^



My pleasure. Duplicate() is a good function - you just have to be aware that it does a deep copy (duplicating even CFCs in newer versions of ColdFusion).

I believe in love. I believe in compassion. I believe in human rights. I believe that we can afford to give more of these gifts to the world around us because it costs us nothing to be decent and kind and understanding. And, I want you to know that when you land on this site, you are accepted for who you are, no matter how you identify, what truths you live, or whatever kind of goofy shit makes you feel alive! Rock on with your bad self!
Ben Nadel