Appends one structure to another.
True, upon successful completion; False, otherwise.
StructAppend(struct1, struct2, overwriteFlag)
New in ColdFusion MX: this function can be used on XML objects.
This function appends the fields and values of struct2
to struct1
; struct2
is not modified. If struct1
already contains a field of struct2
, overwriteFlag
determines whether the value in struct2
overwrites it.
A structure's keys are unordered.
<html> <body> <!---- Create a Name structure ---> <cfset nameCLK=StructNew()> <cfset nameCLK.first="Chris"> <cfset nameCLK.middle="Lloyd"> <cfset nameCLK.last="Gilson"> <!--- Create an address struct ---> <cfset addrCLK=StructNew()> <cfset addrCLK.street="17 Gigantic Rd"> <cfset addrCLK.city="Watertown"> <cfset addrCLK.state="MA"> <cfset addrCLK.zip="02472"> <!---- Create a Person structure ---> <cfset personCLK=StructNew()> <cfset personCLK.name=#nameCLK#> <cfset personCLK.addr=#addrCLK#> <!--- Display the contents of the person struct before the Append ---> <p> The person struct <b>before</b> the Append call:<br> <cfloop collection=#personCLK# item="myItem"> <cfoutput> #myItem#<br> </cfoutput> </cfloop> <!--- Merge the Name struct into the top-level person struct ---> <cfset bSuccess = StructAppend( personCLK, addrCLK )> <!--- Display the contents of the person struct, after the Append ---> <p> The person struct <b>after</b> the Append call:<br> <cfloop collection=#personCLK# item="myItem"> <cfoutput> #myItem#<br> </cfoutput> </cfloop>