Returns a clone, also known as a deep copy, of a variable. There is no reference to the original variable.
Structure functions, System functions
Duplicate(variable_name)
StructCopy,
other Structure functions
New in ColdFusion MX: this function can be used on XML objects.
Parameter | Description |
---|---|
variable_name |
Name of a variable to duplicate |
Use this function to duplicate complex structures, such as nested structures and queries.
Note: With this function, you cannot duplicate a COM, CORBA, or JAVA object returned from the cfobject
tag or the CreateObject
function. If an array element or structure field is a COM, CORBA, or JAVA object, you cannot duplicate the array or structure.
<h3>Duplicate Example</h3> <cfset s1 = StructNew()> <cfset s1.nested = StructNew()> <cfset s1.nested.item = "original"> <cfset copy = StructCopy(s1)> <cfset clone = Duplicate(s1)> <!--- modify the original ---> <cfset s1.nested.item = "modified"> <cfoutput> <p>The copy contains the modified value: #copy.nested.item#</p> <p>The duplicate contains the original value: #clone.nested.item#</p> </cfoutput>