STRUCTCOUNT |
Description Counts the keys in a structure.
Returns A number; if structure does not exist, throws an exception.
Category Structure functions
Function syntax
    StructCount(structure)
See also Structure functions; "Modifying a ColdFusion XML object" in Chapter 35, "Using XML and WDDX," in ColdFusion MX Developer's Guide
History ColdFusion MX: Changed behavior: this function can be used on XML objects.
Parameters
Example
    <!--- This view-only example shows use of StructCount. --->
    <p>This file is similar to addemployee.cfm, which is called by
    StructNew, StructClear, and StructDelete. To test, copy
    StructCount function to 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 = "cfdocexamples">
         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> --->

STRUCTURE |

Structure to access