CFML Language Reference
Chapter 2 :  ColdFusion Functions

StructCount

Returns the number of keys in the specified structure.

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

Syntax

StructCount(structure)

structure

Structure to be accessed.

Usage

This function throws an exception if structure does not exist.

Example

<!--- 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> --->

Copyright © 1999, Allaire Corporation. All rights reserved.