Developing ColdFusion Applications
Handling Complex Data with Structures

Structure Functions

Use the following functions to create and manage structures in ColdFusion applications:

Function	Description
IsStruct	Returns True if the specified variable is a structure.
StructClear	Removes all data from the specified structure.
StructCopy	Returns a new structure with all the keys and values of the specified structure.
StructCount	Returns the number of keys in the specified structure.
StructDelete	Removes the specified item from the specified structure.
StructFind	Returns the value associated with the specified key in the specified structure.
StructInsert	Inserts the specified key-value pair into the specified structure.
StructIsEmpty	Indicates whether the specified structure contains data. Returns True if the structure contains no data, and False if it does contain data.
StructKeyArray	Returns an array of keys in the specified structure.
StructKeyExists	Returns True if the specified key is in the specified structure.
StructKeyList	Returns a list of keys in the specified structure.
StructNew	Returns a new structure.
StructUpdate	Updates the specified key with the specified value.

Note that in all cases, except StructDelete, an exception is thrown if the referenced key or structure does not exist.

For more information on these functions, see the CFML Reference.

Copyright © 2001, Macromedia Inc. All rights reserved.

---