CFML Language Reference
Chapter 2 :  ColdFusion Functions

StructFind

Returns the value associated with the specified key in the specified structure.

See also StructClear, StructDelete, StructInsert, StructIsEmpty, StructKeyArray, StructCount, StructKeyArray, and StructUpdate.

Syntax

StructFind(structure, key)

structure

Structure containing the value to be returned.

key

Key whose value is returned.

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 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">
      <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 © 1999, Allaire Corporation. All rights reserved.