MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 554 / 608

530 CFML Language Reference
StructIsEmpty
Indicates whether the specified structure contains data. Returns TRUE if structure is
empty and FALSE if it contains data.
See also StructClear , StructDelete , StructFind , StructInsert , StructKeyArray ,
StructCount , StructKeyArray , and StructUpdate .
Syntax
StructIsEmpty ( structure)
structure
Structure to be tested.
Usage
This function throws an exception if structure does not exist.
Example
<!--- This example illustrates usage of StructIsEmpty. --->
<P>This file is identical to addemployee.cfm, which is called
by StructNew, StructClear, and StructDelete. It is an
example of a custom tag used to add employees. Employee
information is passed through the employee structure (the
EMPINFO attribute). In UNIX, you must also add the Emp_ID.
<CFSWITCH EXPRESSION="#ThisTag.ExecutionMode#">
<CFCASE VALUE="start">
<CFIF StructIsEmpty(attributes.EMPINFO)>
<CFOUTPUT>Error. No employee data was passed.</CFOUTPUT>
<CFEXIT METHOD="ExitTag">
<CFELSE>
<!--- Add the employee --->
<!--- In UNIX, you must also add the Emp_ID --->
<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</CFOUTPUT>
</CFCASE>
</CFSWITCH>