Xalan-C++ API Documentation

The Xalan-C++ XSL Transformer Version 1.0

Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

XercesNamedNodeMapBridge Class Reference

#include <XercesNamedNodeMapBridge.hpp>

Inheritance diagram for XercesNamedNodeMapBridge:

XalanNamedNodeMap Collaboration diagram for XercesNamedNodeMapBridge:

List of all members.

Public Methods

Set functions.
Get functions.
Functions to change the node collection.
Functions introduced in DOM Level 2.

Detailed Description


Constructor & Destructor Documentation

XercesNamedNodeMapBridge::XercesNamedNodeMapBridge ( const DOM_NamedNodeMap & theXercesNamedNodeMap,
const XercesBridgeNavigator & theNavigator)

virtual XercesNamedNodeMapBridge::~XercesNamedNodeMapBridge () [virtual]


Member Function Documentation

unsigned int XercesNamedNodeMapBridge::getLength () const [virtual]

The number of nodes in the map.

The range of valid child node indices is 0 to length-1 inclusive.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::getNamedItem ( const XalanDOMString & name) const [virtual]

Retrieves a node specified by name.

Parameters:
name   The nodeName of a node to retrieve.
Returns:
A DOM_Node (of any type) with the specified nodeName, or null if it does not identify any node in the map.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::getNamedItemNS ( const XalanDOMString & namespaceURI,
const XalanDOMString & localName) const [virtual]

Retrieves a node specified by local name and namespace URI.

Parameters:
namespaceURI   The namespace URI of the node to retrieve.
localName   The local name of the node to retrieve.
Returns:
A DOM_Node (of any type) with the specified local name and namespace URI, or null if they do not identify any node in the map.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::item ( unsigned int index) const [virtual]

Returns the indexth item in the map.

If index is greater than or equal to the number of nodes in the map, this returns null.

Parameters:
index   Index into the map.
Returns:
The node at the indexth position in the NamedNodeMap, or null if that is not a valid index.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::removeNamedItem ( const XalanDOMString & name) [virtual]

Removes a node specified by name.

If the removed node is an Attr with a default value it is immediately replaced.

Parameters:
name   The nodeName of a node to remove.
Returns:
The node removed from the map or null if no node with such a name exists.
Exceptions:
DOMException   NOT_FOUND_ERR: Raised if there is no node named name in the map.
NO_MODIFICATION_ALLOWED_ERR: Raised if this NamedNodeMap is readonly.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::removeNamedItemNS ( const XalanDOMString & namespaceURI,
const XalanDOMString & localName) [virtual]

Removes a node specified by local name and namespace URI.

Parameters:
namespaceURI   The namespace URI of the node to remove.
localName   The local name of the node to remove. When this DOM_NamedNodeMap contains the attributes attached to an element, as returned by the attributes attribute of the DOM_Node interface, if the removed attribute is known to have a default value, an attribute immediately appears containing the default value as well as the corresponding namespace URI, local name, and prefix.
Returns:
The node removed from the map if a node with such a local name and namespace URI exists.
Exceptions:
DOMException   NOT_FOUND_ERR: Raised if there is no node named name in the map.
NO_MODIFICATION_ALLOWED_ERR: Raised if this NamedNodeMap is readonly.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::setNamedItem ( XalanNode * arg) [virtual]

Adds a node using its nodeName attribute.


As the nodeName attribute is used to derive the name which the node must be stored under, multiple nodes of certain types (those that have a "special" string value) cannot be stored as the names would clash. This is seen as preferable to allowing nodes to be aliased.

Parameters:
arg   A node to store in a named node map. The node will later be accessible using the value of the nodeName attribute of the node. If a node with that name is already present in the map, it is replaced by the new one.
Returns:
If the new Node replaces an existing node the replaced Node is returned, otherwise null is returned.
Exceptions:
DOMException   WRONG_DOCUMENT_ERR: Raised if arg was created from a different document than the one that created the NamedNodeMap.
NO_MODIFICATION_ALLOWED_ERR: Raised if this NamedNodeMap is readonly.
INUSE_ATTRIBUTE_ERR: Raised if arg is an Attr that is already an attribute of another Element object. The DOM user must explicitly clone Attr nodes to re-use them in other elements.

Reimplemented from XalanNamedNodeMap.

XalanNode * XercesNamedNodeMapBridge::setNamedItemNS ( XalanNode * arg) [virtual]

Adds a node using its namespaceURI and localName.

Parameters:
arg   A node to store in a named node map. The node will later be accessible using the value of the namespaceURI and localName attribute of the node. If a node with those namespace URI and local name is already present in the map, it is replaced by the new one.
Returns:
If the new Node replaces an existing node the replaced Node is returned, otherwise null is returned.
Exceptions:
DOMException   WRONG_DOCUMENT_ERR: Raised if arg was created from a different document than the one that created the NamedNodeMap.
NO_MODIFICATION_ALLOWED_ERR: Raised if this NamedNodeMap is readonly.
INUSE_ATTRIBUTE_ERR: Raised if arg is an Attr that is already an attribute of another Element object. The DOM user must explicitly clone Attr nodes to re-use them in other elements.

Reimplemented from XalanNamedNodeMap.


The documentation for this class was generated from the following file:

Interpreting class diagrams

Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.

Xalan-C++ XSL Transformer Version 1.0
Copyright © 2000 The Apache Software Foundation. All Rights Reserved.