CFML Reference
ColdFusion Functions

IsStruct

Description

Determines whether a variable is a structure.

Return value

True, if variable is a ColdFusion structure or is a Java object that implements the java.lang.Map interface. Returns False if the object in variable is a user-defined function (UDF).

Category

Decision functions, Structure functions

Syntax

IsStruct(variable ) 

See also

Structure functions

History

New in ColdFusion MX: this function can be used on XML objects.

Parameters

Parameter	Description
variable	Variable name

Example

<!--- This view-only example shows the use of IsStruct. --->
<p>This file is similar 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 IsStruct(attributes.EMPINFO)>
  <cfoutput>Error. Invalid data.</cfoutput>
  <cfexit method = "ExitTag">
   <cfelse>
  <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> --->

Copyright © 2002, Macromedia Inc. All rights reserved.

Comments