StructFind  
Description
Determines the value associated with a key in a structure.
 
Returns
The value associated with a key in a structure; if structure does not exist, throws an exception.
 
Category
Structure functions
 
Function syntax
StructFind(structure, key)
 
See also
Structure functions
 
Parameters
 
Parameter      Description
structure Structure that contains the value to return
key Key whose value to return
 
Usage
A structure's keys are unordered.
 
Example
<!--- This view-only example shows the use of StructFind. --->
<p>This file is identical to addemployee.cfm, which is called by StructNew,
StructClear, and StructDelete. It adds employees. Employee information 
is passed through the employee structure (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">
   <cfelse>
     <cfquery name = "AddEmployee" datasource = "cfsnippets">
     INSERT INTO Employees (FirstName, LastName, Email, Phone, Department)
      VALUES 
       <cfoutput>
        (
         `#StructFind(attributes.EMPINFO, "firstname")#' ,
         `#StructFind(attributes.EMPINFO, "lastname")#' ,
         `#StructFind(attributes.EMPINFO, "email")#' ,
         `#StructFind(attributes.EMPINFO, "phone")#' ,
         `#StructFind(attributes.EMPINFO, "department")#' )
       </cfoutput> 
    </cfquery>
   </cfif>
   <cfoutput><hr>Employee Add Complete</cfoutput>
  </cfcase>
</cfswitch> --->
structure  
Structure that contains the value to return
key  
Key whose value to return