Gecko [ fernandoquevedodop.com ]

Name	Size	Permission
complex	[ DIR ]	drwxr-xr-x
xmlns	[ DIR ]	drwxr-xr-x
article.xml	245 B	-rw-r--r--
article_bad.xml	215 B	-rw-r--r--
article_external_bad.xml	284 B	-rw-r--r--
article_internal.xml	836 B	-rw-r--r--
article_internal_bad.xml	838 B	-rw-r--r--
bad.dtd	38 B	-rw-r--r--
bad.xml	19 B	-rw-r--r--
catalog.xml	324 B	-rw-r--r--
cb_example.pl	1.13 KB	-rw-r--r--
create-sample-html-document.pl	5.02 KB	-rw-r--r--
dromeds.xml	410 B	-rw-r--r--
dtd.xml	111 B	-rw-r--r--
enc2_latin2.html	50 B	-rw-r--r--
enc_latin2.html	146 B	-rw-r--r--
ext_ent.dtd	48 B	-rw-r--r--
ns.xml	182 B	-rw-r--r--
test.dtd	581 B	-rw-r--r--
test.html	6.83 KB	-rw-r--r--
test.xhtml	7.07 KB	-rw-r--r--
test.xml	113 B	-rw-r--r--
test2.xml	13 B	-rw-r--r--
test3.xml	26 B	-rw-r--r--
test4.xml	115 B	-rw-r--r--
utf-16-1.html	184 B	-rw-r--r--
utf-16-2.html	354 B	-rw-r--r--
utf-16-2.xml	254 B	-rw-r--r--
xmllibxmldocs.pl	19.18 KB	-rw-r--r--
xpath.pl	1 KB	-rw-r--r--

Code Editor : test.html

<HTML>
<HEAD>
<TITLE>XML::LibXML::Document - DOM Document Class</TITLE>
<LINK REV="made" HREF="mailto:root@updates.mandrakesoft.com">
</HEAD>

<BODY>

<UL>

<LI><A HREF="#NAME">NAME</A>
	<LI><A HREF="#SYNOPSIS">SYNOPSIS</A>
	<LI><A HREF="#DESCRIPTION">DESCRIPTION</A>
	<UL>

<LI><A HREF="#Methods">Methods</A>
	</UL>

<LI><A HREF="#SEE_ALSO">SEE ALSO</A>
	<LI><A HREF="#VERSION">VERSION</A>
</UL>

<HR>

<H1><A NAME="NAME">NAME</A></H1>

XML::LibXML::Document - DOM Document Class

<HR>
<H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1>

<PRE> use XML::LibXML::Document;
</PRE>

<PRE> $dom = XML::LibXML::Document-&gt;new( $version, $encoding );
 $dom = XML::LibXML::Document-&gt;createDocument( $version, $encoding );
 $strEncoding = $doc-&gt;getEncoding();
 $strVersion = $doc-&gt;getVersion();
 $docstring = $dom-&gt;toString([$format]);
 $bool = $dom-&gt;is_valid();
 $root = $dom-&gt;getDocumentElement($name, $namespace );
 $dom-&gt;setDocumentElement( $root );
 $element = $dom-&gt;createElement( $nodename );
 $element = $dom-&gt;createElementNS( $namespaceURI, $qname );
 $text = $dom-&gt;createTextNode( $content_text );
 $comment = $dom-&gt;createComment( $comment_text );
 $attrnode = $doc-&gt;createAttribute($name [,$value]);
 $attrnode = $doc-&gt;createAttributeNS( namespaceURI, $name [,$value] );
 $cdata = $dom-&gt;create( $cdata_content );
 $document-&gt;importNode( $node [, $move] );
</PRE>

<HR>
<H1><A NAME="DESCRIPTION">DESCRIPTION</A></H1>

