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