STRUCTCOUNT | |
Description
Counts the keys in a structure. |
|
Returns
A number; if structure does not exist, throws an exception. |
|
Category
Structure functions |
|
Function syntaxStructCount(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 | |