Functions For Xml Object Management - MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Develop Manual

Functions for XML object management

The following table lists the ColdFusion array and structure functions that you can use to manage
XML document objects and their functions, and describes their common uses. In several cases
you can use either an array function or a structure function for a purpose, such as for deleting all
of an element's attributes or children.
Function
ArrayLen
ArrayIsEmpty
StructCount
StructIsEmpty
StructKeyArray
StructKeyList
ArrayInsertAt
ArrayAppend
ArrayPrepend
ArraySwap
ArraySet
ArrayDeleteAt
ArrayClear
StructDelete
StructClear
Duplicate
IsArray
IsStruct
StructGet
682 Chapter 31: Using XML and WDDX
Use
Determines the number of child elements in an element, that is, the number
of elements in an element's
Determines whether an element has any elements in its
Determines the number of attributes in an element's
structure.
Determines whether an element has any attributes in its
structure.
Returns True if the specified structure, including the XML document object
or an element, exists and is empty.
Gets an array or list with the names of all of the attributes in an element's
structure. Returns the names of the children of an XML
XmlAttributes
element.
Adds a new element at a specific location in an element's
Adds a new element at the end or beginning of an element's
array.
Swaps the children in the
Sets a range of entries in an
specified element structure. Each entry in the array range will be a copy of
the structure. Can be used to set a single element by specifying the same
index as the beginning and end of the range.
Deletes a specific element from an element's
Deletes all child elements from an element's
Deletes a selected attribute from an element's
Deletes all children with a specific element name from an element's
array.
XmlChildren
Deletes all attributes of an element.
Deletes all children of an element.
Deletes a selected property value.
Deletes all attributes from an element's
Copies an XML document object, element, or node structure.
Returns True for the
XmlChildren
element name, such as mydoc.XmlRoot.name, even if there are multiple
name elements in XmlRoot.
Returns False for XML document objects, elements, and nodes. Returns
True for
XmlAttributes
Returns the specified structure, including XML document objects,
elements, nodes, and
XmlAttributes
array.
XmlChildren
array at the specified position.
XmlChildren
array to equal the contents of a
XmlChildren
XmlChildren
XmlChildren
XMLAttributes
array. Returns false if you specify an
structures.
structures.
array.
XmlChildren
XmlAttributes
XmlAttributes
XmlChildren
XmlChildren
array.
array.
structure.
XMLAttributes
structure.
array.