doc/tutorial/apa.html doc/tutorial/apb.html doc/tutorial/apc.html
Thu Jul 24 15:46:02 MDT 2003 John Fleck <jfleck@inkstain.net>
* doc/tutorial/apa.html
* doc/tutorial/apb.html
* doc/tutorial/apc.html
* doc/tutorial/apd.html
* doc/tutorial/ape.html
* doc/tutorial/apf.html
* doc/tutorial/apg.html
* doc/tutorial/aph.html
* doc/tutorial/ar01s02.html
* doc/tutorial/ar01s03.html
* doc/tutorial/ar01s04.html
* doc/tutorial/ar01s05.html
* doc/tutorial/ar01s06.html
* doc/tutorial/ar01s07.html
* doc/tutorial/ar01s08.html
* doc/tutorial/index.html
* doc/tutorial/ix01.html
* doc/tutorial/xmltutorial.pdf
* doc/tutorial/xmltutorial.xml
update tutorial with XPath example
diff --git a/doc/tutorial/ar01s06.html b/doc/tutorial/ar01s06.html
index 1c273b1..bf54f3e 100644
--- a/doc/tutorial/ar01s06.html
+++ b/doc/tutorial/ar01s06.html
@@ -1,31 +1,35 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Writing Attribute</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Libxml Tutorial"><link rel="up" href="index.html" title="Libxml Tutorial"><link rel="previous" href="ar01s05.html" title="Writing element content"><link rel="next" href="ar01s07.html" title="Retrieving Attributes"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Writing Attribute</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ar01s05.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ar01s07.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xmltutorialwritingattribute"></a>Writing Attribute</h2></div></div><div></div></div><p><a class="indexterm" name="id2814216"></a>
-Writing an attribute is similar to writing text to a new element. In
- this case, we'll add a reference <span class="acronym">URI</span> to our
- document. Full code:<a href="ape.html" title="E. Code for Add Attribute Example">Appendix E, <i>Code for Add Attribute Example</i></a>.</p><p>
- A <tt class="sgmltag-element">reference</tt> is a child of the <tt class="sgmltag-element">story</tt>
- element, so finding the place to put our new element and attribute is
- simple. As soon as we do the error-checking test in our
- <tt class="function">parseDoc</tt>, we are in the right spot to add our
- element. But before we do that, we need to make a declaration using a
- data type we have not seen yet:
- </p><pre class="programlisting">
- xmlAttrPtr newattr;
- </pre><p>
- We also need an extra xmlNodePtr:
- </p><pre class="programlisting">
- xmlNodePtr newnode;
- </pre><p>
- </p><p>
- The rest of <tt class="function">parseDoc</tt> is the same as before until we
- check to see if our root element is <tt class="sgmltag-element">story</tt>. If it is,
- then we know we are at the right spot to add our element:
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Writing element content</title><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="index.html" title="Libxml Tutorial"><link rel="up" href="index.html" title="Libxml Tutorial"><link rel="previous" href="ar01s05.html" title="Using XPath to Retrieve Element Content"><link rel="next" href="ar01s07.html" title="Writing Attribute"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Writing element content</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ar01s05.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ar01s07.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xmltutorialwritingcontent"></a>Writing element content</h2></div></div><div></div></div><p><a class="indexterm" name="id2814412"></a>
+ Writing element content uses many of the same steps we used above
+ — parsing the document and walking the tree. We parse the document,
+ then traverse the tree to find the place we want to insert our element. For
+ this example, we want to again find the "storyinfo" element and
+ this time insert a keyword. Then we'll write the file to disk. Full code:
+ <a href="ape.html" title="E. Code for Add Keyword Example">Appendix E, <i>Code for Add Keyword Example</i></a></p><p>
+ The main difference in this example is in
+ <tt class="function">parseStory</tt>:
</p><pre class="programlisting">
- <a name="addreferencenode"></a><img src="images/callouts/1.png" alt="1" border="0"> newnode = xmlNewTextChild (cur, NULL, "reference", NULL);
- <a name="addattributenode"></a><img src="images/callouts/2.png" alt="2" border="0"> newattr = xmlNewProp (newnode, "uri", uri);
+void
+parseStory (xmlDocPtr doc, xmlNodePtr cur, char *keyword) {
+
+ <a name="addkeyword"></a><img src="images/callouts/1.png" alt="1" border="0"> xmlNewTextChild (cur, NULL, "keyword", keyword);
+ return;
+}
</pre><p>
- </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#addreferencenode"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p>First we add a new node at the location of the current node
- pointer, <tt class="varname">cur.</tt> using the <a href="http://xmlsoft.org/html/libxml-tree.html#XMLNEWTEXTCHILD" target="_top">xmlNewTextChild</a> function.</p></td></tr></table></div><p>
- </p><p>Once the node is added, the file is written to disk just as in the
- previous example in which we added an element with text content.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ar01s07.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Writing element content </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Retrieving Attributes</td></tr></table></div></body></html>
+ </p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><a href="#addkeyword"><img src="images/callouts/1.png" alt="1" border="0"></a> </td><td valign="top" align="left"><p>The <tt class="function"><a href="http://xmlsoft.org/html/libxml-tree.html#XMLNEWTEXTCHILD" target="_top">xmlNewTextChild</a></tt>
+ function adds a new child element at the
+ current node pointer's location in the
+ tree, specified by <tt class="varname">cur</tt>.</p></td></tr></table></div><p>
+ </p><p>
+ <a class="indexterm" name="id2814512"></a>
+ Once the node has been added, we would like to write the document to
+ file. Is you want the element to have a namespace, you can add it here as
+ well. In our case, the namespace is NULL.
+ </p><pre class="programlisting">
+ xmlSaveFormatFile (docname, doc, 1);
+ </pre><p>
+ The first parameter is the name of the file to be written. You'll notice
+ it is the same as the file we just read. In this case, we just write over
+ the old file. The second parameter is a pointer to the xmlDoc
+ structure. Setting the third parameter equal to one ensures indenting on output.
+ </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ar01s07.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Using XPath to Retrieve Element Content </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Writing Attribute</td></tr></table></div></body></html>