Description
Counts the keys in a structure.
Returns
A number; if structure does not exist, throws an exception.
Category
Function syntax
StructCount(structure) |
See also
Structure functions; Modifying a ColdFusion XML object in the Developing ColdFusion Applications
History
ColdFusion MX: Changed behavior: this function can be used on XML objects.
Parameters
Parameter |
Description |
|---|---|
structure |
Structure to access |
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> ---> |
