CFML Reference
ColdFusion Functions

StructFind

Description

Returns the value associated with a key in a structure.

Category

Structure functions

Syntax

StructFind(structure, key) 

See also

StructClear, StructDelete, StructInsert, StructIsEmpty, StructKeyArray, StructKeyExists, StructKeyList, StructCount, StructNew, StructUpdate, StructAppend, StructGet, StructSort, StructFindKey, StructClear

Parameters

Parameter	Description
structure	Structure that contains the value to return
key	Key whose value to return

Usage

This function throws an exception if structure does not exist.

Example

<!--- This view-only example illustrates usage 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> --->

Copyright © 2001, Macromedia Inc. All rights reserved.