The Document Class is the result of a parsing process. But sometimes it is
necessary to create a Document from scratch. The DOM Document Class
provides functions that are conform to the DOM Core naming style. It
inherits all functions from XML::LibXML::Node as specified in DOM Level2. This enables to access the nodes beside the
root element on document level - a DTD for example. The support for these nodes is limited at the moment, so I
would recommend, not to use node functions on documents. It is suggested that one should always create a node not bound to any
document. There is no need of really including the node to the document,
but once the node is bound to a document, it is quite safe that all strings
have the correct encoding. If an unbound textnode with an iso encoded
string is created (e.g. with $CLASS-&gt;new()), the toString function may not return the expected result. This seems like a limitation
as long UTF8 encoding is assured. If iso encoded strings come into play it
is much safer to use the node creation functions of XML::LibXML::Document.

<HR>
<H2><A NAME="Methods">Methods</A></H2>
<DL>
<DT><A NAME="item_new">new</A><DD>

alias for <CODE>createDocument()</CODE>

<DT><A NAME="item_createDocument">createDocument</A><DD>

The constructor for the document class. As Parameter it takes the version
string and (optionally) the ecoding string. Simply calling createDocument will create the document:

<PRE>
 &lt;?xml version=&quot;your version&quot; encoding=&quot;your encoding&quot;?&gt;
</PRE>

Both parameter are optional. The default value for $version is 1.0 , of course. If the $encoding parameter is not set, the encoding will be left unset, which means UTF8 is
implied (and set). The call of createDocument without any parameter will result the following code:

<PRE>
 &lt;?xml version=&quot;1.0&quot;?&gt;
</PRE>
<DT><A NAME="item_getEncoding">getEncoding</A><DD>

returns the encoding string of the document

<DT><A NAME="item_getVersion">getVersion</A><DD>

returns the version string of the document

<DT><A NAME="item_toString">toString</A><DD>

toString is a deparsing function, so the DOM Tree can be translated into a string,
ready for output. The optional $format parameter sets the indenting of the output. This parameter is expected to
be an integer value, that specifies the number of linebreaks for each node. For more
information about the formatted output check the documentation of xmlDocDumpFormatMemory in libxml2/tree.h .

<DT><A NAME="item_is_valid">is_valid</A><DD>

Returns either TRUE or FALSE depending on the DOM Tree is a valid Document
or not.

<DT><A NAME="item_getDocumentElement">getDocumentElement</A><DD>

Returns the root element of the Document. A document can have just one root
element to contain the documents data.

<DT><A NAME="item_setDocumentElement">setDocumentElement</A><DD>

This function enables you to set the root element for a document. The
function supports the import of a node from a different document tree.

<DT><A NAME="item_createElement">createElement</A><DD>

This function creates a new Element Node bound to the DOM with the name $nodename .

<DT><A NAME="item_createElementNS">createElementNS</A><DD>

This function creates a new Element Node bound to the DOM with the name $nodename and placed in the given namespace.

<DT><A NAME="item_createTextNode">createTextNode</A><DD>

As an equivalent of createElement , but it creates a Text Node bound to the DOM.

<DT><A NAME="item_createComment">createComment</A><DD>

As an equivalent of createElement , but it creates a Comment Node bound to the DOM.

<DT><A NAME="item_createAttribute">createAttribute</A><DD>

Creates a new Attribute node. This function is rather useless at the
moment, since there is no setAttributeNode function defined in XML::LibXML::Element , yet.

<DT><A NAME="item_createAttributeNS">createAttributeNS</A><DD>

Creates an Attribute bound to a namespace.

<DT><A NAME="item_createCDATASection">createCDATASection</A><DD>

Similar to createTextNode and createComment, this function creates a
CDataSection bound to the current DOM.

<DT><A NAME="item_importNode">importNode</A><DD>

If a node is not part of a document, it can be imported to another
document. As specified in DOM Level 2 Specification the Node will not be
altered or removed from its original document by default. ( $node-<CODE>cloneNode(1)&gt;</CODE> will get called implicitly). Sometimes it is
necessary to move a node between documents. In such a case the node will not be copied, but
removed from the original document.

</DL>

<HR>
<H1><A NAME="SEE_ALSO">SEE ALSO</A></H1>

XML::LibXML, XML::LibXML::Element, XML::LibXML::Text, XML::LibXML::Attr,
XML::LibXML::Comment

<HR>
<H1><A NAME="VERSION">VERSION</A></H1>

0.90_a

</BODY>

</HTML>

${this.title}

Code Editor : test.html