/ 
XML-LibXML-1.64
/ XML::LibXML::Namespace
Security Advisories (3)
CVE-2015-3451 (2015-04-23)

The _clone function does not properly set the expand_entities option, which allows remote attackers to conduct XML external entity (XXE) attacks via crafted XML data to the (1) new or (2) load_xml function.

CVE-2017-10672 (2015-04-23)

Use-after-free in the XML-LibXML module through 2.0129 for Perl allows remote attackers to execute arbitrary code by controlling the arguments to a replaceChild call.

CVE-2026-8177 (2026-05-10)

XML::LibXML versions through 2.0210 for Perl read out-of-bounds heap memory when parsing XML node names containing truncated UTF-8 byte sequences. A node name ending in the middle of a multi byte UTF-8 sequence causes the parser to read past the end of the input string into adjacent heap memory. Any Perl process that passes attacker controlled strings to XML::LibXML's DOM node-name methods can reach this path on the default API. The likely consequence is a crash, causing denial of service.

NAME

XML::LibXML::Namespace - XML::LibXML Namespace Implementation

SYNOPSIS

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

my $ns = XML::LibXML::Namespace->new($nsURI);
print $ns->nodeName();
print $ns->name();
$localname = $ns->getLocalName();
print $ns->getData();
print $ns->getValue();
print $ns->value();
$known_uri = $ns->getNamespaceURI();
$known_prefix = $ns->getPrefix();

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 XML::LibXML::Node, 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.

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 XML::LibXML::Node 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"

AUTHORS

Matt Sergeant, Christian Glahn, Petr Pajas,

VERSION

1.64

COPYRIGHT

2001-2007, AxKit.com Ltd; 2002-2006 Christian Glahn; 2006-2007 Petr Pajas, All rights reserved.