XML::LibXML man page on OpenServer

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

LibXML(3)	      User Contributed Perl Documentation	     LibXML(3)

NAME
       XML::LibXML - Perl Binding for libxml2

SYNOPSIS
	 $Version_String = XML::LibXML::LIBXML_DOTTED_VERSION;
	 $Version_ID = XML::LibXML::LIBXML_VERSION;
	 $DLL_Version = XML::LibXML::LIBXML_RUNTIME_VERSION;
	 $libxmlnode = XML::LibXML->import_GDOME( $node, $deep );
	 $gdomenode = XML::LibXML->export_GDOME( $node, $deep );

DESCRIPTION
SYNOPSIS
	 use XML::LibXML;
	 my $parser = XML::LibXML->new();

	 my $doc = $parser->parse_string(<<'EOT');
	 <some-xml/>
	 EOT

DESCRIPTION
       This module is an interface to the gnome libxml2 DOM and SAX parser and
       the DOM tree. It also provides an XML::XPath-like findnodes() inter-
       face, providing access to the XPath API in libxml2. The module is split
       into several packages which are not described in this section.

       For further information, please check the following documentation:

       XML::LibXML::Parser
	   Parsing XML Files with XML::LibXML

       XML::LibXML::DOM
	   XML::LibXML DOM Implementation

       XML::LibXML::SAX
	   XML::LibXML direct SAX parser

       XML::LibXML::Reader
	   Reading XML with a pull-parser

       XML::LibXML::Document
	   XML::LibXML DOM Document Class

       XML::LibXML::Node
	   Abstract Base Class of XML::LibXML Nodes

       XML::LibXML::Element
	   XML::LibXML Class for Element Nodes

       XML::LibXML::Text
	   XML::LibXML Class for Text Nodes

       XML::LibXML::Comment
	   XML::LibXML Comment Nodes

       XML::LibXML::CDATASection
	   XML::LibXML Class for CDATA Sections

       XML::LibXML::Attr
	   XML::LibXML Attribute Class

       XML::LibXML::DocumentFragment
	   XML::LibXML's DOM L2 Document Fragment Implementation

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

       XML::LibXML::PI
	   XML::LibXML Processing Instructions

       XML::LibXML::Dtd
	   XML::LibXML DTD Support

       XML::LibXML::RelaxNG
	   XML::LibXML frontend for RelaxNG schema validation

       XML::LibXML::Schema
	   XML::LibXML frontend for W3C Schema schema validation

       XML::LibXML::XPathContext
	   API for evaluating XPath expressions

       XML::LibXMLguts
	   Internal of the Perl Layer for libxml2 (not done yet)

VERSION INFORMATION
       Sometimes it is useful to figure out, for which version XML::LibXML was
       compiled for. In most cases this is for debugging or to check if a
       given installation meets all functionality for the package. The func-
       tions XML::LibXML::LIBXML_DOTTED_VERSION and XML::LibXML::LIBXML_VER-
       SION provide this version information. Both functions simply pass
       through the values of the similar named macros of libxml2. Similarly,
       XML::LibXML::LIBXML_RUNTIME_VERSION returns the version of the (usually
       dynamically) linked libxml2.

       XML::LibXML::LIBXML_DOTTED_VERSION
	     $Version_String = XML::LibXML::LIBXML_DOTTED_VERSION;

	   Returns the version string of the libxml2 version XML::LibXML was
	   compiled for.  This will be "2.6.2" for "libxml2 2.6.2".

       XML::LibXML::LIBXML_VERSION
	     $Version_ID = XML::LibXML::LIBXML_VERSION;

	   Returns the version id of the libxml2 version XML::LibXML was com-
	   piled for.  This will be "20602" for "libxml2 2.6.2". Don't mix
	   this version id with $XML::LibXML::VERSION. The latter contains the
	   version of XML::LibXML itself while the first contains the version
	   of libxml2 XML::LibXML was compiled for.

       XML::LibXML::LIBXML_RUNTIME_VERSION
	     $DLL_Version = XML::LibXML::LIBXML_RUNTIME_VERSION;

	   Returns a version string of the libxml2 which is (usually dynami-
	   cally) linked by XML::LibXML. This will be "20602" for libxml2
	   released as "2.6.2" and something like "20602-CVS2032" for a CVS
	   build of libxml2.

	   XML::LibXML issues a warning if the version of libxml2 dynamically
	   linked to it is less than the version of libxml2 which it was com-
	   piled against.

RELATED MODULES
       The modules described in this section are not part of the XML::LibXML
       package itself. As they support some additional features, they are men-
       tioned here.

       XML::LibXSLT
	   XSLT Processor using libxslt and XML::LibXML

       XML::LibXML::Common
	   Common functions for XML::LibXML related Classes

       XML::LibXML::Iterator
	   XML::LibXML Implementation of the DOM Traversal Specification

XML::LIBXML AND XML::GDOME
       Note: THE FUNCTIONS DESCRIBED HERE ARE STILL EXPERIMENTAL

       Although both modules make use of libxml2's XML capabilities, the DOM
       implementation of both modules are not compatible. But still it is pos-
       sible to exchange nodes from one DOM to the other. The concept of this
       exchange is pretty similar to the function cloneNode(): The particular
       node is copied on the low-level to the opposite DOM implementation.

       Since the DOM implementations cannot coexist within one document, one
       is forced to copy each node that should be used. Because you are always
       keeping two nodes this may cause quite an impact on a machines memory
       usage.

       XML::LibXML provides two functions to export or import GDOME nodes:
       import_GDOME() and export_GDOME(). Both function have two parameters:
       the node and a flag for recursive import. The flag works as in cloneN-
       ode().

       The two functions allow to export and import XML::GDOME nodes explic-
       itly, however, XML::LibXML allows also the transparent import of
       XML::GDOME nodes in functions such as appendChild(), insertAfter() and
       so on. While native nodes are automatically adopted in most functions
       XML::GDOME nodes are always cloned in advance. Thus if the original
       node is modified after the operation, the node in the XML::LibXML docu-
       ment will not have this information.

       import_GDOME
	     $libxmlnode = XML::LibXML->import_GDOME( $node, $deep );

	   This clones an XML::GDOME node to a XML::LibXML node explicitly.

       export_GDOME
	     $gdomenode = XML::LibXML->export_GDOME( $node, $deep );

	   Allows to clone an XML::LibXML node into a XML::GDOME node.

AUTHORS
       Matt Sergeant, Christian Glahn, Petr Pajas,

VERSION
       1.63

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

perl v5.8.8			  2007-04-16			     LibXML(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OpenServer

List of man pages available for OpenServer

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