Class XMLList

• TopLevel.Object
  • TopLevel.XMLList

An XMLList object is an ordered collection of properties. A XMLList object represents a XML document, an XML fragment, or an arbitrary collection of XML objects. An individual XML object is the same thing as an XMLList containing only that XML object. All operations available for the XML object are also available for an XMLList object that contains exactly one XML object.

Constructor Summary 

Constructor	Description
XMLList(Object)	Creates a new XMLList object using the specified value.

Method Summary 

Method	Description
attribute(String)	Returns the attribute associated with this XMLList object that is identified by the specified name.
attributes()	Returns an XMList of the attributes in this XMLList Object.
child(Object)	Returns the children of the XMLList object based on the specified property name.
children()	Returns an XMLList containing the children of this XMLList object, maintaing the sequence in which they appear.
comments()	Returns the properties of the XMLList object that contain comments.
contains(XML)	Returns true if this XMLList object contains the specified XML object, false otherwise.
copy()	Returns a deep copy of the this XMLList object.
descendants()	Calls the descendants() method of each XML object in this XMLList object and returns an XMLList containing the results concatenated in order.
descendants(String)	Calls the descendants(name) method of each XML object in this XMLList object and returns an XMLList containing the results concatenated in order.
elements()	Calls the elements() method in each XML object in this XMLList object and returns an XMLList containing the results concatenated in order.
elements(Object)	Calls the elements(name) method in each of the XML objects in this XMLList object and returns an XMLList containing the results concatenated in order.
hasComplexContent()	Returns a Boolean value indicating whether this XMLList object contains complex content.
hasOwnProperty(String)	Returns a Boolean value indicating whether this object has the property specified by prop.
hasSimpleContent()	Returns a Boolean value indicating whether this XML object contains simple content.
length()	Returns the number of children in this XMLList object.
normalize()	Puts all text nodes in this XMLList, all the XML objects it contains and the descendents of all the XML objects it contains into a normal form by merging adjacent text nodes and eliminating empty text nodes.
parent()	Returns the parent of the XMLList object or null if the XMLList object does not have a parent.
processingInstructions()	Calls the processingInstructions() method of each XML object in this XMLList object and returns an XMList containing the results in order.
processingInstructions(String)	Calls the processingInstructions(name) method of each XML object in this XMLList object and returns an XMList containing the results in order.
propertyIsEnumerable(String)	Returns a Boolean indicating whether the specified property will be included in the set of properties iterated over when this XML object is used in a for..in statement.
text()	Calls the text() method of each XML object contained in this XMLList object and returns an XMLList containing the results concatenated in order.
toString()	Returns the String representation of this XMLList object.
toXMLString()	Returns an XML-encoded String representation of the XMLList object by calling the toXMLString method on each property contained within this XMLList object.
valueOf()	Returns this XMLList object.

Methods inherited from class Object 

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Constructor Details 

XMLList(Object) 

XMLList(value: Object)

Creates a new XMLList object using the specified value.

Parameters:

• value - the value to use.

---

Method Details 

attribute(String) 

attribute(attributeName: String): XMLList

Returns the attribute associated with this XMLList object that is identified by the specified name.

Parameters:

• attributeName - the name of the attribute.

Returns:

• the value of the attribute as either an XMLList or an empty XMLList

---

attributes() 

attributes(): XMLList

Returns an XMList of the attributes in this XMLList Object.

Returns:

• an XMList of the attributes in this XMLList Object.

---

child(Object) 

child(propertyName: Object): XMLList

Returns the children of the XMLList object based on the specified property name.

Parameters:

• propertyName - the property name representing the children of this XMLList object.

Returns:

• an XMLList of children that match the property name parameter.

---

children() 

children(): XMLList

Returns an XMLList containing the children of this XMLList object, maintaing the sequence in which they appear.

Returns:

• an XMLList containing the children of this XMLList object.

---

comments() 

comments(): XMLList

Returns the properties of the XMLList object that contain comments.

Returns:

• properties of the XMLList object that contain comments.

---

contains(XML) 

contains(value: XML): Boolean

Returns true if this XMLList object contains the specified XML object, false otherwise.

Parameters:

• value - the object to locate in this XMLList object.

Returns:

• true if this XMLList object contains the specified XML object, false otherwise.

---

copy() 

copy(): XMLList

