Table of Contents
Advertisement
Chapter 2: ColdFusion Functions
StructKeyArray
Returns an array of the keys in the specified ColdFusion structure.
See also StructClear, StructDelete, StructFind, StructInsert, StructIsEmpty,
StructKeyList, StructKeyExists, StructCount, and StructUpdate.
Syntax
StructKeyArray( structure )
structure
Structure from which the list of keys is to be extracted.
Usage
The array of keys returned by StructKeyArray is not in any particular order. In order to
sort keys alphabetically or numerically, use ArraySort.
Note that this function throws an exception if structure does not exist.
Example
<!--- This example shows how to use the StructKeyArray
function to copy the keys from a specified structure to an array.
It also uses the StructNew function to create the structure
and fills its fields with the information the user types
into the corresponding form fields. --->
<HTML>
<HEAD>
<TITLE>StructKeyArray Function</TITLE>
</HEAD>
<basefont face="Arial, Helvetica" size=2>
<body
<H3>StructKeyArray Example</H3>
<H3>Extracting the Keys from the Employee Structure</H3>
<!----------------------------------------------------------------
This section of code creates the new structure and checks to
see if the submit button has been pressed.
pressed, the code defines fields in the employee structure
with what the user has entered from the form.
------------------------------------------------------------------->
<CFSET employee=StructNew()>
<CFIF Isdefined("Form.Submit")>
<CFIF Form.Submit is "OK">
<CFELSEIf Form.Submit is "Clear">
bgcolor="#FFFFD5">
<CFSET employee.firstname = FORM.firstname>
<CFSET employee.lastname = FORM.lastname>
<CFSET employee.email = FORM.email>
<CFSET employee.phone = FORM.phone>
<CFSET employee.company = FORM.company>
<CFSET rc=StructClear(employee)>
If it has been
531
Advertisement
Table of Contents
Need help?
Do you have a question about the COLDFUSION 4.5-CFML LANGUAGE and is the answer not in the manual?
Questions and answers