162 lines
3.3 KiB
Plaintext
162 lines
3.3 KiB
Plaintext
=head1 NAME
|
|
|
|
XML::LibXML::Namespace - XML::LibXML Namespace Implementation
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
use XML::LibXML;
|
|
# Only methods specific to Namespace nodes are listed here,
|
|
# see the 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();
|
|
$key = $ns->unique_key();
|
|
|
|
=head1 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 I<<<<<< not >>>>>> a sub class of L<<<<<< 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.
|
|
|
|
|
|
=head1 METHODS
|
|
|
|
=over 4
|
|
|
|
=item 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 L<<<<<< 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.
|
|
|
|
|
|
=item declaredURI
|
|
|
|
Returns the URI for this namespace.
|
|
|
|
|
|
=item declaredPrefix
|
|
|
|
Returns the prefix for this namespace.
|
|
|
|
|
|
=item nodeName
|
|
|
|
print $ns->nodeName();
|
|
|
|
Returns "xmlns:prefix", where prefix is the prefix for this namespace.
|
|
|
|
|
|
=item name
|
|
|
|
print $ns->name();
|
|
|
|
Alias for nodeName()
|
|
|
|
|
|
=item 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.
|
|
|
|
|
|
=item getData
|
|
|
|
print $ns->getData();
|
|
|
|
Returns the URI of the namespace, i.e. the value of this node as if it were an
|
|
attribute.
|
|
|
|
|
|
=item getValue
|
|
|
|
print $ns->getValue();
|
|
|
|
Alias for getData()
|
|
|
|
|
|
=item value
|
|
|
|
print $ns->value();
|
|
|
|
Alias for getData()
|
|
|
|
|
|
=item getNamespaceURI
|
|
|
|
$known_uri = $ns->getNamespaceURI();
|
|
|
|
Returns the string "http://www.w3.org/2000/xmlns/"
|
|
|
|
|
|
=item getPrefix
|
|
|
|
$known_prefix = $ns->getPrefix();
|
|
|
|
Returns the string "xmlns"
|
|
|
|
|
|
=item unique_key
|
|
|
|
$key = $ns->unique_key();
|
|
|
|
This method returns a key guaranteed to be unique for this namespace, and to
|
|
always be the same value for this namespace. Two namespace objects return the
|
|
same key if and only if they have the same prefix and the same URI. The
|
|
returned key value is useful as a key in hashes.
|
|
|
|
|
|
|
|
=back
|
|
|
|
=head1 AUTHORS
|
|
|
|
Matt Sergeant,
|
|
Christian Glahn,
|
|
Petr Pajas
|
|
|
|
|
|
=head1 VERSION
|
|
|
|
2.0207
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
2001-2007, AxKit.com Ltd.
|
|
|
|
2002-2006, Christian Glahn.
|
|
|
|
2006-2009, Petr Pajas.
|
|
|
|
=cut
|
|
|
|
|
|
=head1 LICENSE
|
|
|
|
This program is free software; you can redistribute it and/or modify it under
|
|
the same terms as Perl itself.
|
|
|