XML::LibXML Namespace Implementation

Synopsis

use XML::LibXML;
# Only methods specific to Namespace nodes are listed here,
# see XML::LibXML::Node manpage for other methods

Description
Namespace nodes are returned by both $element->findnodes('namespace::foo') or by $node->getNamespaces().
The namespace node API is not part of any current DOM API, and so it is quite minimal. It should be noted that namespace nodes are not a sub class of Abstract Base Class of XML::LibXML Nodes, however Namespace nodes act a lot like attribute nodes, and similarly named methods will return what you would expect if you treated the namespace node as an attribute. Note that in order to fix several inconsistencies between the API and the documentation, the behavior of some functions have been changed in 1.64.

Methods
new 	

my $ns = XML::LibXML::Namespace->new($nsURI);

Creates a new Namespace node. Note that this is not a 'node' as an attribute or an element node. Therefore you can't do call all Abstract Base Class of XML::LibXML Nodes Functions. All functions available for this node are listed below.
Optionally you can pass the prefix to the namespace constructor. If this second parameter is omitted you will create a so called default namespace. Note, the newly created namespace is not bound to any document or node, therefore you should not expect it to be available in an existing document.
declaredURI 	 Returns the URI for this namespace.
declaredPrefix 	 Returns the prefix for this namespace.
nodeName 	

print $ns->nodeName();

Returns "xmlns:prefix", where prefix is the prefix for this namespace.
name 	

print $ns->name();

Alias for nodeName()
getLocalName 	

$localname = $ns->getLocalName();

Returns the local name of this node as if it were an attribute, that is, the prefix associated with the namespace.
getData 	

print $ns->getData();

Returns the URI of the namespace, i.e. the value of this node as if it were an attribute.
getValue 	

print $ns->getValue();

Alias for getData()
value 	

print $ns->value();

Alias for getData()
getNamespaceURI 	

$known_uri = $ns->getNamespaceURI();

Returns the string "http://www.w3.org/2000/xmlns/"
getPrefix 	

$known_prefix = $ns->getPrefix();

Returns the string "xmlns"