Name

StructAppend

Synopsis

                  
                  
                  StructAppend(structure1, structure2 [, overwrite])

Appends the contents of structure2 to structure1. After completion, structure1 contains the newly appended structure while structure2 remains unchanged. Setting the optional overwrite parameter to Yes allows overwriting of existing keys/values within the appended structure. The default value for overwrite is Yes. The following example demonstrates the StructAppend( ) function: 

<cfset Employee=StructNew( )>
<cfset Employee.Name="Pere Money">
<cfset Employee.Title="President">
<cfset Employee.Department="Executive Management">
   
<cfset ContactInfo=StructNew( )>
<cfset ContactInfo.Email="pmoney@example.com">
<cfset ContactInfo.PhoneExt="1234">
   
<h2>Employee Struct</h2>
<cfdump var="#Employee#">
   
<h2>ContactInfo Struct</h2>
<cfdump var="#ContactInfo#">
   
<cfset StructAppend(Employee, ContactInfo, "No")>
   
<h2>Appended Employee Struct</h2>
<cfdump var="#Employee#">

Get Programming ColdFusion MX, 2nd Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial