GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
XML::LibXML::Namespace(3) User Contributed Perl Documentation XML::LibXML::Namespace(3)

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

  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();

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"

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.

Matt Sergeant, Christian Glahn, Petr Pajas

2.0207

2001-2007, AxKit.com Ltd.

2002-2006, Christian Glahn.

2006-2009, Petr Pajas.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
2021-04-17 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.