Returns a deep copy of the this XMLList object.

Returns:

• the deep copy of the object.

---

descendants() 

descendants(): XMLList

Calls the descendants() method of each XML object in this XMLList object and returns an XMLList containing the results concatenated in order.

Returns:

• a list of all descendents of the XML objects in this XMLList object.

---

descendants(String) 

descendants(name: String): XMLList

Calls the descendants(name) method of each XML object in this XMLList object and returns an XMLList containing the results concatenated in order.

Parameters:

• name - the name of the element to match. To return all descendents, use * as the name parameter.

Returns:

• a list of all descendents of the XML objects in this XMLList constrained by the name parameter.

---

elements() 

elements(): XMLList

Calls the elements() method in each XML object in this XMLList object and returns an XMLList containing the results concatenated in order.

---

elements(Object) 

elements(name: Object): XMLList

Calls the elements(name) method in each of the XML objects in this XMLList object and returns an XMLList containing the results concatenated in order. name can be a QName, String, or any other data type that will be converted to a string prior to performing the search for elements of that name.

To list all objects use * for the value of name.

Parameters:

• name - the name of the elements to return.

Returns:

• a list of all elements of the XML objects in this XMLList constrained by the name parameter.

---

hasComplexContent() 

hasComplexContent(): Boolean

Returns a Boolean value indicating whether this XMLList object contains complex content. An XMLList object is considered to contain complex content if it is not empty, contains a single XML item with complex content or contains elements.

Returns:

• a Boolean value indicating whether this XMLList object contains complex content.

---

hasOwnProperty(String) 

hasOwnProperty(prop: String): Boolean

Returns a Boolean value indicating whether this object has the property specified by prop.

Parameters:

• prop - the property to locate.

Returns:

• true if the property exists, false otherwise.

---

hasSimpleContent() 

hasSimpleContent(): Boolean

Returns a Boolean value indicating whether this XML object contains simple content. An XMLList object is considered to contain simple content if it is empty, contains a single XML item with simple content or contains no elements.

Returns:

• a Boolean value indicating whether this XML object contains simple content.

---

length() 

length(): Number

Returns the number of children in this XMLList object.

Returns:

• the number of children in this XMLList object.

---

normalize() 

normalize(): XMLList

Puts all text nodes in this XMLList, all the XML objects it contains and the descendents of all the XML objects it contains into a normal form by merging adjacent text nodes and eliminating empty text nodes.

Returns:

• the XMLList object containing normailzed objects.

---

parent() 

parent(): Object

Returns the parent of the XMLList object or null if the XMLList object does not have a parent.

Returns:

• the parent of the XMLList object or null if the XMLList object does not have a parent.

---

processingInstructions() 

processingInstructions(): XMLList

Calls the processingInstructions() method of each XML object in this XMLList object and returns an XMList containing the results in order.

Returns:

• an XMLList contaiing the result of calling the processingInstructions() method of each XML object in this XMLList object.

---

processingInstructions(String) 

processingInstructions(name: String): XMLList

Calls the processingInstructions(name) method of each XML object in this XMLList object and returns an XMList containing the results in order.

Parameters:

• name - the name representing the processing-instructions you want to retreive.

Returns:

• an XMLList containing the result of calling the processingInstructions(name) method of each XML object in this XMLList object.

---

propertyIsEnumerable(String) 

propertyIsEnumerable(property: String): Boolean

Returns a Boolean indicating whether the specified property will be included in the set of properties iterated over when this XML object is used in a for..in statement.

Parameters:

• property - the property to test.

Returns:

• true when the property can be iterated in a for..in statement, false otherwise.

---

text() 

text(): XMLList

Calls the text() method of each XML object contained in this XMLList object and returns an XMLList containing the results concatenated in order.

Returns:

• the concatenated results of calling the text() method of every XML object contained in this XMLList.

---

toString() 

toString(): String

Returns the String representation of this XMLList object.

Returns:

• the String representation of this XMLList object.

---

toXMLString() 

toXMLString(): String

Returns an XML-encoded String representation of the XMLList object by calling the toXMLString method on each property contained within this XMLList object.

Returns:

• an XML-encoded String representation of the XMLList object by calling the toXMLString method on each property contained within this XMLList object.

---

valueOf() 

valueOf(): XMLList

Returns this XMLList object.

Returns:

• this XMLList object.

---