Macromedia coldfusion 4.5-cfml language reference User Manual

524

StructCount

Returns the number of keys in the specified structure.

See also 

StructClear

, 

StructDelete

, 

StructFind

, 

StructInsert

, 

StructIsEmpty

, 

StructKeyArray

, 

StructKeyArray

, and 

StructUpdate

.

StructCount(

structure)

Structure to be accessed.

This function throws an exception if structure does not exist.

<!--- This view-only example illustrates usage
      of StructCount. --->
<P>This file is similar to addemployee.cfm, which is called
by StructNew, StructClear, and StructDelete. To test this file,
copy the StructCount function to the appropriate place
in addemployee.cfm.
<!--- 
<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
         <P>#StructCount(attributes.EMPINFO)# columns added.</CFOUTPUT>
   </CFCASE>
</CFSWITCH> --->