AnyEvent::XMPP::Node man page on Pidora

Man page or keyword search:  
man Server   31170 pages
apropos Keyword Search (all sections)
Output format
Pidora logo
[printable version]

AnyEvent::XMPP::Node(3User Contributed Perl DocumentatiAnyEvent::XMPP::Node(3)

NAME
       AnyEvent::XMPP::Node - XML node tree helper for the parser.

SYNOPSIS
	  use AnyEvent::XMPP::Node;
	  ...

DESCRIPTION
       This class represens a XML node. AnyEvent::XMPP should usually not
       require messing with the parse tree, but sometimes it is neccessary.

       If you experience any need for messing with these and feel
       AnyEvent::XMPP should rather take care of it drop me a mail, feature
       request or most preferably a patch!

       Every AnyEvent::XMPP::Node has a namespace, attributes, text and child
       nodes.

       You can access these with the following methods:

METHODS
       new ($ns, $el, $attrs, $parser)
	   Creates a new AnyEvent::XMPP::Node object with the node tag name
	   $el in the namespace URI $ns and the attributes $attrs. The $parser
	   must be the instance of "AnyEvent::XMPP::Parser" which generated
	   this node.

       name
	   The tag name of this node.

       namespace
	   Returns the namespace URI of this node.

       eq ($namespace_or_alias, $name) or eq ($node)
	   Returns true whether the current element matches the tag name $name
	   in the namespaces pointed at by $namespace_or_alias.

	   You can either pass an alias that was defined in
	   AnyEvent::XMPP::Namespaces or pass an namespace URI in
	   $namespace_or_alias. If no alias with the name $namespace_or_alias
	   was found in AnyEvent::XMPP::Namespaces it will be interpreted as
	   namespace URI.

	   The first argument to eq can also be another AnyEvent::XMPP::Node
	   instance.

       eq_ns ($namespace_or_alias) or eq_ns ($node)
	   This method return true if the namespace of this instance of
	   AnyEvent::XMPP::Node matches the namespace described by
	   $namespace_or_alias or the namespace of the $node which has to be
	   another AnyEvent::XMPP::Node instance.

	   See "eq" for the meaning of $namespace_or_alias.

       attr ($name)
	   Returns the contents of the $name attribute.

       add_node ($node)
	   Adds a sub-node to the current node.

       nodes
	   Returns a list of sub nodes.

       add_text ($string)
	   Adds character data to the current node.

       text
	   Returns the text for this node.

       find_all (@path)
	   This method does a recursive descent through the sub-nodes and
	   fetches all nodes that match the last element of @path.

	   The elements of @path consist of a array reference to an array with
	   two elements: the namespace key known by the $parser and the
	   tagname we search for.

       write_on ($writer)
	   This writes the current node out to the AnyEvent::XMPP::Writer
	   object in $writer.

       as_string ()
	   This method returns the original character representation of this
	   XML element (and it's children nodes). Please note that the string
	   is a unicode string, meaning: to get octets use:

	      my $octets = encode ('UTF-8', $node->as_string);

	   Now you can roll stunts like this:

	      my $libxml = XML::LibXML->new;
	      my $doc	 = $libxml->parse_string (encode ('UTF-8', $node->as_string ()));

	   (You can use your favorite XML parser :)

       append_raw ($string)
	   This method is called by the parser to store original strings of
	   this element.

       to_sax_events ($handler)
	   This method takes anything that can receive SAX events.  See also
	   XML::GDOME::SAX::Builder or XML::Handler::BuildDOM or
	   XML::LibXML::SAX::Builder.

	   With this you can convert this node to any DOM level 2 structure
	   you want:

	      my $builder = XML::LibXML::SAX::Builder->new;
	      $node->to_sax_events ($builder);
	      my $dom = $builder->result;
	      print "Canonized: " . $dom->toStringC14N . "\n";

AUTHOR
       Robin Redeker, "<elmex at ta-sa.org>", JID: "<elmex at jabber.org>"

COPYRIGHT & LICENSE
       Copyright 2007, 2008 Robin Redeker, all rights reserved.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

perl v5.14.1			  2009-08-14	       AnyEvent::XMPP::Node(3)
[top]

List of man pages available for Pidora

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net