User Guide

908 Chapter 3: ColdFusion Functions
XmlChildPos
Description
Gets the position of a child element within an XML document object.
Returns
The position, in an XmlChildren array, of the Nth child that has the specified name.
Category
XML functions
Function syntax
XmlChildPos(elem, childName, N)
See also
IsXmlElem
, XmlElemNew, XmlSearch, XmlTransform; Chapter 35, “Using XML and WDDX” in
ColdFusion MX Developer’s Guide
History
ColdFusion MX: Added this function.
Parameters
Usage
You can use the returned index in the ArrayInsertAt and ArrayDeleteAt functions to change
XML document objects. If the specified child is not found, the function returns -1.
Example
The following example searches XML document element, xmlobject.employee.name[1], for
its second
Status element child and uses the position in an ArrayDeleteAt function to remove
the element:
<!--- Create an XML document object --->
<cfxml variable="xmlobject">
<employee>
<!-- A list of employees -->
<name EmpType="Regular">
<first>Almanzo</first>
<last>Wilder</last>
<Status>Medical Absence</Status>
<Status>Extended Leave</Status>
</name>
<name EmpType="Contract">
Parameter Description
elem XML element within which to search.
childName XML child element for which to search. Must be an immediate child of the
elem
parameter.
N Index of XMLchild element for which to search.