<html>
<head>
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>STRUCTFIND</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="Description">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">STRUCTFIND</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Description</span>
<p>
Determines the value associated with a key in a structure. 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Returns</span>
<p>
The value associated with a key in a structure; if structure does not exist, throws an exception.
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Category</span>
<p>
Structure functions
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Function syntax</span><pre>StructFind(structure, key)
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">See also</span>
<p>
Structure functions; "Structure functions" in Chapter&#160;5, "Using Arrays and Structures," in ColdFusion MX Developer's Guide
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Parameters</span>
<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Usage</span>
<p>
A structure's keys are unordered. 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Example</span><pre>&lt;!--- This view-only example shows the use of StructFind. ---&gt;
&lt;p&gt;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.
&lt;!--- 
&lt;cfswitch expression = &quot;#ThisTag.ExecutionMode#&quot;&gt;
  &lt;cfcase value = &quot;start&quot;&gt;
   &lt;cfif StructIsEmpty(attributes.EMPINFO)&gt;
    &lt;cfoutput&gt;Error. No employee data was passed.&lt;/cfoutput&gt;
     &lt;cfexit method = &quot;ExitTag&quot;&gt;
   &lt;cfelse&gt;
     &lt;cfquery name = &quot;AddEmployee&quot; datasource = &quot;cfdocexamples&quot;&gt;
     INSERT INTO Employees (FirstName, LastName, Email, Phone, Department)
      VALUES 
       &lt;cfoutput&gt;
        (
         `#StructFind(attributes.EMPINFO, &quot;firstname&quot;)#' ,
         `#StructFind(attributes.EMPINFO, &quot;lastname&quot;)#' ,
         `#StructFind(attributes.EMPINFO, &quot;email&quot;)#' ,
         `#StructFind(attributes.EMPINFO, &quot;phone&quot;)#' ,
         `#StructFind(attributes.EMPINFO, &quot;department&quot;)#' )
       &lt;/cfoutput&gt; 
    &lt;/cfquery&gt;
   &lt;/cfif&gt;
   &lt;cfoutput&gt;&lt;hr&gt;Employee Add Complete&lt;/cfoutput&gt;
  &lt;/cfcase&gt;
&lt;/cfswitch&gt; ---&gt;
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="STRUCTURE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">STRUCTURE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>


<p>Structure that contains the value to return</p>

  </td>
  </tr>
  </table>
</div>
<div id="KEY">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">KEY</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>


<p>Key whose value to return</p>

  </td>
  </tr>
  </table>
</div>

  </body>
</html>
