XML::GDOME::NamedNodeMap

NAME
SYNOPSIS
METHODS

NAME

  XML::GDOME::NamedNodeMap - Interface NamedNodeMap implementation.

SYNOPSIS

  $int  = $nnm->getLength();
  $node = $nnm->getNamedItem($name);
  $node = $nnm->getNamedItemNS($namespaceURI,$localName);
  $node = $nnm->item($index);
  $node = $nnm->removeNamedItem($name);
  $node = $nnm->removeNamedItemNS($namespaceURI,$localName);
  $node = $nnm->setNamedItem($arg);
  $node = $nnm->setNamedItemNS($arg);

METHODS

$int = $nnm->getLength();: Returns: the number of nodes in this map. The range of valid child node indices is 0 to length-1 inclusive.
$node = $nnm->getNamedItem($name);: Retrieves a node specified by name.; name: The nodeName of the node to retrieve.; Returns: a Node (of any type) with the specified nodeName, or undef if it does not identify any node in this map.
$node = $nnm->getNamedItemNS($namespaceURI,$localName);: Retrieves a node specified by local name and namespace URI.; namespaceURI: The namespace URI of the node to retrieve.; localName: The local name of the node to retrieve.; Returns: a Node (of any type) with the specified local name and namespace URI, or undef if they do not identify any node in this map.
$node = $nnm->item($index);: index: Index into this map.; Returns: the indexth item in the map. If index is greater than or equal to the number of nodes in this map, this returns undef.
$node = $nnm->removeNamedItem($name);: Removes a node specified by name. When this map contains the attributes attached to an element, 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 when applicable.; name: The nodeName of the node to remove.; Returns: the node removed from this map if a node with such a name exists.; GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly.; GDOME_NOT_FOUND_ERR: Raised if there is no node named name in this map.
$node = $nnm->removeNamedItemNS($namespaceURI,$localName);: Removes a node specified by local name and namespace URI. When this map contains the attributes attached to an element, 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 when applicable.; namespaceURI: The namespace URI of the node to remove.; localName: The local name of the node to remove.; Returns: the node removed from this map if a node with such a local name and namespace URI exists.; GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly.; GDOME_NOT_FOUND_ERR: Raised if there is no node named name in this map.
$node = $nnm->setNamedItem($arg);: Adds a node using its nodeName attribute. If a node with that name is already present in this map, it is replaced by the new one.; arg: a node to store in this map.; Returns: if the new Node replaces an existing node, the replaced Node is returned, otherwise undef is returned.; GDOME_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.; GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly.; GDOME_HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node doesn't belong in this NamedNodeMap. Examples would include trying to insert something other than an Attr node into an Element's map of attributes, or a non-Entity node into the DocumentType's map of Entities.; GDOME_WRONG_DOCUMENT_ERR: Raised if arg was created from a different document than the one that created this map.
$node = $nnm->setNamedItemNS($arg);: Adds a node using its namespaceURI and localName. If a node with that namespace URI and that local name is already present in this map, it is replaced by the new one; arg: a node to store in this map. The node will later be accessible using the value of its namespaceURI and localName attributes.; Returns: If the new Node replaces an existing node the replaced Node is returned, otherwise null is returned.; GDOME_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.; GDOME_NO_MODIFICATION_ALLOWED_ERR: Raised if this map is readonly.; GDOME_HIERARCHY_REQUEST_ERR: Raised if an attempt is made to add a node doesn't belong in this NamedNodeMap. Examples would include trying to insert something other than an Attr node into an Element's map of attributes, or a non-Entity node into the DocumentType's map of Entities.; GDOME_WRONG_DOCUMENT_ERR: Raised if arg was created from a different document than the one that created this map.