Unicode output issues. Comment/declaration handling fixes. Add mxmldoc to build.web
Michael R Sweet
22 years ago
parent
bfc6a08cde
commit
438ded6568
@ -1,174 +1,199 @@ |
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd"> |
<!DOCTYPE html |
||||||
<HTML> |
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" |
||||||
<HEAD> |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
||||||
<TITLE>Mini-XML Home Page</TITLE> |
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
||||||
<STYLE><!-- |
<head> |
||||||
H1, H2, H3, P { font-family: sans-serif; text-align: justify; } |
<title>Mini-XML Home Page</title> |
||||||
H1.title, P.title { font-family: sans-serif; text-align: center; } |
<style><!-- |
||||||
TT, PRE, PRE A:link, PRE A:visited { font-weight: bold; color: #7f0000; } |
h1, h2, h3, p { font-family: sans-serif; text-align: justify; } |
||||||
--></STYLE> |
h1.title, p.title { font-family: sans-serif; text-align: center; } |
||||||
</HEAD> |
tt, pre, pre a:link, pre a:visited, tt a:link, tt a:visited { font-weight: bold; color: #7f0000; } |
||||||
<BODY> |
--></style> |
||||||
|
</head> |
||||||
<P CLASS="title" ALIGN="CENTER">[ <A |
<body> |
||||||
HREF="../index.html">Back to Home Page</A> ]</P> |
|
||||||
|
<p class="title" align="center">[ <a |
||||||
<H1 CLASS="title" ALIGN="CENTER">Mini-XML Home Page</H1> |
href="../index.html">Back to Home Page</a> ]</p> |
||||||
|
|
||||||
<P CLASS="title" ALIGN="CENTER">Current Release: v0.93 [ <A |
<h1 class="title" align="center">Mini-XML Home Page</h1> |
||||||
HREF="mxml-0.93.tar.gz">Download Source (.tar.gz 40k)</A> | |
|
||||||
<A HREF="CHANGES">View Change Log</A> ]</P> |
<p class="title" align="center">Current Release: v0.93 [ <a |
||||||
|
href="mxml-0.93.tar.gz">Download Source (.tar.gz 40k)</a> | |
||||||
<H2>Introduction</H2> |
<a href="CHANGES">View Change Log</a> ]</p> |
||||||
|
|
||||||
<P>Mini-XML is a small XML parsing library that you can use to |
<h2>Introduction</h2> |
||||||
|
|
||||||
|
<p>Mini-XML is a small XML parsing library that you can use to |
||||||
read XML and XML-like data files in your application without |
read XML and XML-like data files in your application without |
||||||
requiring large non-standard libraries. Mini-XML only requires |
requiring large non-standard libraries. Mini-XML only requires |
||||||
an ANSI C compatible compiler (GCC works, as do most vendors' |
an ANSI C compatible compiler (GCC works, as do most vendors' |
||||||
ANSI C compilers) and a "make" program.</P> |
ANSI C compilers) and a "make" program.</p> |
||||||
|
|
||||||
<P>Mini-XML was created to support the basic hierarchy provided |
<p>Mini-XML was created to support the basic hierarchy provided |
||||||
by XML and some simple data types, but doesn't do validation or |
by XML and some simple data types, but doesn't do validation or |
||||||
other types of processing on the data.</P> |
other types of processing on the data.</p> |
||||||
|
|
||||||
<H2>Building Mini-XML</H2> |
<h2>Building Mini-XML</h2> |
||||||
|
|
||||||
<P>Mini-XML comes with an autoconf-based configure script; just |
<p>Mini-XML comes with an autoconf-based configure script; just |
||||||
type the following command to get things going:</P> |
type the following command to get things going:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
./configure |
./configure |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>The default install prefix is /usr/local, which can be |
<p>The default install prefix is /usr/local, which can be |
||||||
overridden using the --prefix option:</P> |
overridden using the --prefix option:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
./configure --prefix=/foo |
./configure --prefix=/foo |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>Once you have configured the software, type "make" to do the |
<p>Once you have configured the software, type "make" to do the |
||||||
build and then run the test program to verify that things are |
build and then run the test program to verify that things are |
||||||
working, as follows:</P> |
working, as follows:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
make |
make |
||||||
./testmxml test.xml |
./testmxml test.xml |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<H2>Installing Mini-XML</H2> |
<h2>Installing Mini-XML</h2> |
||||||
|
|
||||||
<P>The "install" target will install Mini-XML in the lib and |
<p>The "install" target will install Mini-XML in the lib and |
||||||
include directories:</P> |
include directories:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
make install |
make install |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>Once you have installed it, use the "-lmxml" option to link |
<p>Once you have installed it, use the "-lmxml" option to link |
||||||
your application against it.</P> |
your application against it.</p> |
||||||
|
|
||||||
<H2>Documentation</H2> |
<h2>Documentation</h2> |
||||||
|
|
||||||
<P>The documentation is currently just in this page. At some |
<p>The documentation is currently just in this page. At some |
||||||
point I'll probably do some proper documentation, but for now |
point I'll probably do some proper documentation, but for now |
||||||
just read here and look at the <A |
just read here and look at the <tt><a |
||||||
HREF="testmxml.c"><TT>testmxml.c</TT></A> source file for an |
href="testmxml.c">testmxml.c</a></tt> source file for an |
||||||
example of reading and printing the contents of an XML file to |
example of reading and printing the contents of an XML file to |
||||||
stdout.</P> |
stdout.</p> |
||||||
|
|
||||||
<P>Mini-XML provides a single header file which you include:</P> |
<p>Mini-XML provides a single header file which you include:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
<A HREF="mxml.h">#include <mxml.h></A> |
<a href="mxml.h">#include <mxml.h></a> |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>Nodes are defined by the <TT>mxml_node_t</TT> structure; the |
<p>Nodes are defined by the <tt>mxml_node_t</tt> structure; the |
||||||
<TT>type</TT> member defines the node type (element, integer, |
<tt>type</tt> member defines the node type (element, integer, |
||||||
opaque, real, or text) which determines which value you want to |
opaque, real, or text) which determines which value you want to |
||||||
look at in the <TT>value</TT> union. New nodes can be created |
look at in the <tt>value</tt> union. New nodes can be created |
||||||
using the <TT>mxmlNewElement()</TT>, <TT>mxmlNewInteger()</TT>, |
using the <tt>mxmlNewElement()</tt>, <tt>mxmlNewInteger()</tt>, |
||||||
<TT>mxmlNewOpaque()</TT>, <TT>mxmlNewReal()</TT>, and |
<tt>mxmlNewOpaque()</tt>, <tt>mxmlNewReal()</tt>, and |
||||||
<TT>mxmlNewText()</TT> functions. Only elements can have child |
<tt>mxmlNewText()</tt> functions. Only elements can have child |
||||||
nodes, and the top node must be an element, usually "?xml".</P> |
nodes, and the top node must be an element, usually "?xml".</p> |
||||||
|
|
||||||
<P>You load an XML file using the <TT>mxmlLoadFile()</TT> function:</P> |
<p>You load an XML file using the <tt>mxmlLoadFile()</tt> function:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
FILE *fp; |
FILE *fp; |
||||||
mxml_node_t *tree; |
mxml_node_t *tree; |
||||||
|
|
||||||
fp = fopen("filename.xml", "r"); |
fp = fopen("filename.xml", "r"); |
||||||
tree = mxmlLoadFile(NULL, fp, MXML_NO_CALLBACK); |
tree = mxmlLoadFile(NULL, fp, MXML_NO_CALLBACK); |
||||||
fclose(fp); |
fclose(fp); |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>Similarly, you save an XML file using the <TT>mxmlSaveFile()</TT> |
<p>Similarly, you save an XML file using the <tt>mxmlSaveFile()</tt> |
||||||
function:</P> |
function:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
FILE *fp; |
FILE *fp; |
||||||
mxml_node_t *tree; |
mxml_node_t *tree; |
||||||
|
|
||||||
fp = fopen("filename.xml", "w"); |
fp = fopen("filename.xml", "w"); |
||||||
mxmlSaveFile(tree, fp); |
mxmlSaveFile(tree, fp); |
||||||
fclose(fp); |
fclose(fp); |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>You can find a named element/node using the |
<p>You can find a named element/node using the |
||||||
<TT>mxmlFindElement()</TT> function:</P> |
<tt>mxmlFindElement()</tt> function:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
mxml_node_t *node = mxmlFindElement(tree, tree, "name"); |
mxml_node_t *node = mxmlFindElement(tree, tree, "name", "attr", |
||||||
</PRE> |
"value", MXML_DESCEND); |
||||||
|
</pre> |
||||||
|
|
||||||
<P>You can also iterate with the same function: |
<p>The <tt>name</tt>, <tt>attr</tt>, and <tt>value</tt> |
||||||
|
arguments can be passed as <tt>NULL</tt> to act as wildcards, |
||||||
|
e.g.:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
|
/* Find the first "a" element */ |
||||||
|
node = mxmlFindElement(tree, tree, "a", NULL, NULL, MXML_DESCEND); |
||||||
|
|
||||||
|
/* Find the first "a" element with "href" attribute */ |
||||||
|
node = mxmlFindElement(tree, tree, "a", "href", NULL, MXML_DESCEND); |
||||||
|
|
||||||
|
/* Find the first "a" element with "href" to a URL */ |
||||||
|
node = mxmlFindElement(tree, tree, "a", "href", |
||||||
|
"http://www.easysw.com/~mike/mxml/", MXML_DESCEND); |
||||||
|
|
||||||
|
/* Find the first element with a "src" attribute*/ |
||||||
|
node = mxmlFindElement(tree, tree, NULL, "src", NULL, MXML_DESCEND); |
||||||
|
|
||||||
|
/* Find the first element with a "src" = "foo.jpg" */ |
||||||
|
node = mxmlFindElement(tree, tree, NULL, "src", "foo.jpg", MXML_DESCEND); |
||||||
|
</pre> |
||||||
|
|
||||||
|
<p>You can also iterate with the same function:</p> |
||||||
|
|
||||||
|
<pre> |
||||||
mxml_node_t *node; |
mxml_node_t *node; |
||||||
|
|
||||||
for (node = mxmlFindElement(tree, tree, "name"); |
for (node = mxmlFindElement(tree, tree, "name", NULL, NULL, MXML_DESCEND); |
||||||
node != NULL; |
node != NULL; |
||||||
node = mxmlFindElement(node, tree, "name")) |
node = mxmlFindElement(node, tree, "name", NULL, NULL, MXML_DESCEND)) |
||||||
{ |
{ |
||||||
... do something ... |
... do something ... |
||||||
} |
} |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<P>Finally, once you are done with the XML data, use the |
<p>Finally, once you are done with the XML data, use the |
||||||
<TT>mxmlDelete()</TT> function to recursively free the memory |
<tt>mxmlDelete()</tt> function to recursively free the memory |
||||||
that is used for a particular node or the entire tree:</P> |
that is used for a particular node or the entire tree:</p> |
||||||
|
|
||||||
<PRE> |
<pre> |
||||||
mxmlDelete(tree); |
mxmlDelete(tree); |
||||||
</PRE> |
</pre> |
||||||
|
|
||||||
<H2>Getting Help and Reporting Problems</H2> |
<h2>Getting Help and Reporting Problems</h2> |
||||||
|
|
||||||
<P>You can email me at "mxml <I>at</I> easysw <I>dot</I> com" to |
<p>You can email me at "mxml <i>at</i> easysw <i>dot</i> com" to |
||||||
report problems and/or ask for help. Just don't expect an |
report problems and/or ask for help. Just don't expect an |
||||||
instant response, as I get a <I>lot</I> of email...</P> |
instant response, as I get a <i>lot</i> of email...</p> |
||||||
|
|
||||||
<H2>Legal Stuff</H2> |
<h2>Legal Stuff</h2> |
||||||
|
|
||||||
<P>The Mini-XML library is Copyright 2003 by Michael Sweet.</P> |
<p>The Mini-XML library is Copyright 2003 by Michael Sweet.</p> |
||||||
|
|
||||||
<P>This library is free software; you can redistribute it |
<p>This library is free software; you can redistribute it |
||||||
and/or modify it under the terms of the GNU Library General |
and/or modify it under the terms of the GNU Library General |
||||||
Public License as published by the Free Software Foundation; |
Public License as published by the Free Software Foundation; |
||||||
either version 2 of the License, or (at your option) any |
either version 2 of the License, or (at your option) any |
||||||
later version.</P> |
later version.</p> |
||||||
|
|
||||||
<P>This library is distributed in the hope that it will be |
<p>This library is distributed in the hope that it will be |
||||||
useful, but WITHOUT ANY WARRANTY; without even the implied |
useful, but WITHOUT ANY WARRANTY; without even the implied |
||||||
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR |
||||||
PURPOSE. See the GNU Library General Public License for |
PURPOSE. See the GNU Library General Public License for |
||||||
more details.</P> |
more details.</p> |
||||||
|
|
||||||
<P>You should have received a copy of the GNU Library General |
<p>You should have received a copy of the GNU Library General |
||||||
Public License along with this library; if not, write to the |
Public License along with this library; if not, write to the |
||||||
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA |
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA |
||||||
02139, USA.</P> |
02139, USA.</p> |
||||||
|
|
||||||
</BODY> |
</body> |
||||||
</HTML> |
</html> |
||||||
|
|||||||
Loading…
Reference in new issue