StructUpdate

Description

Updates a key with a value. Returns Yes if the function is successful and throws an exception if an error occurs.

Syntax


StructUpdate(structure, key, value)

Parameters

Parameter

Description

structure
Structure to update

key
Key whose value is updated

value
New value

Parameter	Description
structure	Structure to update
key	Key whose value is updated
value	New value

Usage

This function throws an exception if structure does not exist.

Example

<!--- This example illustrates usage of StructUpdate. --->

<P>This file is similar to addemployee.cfm, which is called

by StructNew, StructClear, and StructDelete. To test this file,

copy the &LT;CFELSEIF&GT; statement to the appropriate place

in addemployee.cfm. It is an example of a custom tag used 

to add employees. Employee information is passed through the 

employee structure (the EMPINFO attribute). In UNIX, you must 

also add the Emp_ID.



<cfswitch expression = "#ThisTag.ExecutionMode#">

  <cfcase value = "start">

   <cfif StructIsEmpty(attributes.EMPINFO)>

    <cfoutput>Error. No employee data was passed.</cfoutput>

    <cfexit method = "ExitTag">

   <cfelseIf StructFind(attributes.EMPINFO, "department") EQ "">

    <cfscript>

     StructUpdate(attributes.EMPINFO, "department", "Unassigned");

    </cfscript>

    <cfexit method = "ExitTag">

      <cfelse>      

    ...