Initial Commit

database/perl/vendor/lib/XML/LibXML/Namespace.pod

@@ -0,0 +1,161 @@
+=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.0206
+
+=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.
+