Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XML::GDOME::NamedNodeMUser)Contributed Perl DocumenXML::GDOME::NamedNodeMap(3)

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.

perl v5.24.1			  2002-09-15	   XML::GDOME::NamedNodeMap(3)

NAME | SYNOPSIS | METHODS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XML::GDOME::NamedNodeMap&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help