mirror of
https://gitlab.gnome.org/GNOME/libxml2
synced 2025-03-28 21:33:13 +00:00
5706b6d876
Makefile.am:
* Don't use @VAR@, use $(VAR). Autoconf's AC_SUBST provides us the Make
variable, it allows overriding the value at the command line, and
(notably) it avoids a Make parse error in the libxml2_la_LDFLAGS
assignment when @MODULE_PLATFORM_LIBS@ is empty
* Changed how the THREADS_W32 mechanism switches the build between
testThreads.c and testThreadsWin32.c as appropriate; using AM_CONDITIONAL
allows this to work cleanly and plays well with dependencies
* testapi.c should be specified as BUILT_SOURCES
* Create symlinks to the test/ and result/ subdirs so that the runtests
target is usable in out-of-source-tree builds
* Don't do MAKEFLAGS+=--silent as this is not portable to non-GNU Makes
* Fixed incorrect find(1) syntax in the "cleanup" rule, and doing "rm -f"
instead of just "rm" is good form
* (DIST)CLEANFILES needed a bit more coverage to allow "make distcheck" to
pass
configure.in:
* Need AC_PROG_LN_S to create test/ and result/ symlinks in Makefile.am
* AC_LIBTOOL_WIN32_DLL and AM_PROG_LIBTOOL are obsolete; these have been
superceded by LT_INIT
* Don't rebuild docs by default, as this requires GNU Make (as
implemented)
* Check for uint32_t as some platforms don't provide it
* Check for some more functions, and undefine HAVE_MMAP if we don't also
HAVE_MUNMAP (one system I tested on actually needed this)
* Changed THREADS_W32 from a filename insert into an Automake conditional
* The "Copyright" file will not be in the current directory if builddir !=
srcdir
doc/Makefile.am:
* EXTRA_DIST cannot use wildcards when they refer to generated files; this
breaks dependencies. What I did was define EXTRA_DIST_wc, which uses GNU
Make $(wildcard) directives to build up a list of files, and EXTRA_DIST,
as a literal expansion of EXTRA_DIST_wc. I also added a new rule,
"check-extra-dist", to simplify checking that the two variables are
equivalent. (Note that this works only when builddir == srcdir)
(I can implement this differently if desired; this is just one way of
doing it)
* Don't define an "all" target; this steps on Automake's toes
* Fixed up the "libxml2-api.xml ..." rule by using $(wildcard) for
dependencies (as Make doesn't process the wildcards otherwise) and
qualifying appropriate files with $(srcdir)
(Note that $(srcdir) is not needed in the dependencies, thanks to VPATH,
which we can count on as this is GNU-Make-only code anyway)
doc/devhelp/Makefile.am:
* Qualified appropriate files with $(srcdir)
* Added an "uninstall-local" rule so that "make distcheck" passes
doc/examples/Makefile.am:
* Rather than use a wildcard that doesn't work, use a substitution that
most Make programs can handle
doc/examples/index.py:
* Do the same here
include/libxml/nanoftp.h:
* Some platforms (e.g. MSVC 6) already #define INVALID_SOCKET:
user@host:/cygdrive/c/Program Files/Microsoft Visual Studio/VC98/\
Include$ grep -R INVALID_SOCKET .
./WINSOCK.H:#define INVALID_SOCKET (SOCKET)(~0)
./WINSOCK2.H:#define INVALID_SOCKET (SOCKET)(~0)
include/libxml/xmlversion.h.in:
* Support ancient GCCs (I was actually able to build the library with 2.5
but for this bit)
python/Makefile.am:
* Expanded CLEANFILES to allow "make distcheck" to pass
python/tests/Makefile.am:
* Define CLEANFILES instead of a "clean" rule, and added tmp.xml to allow
"make distcheck" to pass
testRelax.c:
* Use HAVE_MMAP instead of the less explicit HAVE_SYS_MMAN_H (as some
systems have the header but not the function)
testSchemas.c:
* Use HAVE_MMAP instead of the less explicit HAVE_SYS_MMAN_H
testapi.c:
* Don't use putenv() if it's not available
threads.c:
* This fixes the following build error on Solaris 8:
libtool: compile: cc -DHAVE_CONFIG_H -I. -I./include -I./include \
-D_REENTRANT -D__EXTENSIONS__ -D_REENTRANT -Dsparc -Xa -mt -v \
-xarch=v9 -xcrossfile -xO5 -c threads.c -KPIC -DPIC -o threads.o
"threads.c", line 442: controlling expressions must have scalar type
"threads.c", line 512: controlling expressions must have scalar type
cc: acomp failed for threads.c
*** Error code 1
trio.c:
* Define isascii() if the system doesn't provide it
trio.h:
* The trio library's HAVE_CONFIG_H header is not the same as LibXML2's
HAVE_CONFIG_H header; this change is needed to avoid a double-inclusion
win32/configure.js:
* Added support for the LZMA compression option
win32/Makefile.{bcb,mingw,msvc}:
* Added appropriate bits to support WITH_LZMA=1
* Install the header files under $(INCPREFIX)\libxml2\libxml instead of
$(INCPREFIX)\libxml, to mirror the install location on Unix+Autotools
xml2-config.in:
* @MODULE_PLATFORM_LIBS@ (usually "-ldl") needs to be in there in order for
`xml2-config --libs` to provide a complete set of dependencies
xmllint.c:
* Use HAVE_MMAP instead of the less-explicit HAVE_SYS_MMAN_H
752 lines
31 KiB
XML
752 lines
31 KiB
XML
<examples>
|
|
<example filename='xpath1.c'>
|
|
<synopsis>Evaluate XPath expression and prints result node set.</synopsis>
|
|
<purpose>Shows how to evaluate XPath expression and register known namespaces in XPath context.</purpose>
|
|
<usage>xpath1 <xml-file> <xpath-expr> [<known-ns-list>]</usage>
|
|
<test>./xpath1 test3.xml '//child2' > xpath1.tmp ; diff xpath1.tmp xpath1.res ; rm xpath1.tmp</test>
|
|
<author>Aleksey Sanin</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>XPath</section>
|
|
<includes>
|
|
<include><libxml/parser.h></include>
|
|
<include><libxml/xpath.h></include>
|
|
<include><libxml/xpathInternals.h></include>
|
|
<include><libxml/tree.h></include>
|
|
</includes>
|
|
<uses>
|
|
<enum line='229' file='tree' name='XML_ELEMENT_NODE'/>
|
|
<typedef line='88' file='xpath' name='xmlXPathObjectPtr'/>
|
|
<function line='54' file='xmlmemory' name='xmlMemoryDump'/>
|
|
<function line='117' file='xpath' name='xmlXPathEvalExpression'/>
|
|
<function line='94' file='parser' name='xmlParseFile'/>
|
|
<function line='186' file='xpathInternals' name='xmlXPathRegisterNs'/>
|
|
<function line='129' file='xpath' name='xmlXPathFreeObject'/>
|
|
<variable line='193' file='globals' name='xmlFree'/>
|
|
<typedef line='218' file='tree' name='xmlNsPtr'/>
|
|
<function line='101' file='xpath' name='xmlXPathNewContext'/>
|
|
<function line='49' file='parser' name='xmlCleanupParser'/>
|
|
<macro line='43' file='xmlversion' name='LIBXML_TEST_VERSION'/>
|
|
<typedef line='87' file='xpath' name='xmlXPathContextPtr'/>
|
|
<function line='130' file='xpath' name='xmlXPathFreeContext'/>
|
|
<function line='39' file='parser' name='xmlInitParser'/>
|
|
<function line='156' file='xmlstring' name='xmlStrdup'/>
|
|
<function line='131' file='tree' name='xmlFreeDoc'/>
|
|
<function line='180' file='xmlstring' name='xmlStrchr'/>
|
|
<typedef line='206' file='tree' name='xmlNodePtr'/>
|
|
<typedef line='86' file='tree' name='xmlDocPtr'/>
|
|
<enum line='217' file='tree' name='XML_NAMESPACE_DECL'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='parse3.c'>
|
|
<synopsis>Parse an XML document in memory to a tree and free it</synopsis>
|
|
<purpose>Demonstrate the use of xmlReadMemory() to read an XML file into a tree and and xmlFreeDoc() to free the resulting tree</purpose>
|
|
<usage>parse3</usage>
|
|
<test>parse3</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>Parsing</section>
|
|
<includes>
|
|
<include><libxml/tree.h></include>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='33' file='parser' name='xmlReadMemory'/>
|
|
<function line='58' file='xmlmemory' name='xmlMemoryDump'/>
|
|
<function line='54' file='parser' name='xmlCleanupParser'/>
|
|
<macro line='49' file='xmlversion' name='LIBXML_TEST_VERSION'/>
|
|
<function line='38' file='tree' name='xmlFreeDoc'/>
|
|
<typedef line='27' file='tree' name='xmlDocPtr'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='reader2.c'>
|
|
<synopsis>Parse and validate an XML file with an xmlReader</synopsis>
|
|
<purpose>Demonstrate the use of xmlReaderForFile() to parse an XML file validating the content in the process and activating options like entities substitution, and DTD attributes defaulting. (Note that the XMLReader functions require libxml2 version later than 2.6.)</purpose>
|
|
<usage>reader2 <valid_xml_filename></usage>
|
|
<test>reader2 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>xmlReader</section>
|
|
<includes>
|
|
<include><libxml/xmlreader.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='45' file='xmlstring' name='xmlStrlen'/>
|
|
<function line='109' file='parser' name='xmlCleanupParser'/>
|
|
<function line='38' file='xmlreader' name='xmlTextReaderNodeType'/>
|
|
<typedef line='60' file='xmlreader' name='xmlTextReaderPtr'/>
|
|
<function line='113' file='xmlmemory' name='xmlMemoryDump'/>
|
|
<function line='34' file='xmlreader' name='xmlTextReaderConstValue'/>
|
|
<enum line='70' file='parser' name='XML_PARSE_NOENT'/>
|
|
<function line='37' file='xmlreader' name='xmlTextReaderDepth'/>
|
|
<enum line='71' file='parser' name='XML_PARSE_DTDVALID'/>
|
|
<enum line='69' file='parser' name='XML_PARSE_DTDATTR'/>
|
|
<function line='84' file='xmlreader' name='xmlFreeTextReader'/>
|
|
<macro line='104' file='xmlversion' name='LIBXML_TEST_VERSION'/>
|
|
<function line='30' file='xmlreader' name='xmlTextReaderConstName'/>
|
|
<function line='41' file='xmlreader' name='xmlTextReaderHasValue'/>
|
|
<function line='76' file='xmlreader' name='xmlTextReaderRead'/>
|
|
<function line='40' file='xmlreader' name='xmlTextReaderIsEmptyElement'/>
|
|
<function line='68' file='xmlreader' name='xmlReaderForFile'/>
|
|
<function line='81' file='xmlreader' name='xmlTextReaderIsValid'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='tree2.c'>
|
|
<synopsis>Creates a tree</synopsis>
|
|
<purpose>Shows how to create document, nodes and dump it to stdout or file.</purpose>
|
|
<usage>tree2 <filename> -Default output: stdout</usage>
|
|
<test>tree2 > tree2.tmp ; diff tree2.tmp tree2.res ; rm tree2.tmp</test>
|
|
<author>Lucas Brasilino <brasilino@recife.pe.gov.br></author>
|
|
<copy>see Copyright for the status of this software </copy>
|
|
<section>Tree</section>
|
|
<includes>
|
|
<include><libxml/tree.h></include>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='75' file='tree' name='xmlNewText'/>
|
|
<function line='110' file='xmlmemory' name='xmlMemoryDump'/>
|
|
<function line='96' file='tree' name='xmlSaveFormatFileEnc'/>
|
|
<function line='78' file='tree' name='xmlAddChild'/>
|
|
<function line='41' file='tree' name='xmlDocSetRootElement'/>
|
|
<function line='105' file='parser' name='xmlCleanupParser'/>
|
|
<macro line='34' file='xmlversion' name='LIBXML_TEST_VERSION'/>
|
|
<function line='89' file='tree' name='xmlNewProp'/>
|
|
<function line='88' file='tree' name='xmlNewChild'/>
|
|
<function line='74' file='tree' name='xmlNewNode'/>
|
|
<function line='46' file='tree' name='xmlCreateIntSubset'/>
|
|
<function line='99' file='tree' name='xmlFreeDoc'/>
|
|
<function line='39' file='tree' name='xmlNewDoc'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='io1.c'>
|
|
<synopsis>Example of custom Input/Output</synopsis>
|
|
<purpose>Demonstrate the use of xmlRegisterInputCallbacks to build a custom I/O layer, this is used in an XInclude method context to show how dynamic document can be built in a clean way.</purpose>
|
|
<usage>io1</usage>
|
|
<test>io1 > io1.tmp ; diff io1.tmp io1.res ; rm -f io1.tmp</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>InputOutput</section>
|
|
<includes>
|
|
<include><libxml/parser.h></include>
|
|
<include><libxml/xmlIO.h></include>
|
|
<include><libxml/xinclude.h></include>
|
|
<include><libxml/tree.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='143' file='tree' name='xmlDocDump'/>
|
|
<function line='158' file='xmlmemory' name='xmlMemoryDump'/>
|
|
<function line='149' file='tree' name='xmlFreeDoc'/>
|
|
<function line='154' file='parser' name='xmlCleanupParser'/>
|
|
<macro line='117' file='xmlversion' name='LIBXML_TEST_VERSION'/>
|
|
<function line='134' file='xinclude' name='xmlXIncludeProcess'/>
|
|
<function line='117' file='xmlIO' name='xmlRegisterInputCallbacks'/>
|
|
<function line='124' file='parser' name='xmlReadMemory'/>
|
|
<typedef line='105' file='tree' name='xmlDocPtr'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='parse4.c'>
|
|
<synopsis>Parse an XML document chunk by chunk to a tree and free it</synopsis>
|
|
<purpose>Demonstrate the use of xmlCreatePushParserCtxt() and xmlParseChunk() to read an XML file progressively into a tree and and xmlFreeDoc() to free the resulting tree</purpose>
|
|
<usage>parse4 test3.xml</usage>
|
|
<test>parse4 test3.xml</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>Parsing</section>
|
|
<includes>
|
|
<include><libxml/tree.h></include>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='94' file='parser' name='xmlFreeParserCtxt'/>
|
|
<function line='86' file='parser' name='xmlParseChunk'/>
|
|
<function line='103' file='tree' name='xmlFreeDoc'/>
|
|
<function line='135' file='xmlmemory' name='xmlMemoryDump'/>
|
|
<function line='67' file='parser' name='xmlCreatePushParserCtxt'/>
|
|
<function line='131' file='parser' name='xmlCleanupParser'/>
|
|
<macro line='120' file='xmlversion' name='LIBXML_TEST_VERSION'/>
|
|
<typedef line='45' file='tree' name='xmlParserCtxtPtr'/>
|
|
<typedef line='47' file='tree' name='xmlDocPtr'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='xpath2.c'>
|
|
<synopsis>Load a document, locate subelements with XPath, modify said elements and save the resulting document.</synopsis>
|
|
<purpose>Shows how to make a full round-trip from a load/edit/save</purpose>
|
|
<usage>xpath2 <xml-file> <xpath-expr> <new-value></usage>
|
|
<test>xpath2 test3.xml '//discarded' discarded > xpath2.tmp ; diff xpath2.tmp xpath2.res ; rm xpath2.tmp</test>
|
|
<author>Aleksey Sanin and Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>XPath</section>
|
|
<includes>
|
|
<include><libxml/parser.h></include>
|
|
<include><libxml/xpath.h></include>
|
|
<include><libxml/xpathInternals.h></include>
|
|
<include><libxml/tree.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='162' file='tree' name='xmlNodeSetContent'/>
|
|
<function line='127' file='tree' name='xmlDocDump'/>
|
|
<typedef line='88' file='xpath' name='xmlXPathObjectPtr'/>
|
|
<function line='110' file='xpath' name='xmlXPathEvalExpression'/>
|
|
<function line='95' file='parser' name='xmlParseFile'/>
|
|
<function line='123' file='xpath' name='xmlXPathFreeObject'/>
|
|
<function line='102' file='xpath' name='xmlXPathNewContext'/>
|
|
<typedef line='87' file='xpath' name='xmlXPathContextPtr'/>
|
|
<function line='124' file='xpath' name='xmlXPathFreeContext'/>
|
|
<function line='41' file='parser' name='xmlInitParser'/>
|
|
<function line='131' file='tree' name='xmlFreeDoc'/>
|
|
<enum line='180' file='tree' name='XML_NAMESPACE_DECL'/>
|
|
<typedef line='86' file='tree' name='xmlDocPtr'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='io2.c'>
|
|
<synopsis>Output to char buffer</synopsis>
|
|
<purpose>Demonstrate the use of xmlDocDumpMemory to output document to a character buffer</purpose>
|
|
<usage>io2</usage>
|
|
<test>io2 > io2.tmp ; diff io2.tmp io2.res ; rm -f io2.tmp</test>
|
|
<author>John Fleck</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>InputOutput</section>
|
|
<includes>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='29' file='tree' name='xmlNodeSetContent'/>
|
|
<function line='36' file='tree' name='xmlDocDumpFormatMemory'/>
|
|
<variable line='42' file='globals' name='xmlFree'/>
|
|
<function line='30' file='tree' name='xmlDocSetRootElement'/>
|
|
<typedef line='20' file='tree' name='xmlDocPtr'/>
|
|
<typedef line='19' file='tree' name='xmlNodePtr'/>
|
|
<function line='27' file='tree' name='xmlNewDoc'/>
|
|
<function line='28' file='tree' name='xmlNewNode'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='reader1.c'>
|
|
<synopsis>Parse an XML file with an xmlReader</synopsis>
|
|
<purpose>Demonstrate the use of xmlReaderForFile() to parse an XML file and dump the informations about the nodes found in the process. (Note that the XMLReader functions require libxml2 version later than 2.6.)</purpose>
|
|
<usage>reader1 <filename></usage>
|
|
<test>reader1 test2.xml > reader1.tmp ; diff reader1.tmp reader1.res ; rm reader1.tmp</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>xmlReader</section>
|
|
<includes>
|
|
<include><libxml/xmlreader.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='44' file='xmlstring' name='xmlStrlen'/>
|
|
<function line='37' file='xmlreader' name='xmlTextReaderNodeType'/>
|
|
<typedef line='59' file='xmlreader' name='xmlTextReaderPtr'/>
|
|
<function line='33' file='xmlreader' name='xmlTextReaderConstValue'/>
|
|
<function line='36' file='xmlreader' name='xmlTextReaderDepth'/>
|
|
<function line='69' file='xmlreader' name='xmlFreeTextReader'/>
|
|
<function line='29' file='xmlreader' name='xmlTextReaderConstName'/>
|
|
<function line='40' file='xmlreader' name='xmlTextReaderHasValue'/>
|
|
<function line='67' file='xmlreader' name='xmlTextReaderRead'/>
|
|
<function line='39' file='xmlreader' name='xmlTextReaderIsEmptyElement'/>
|
|
<function line='62' file='xmlreader' name='xmlReaderForFile'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='tree1.c'>
|
|
<synopsis>Navigates a tree to print element names</synopsis>
|
|
<purpose>Parse a file to a tree, use xmlDocGetRootElement() to get the root element, then walk the document and print all the element name in document order.</purpose>
|
|
<usage>tree1 filename_or_URL</usage>
|
|
<test>tree1 test2.xml > tree1.tmp ; diff tree1.tmp tree1.res ; rm tree1.tmp</test>
|
|
<author>Dodji Seketeli</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>Tree</section>
|
|
<includes>
|
|
<include><libxml/tree.h></include>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<enum line='36' file='tree' name='XML_ELEMENT_NODE'/>
|
|
<function line='74' file='tree' name='xmlDocGetRootElement'/>
|
|
<function line='67' file='parser' name='xmlReadFile'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='reader3.c'>
|
|
<synopsis>Show how to extract subdocuments with xmlReader</synopsis>
|
|
<purpose>Demonstrate the use of xmlTextReaderPreservePattern() to parse an XML file with the xmlReader while collecting only some subparts of the document. (Note that the XMLReader functions require libxml2 version later than 2.6.)</purpose>
|
|
<usage>reader3</usage>
|
|
<test>reader3 > reader3.tmp ; diff reader3.tmp reader3.res ; rm reader3.tmp</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>xmlReader</section>
|
|
<includes>
|
|
<include><libxml/xmlreader.h></include>
|
|
</includes>
|
|
<uses>
|
|
<typedef line='32' file='xmlreader' name='xmlTextReaderPtr'/>
|
|
<function line='66' file='xmlreader' name='xmlFreeTextReader'/>
|
|
<function line='96' file='tree' name='xmlDocDump'/>
|
|
<function line='52' file='xmlreader' name='xmlTextReaderRead'/>
|
|
<function line='62' file='xmlreader' name='xmlTextReaderCurrentDoc'/>
|
|
<function line='43' file='xmlreader' name='xmlTextReaderPreservePattern'/>
|
|
<function line='38' file='xmlreader' name='xmlReaderForFile'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='parse2.c'>
|
|
<synopsis>Parse and validate an XML file to a tree and free the result</synopsis>
|
|
<purpose>Create a parser context for an XML file, then parse and validate the file, creating a tree, check the validation result and xmlFreeDoc() to free the resulting tree.</purpose>
|
|
<usage>parse2 test2.xml</usage>
|
|
<test>parse2 test2.xml</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>Parsing</section>
|
|
<includes>
|
|
<include><libxml/tree.h></include>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='47' file='parser' name='xmlFreeParserCtxt'/>
|
|
<enum line='35' file='parser' name='XML_PARSE_DTDVALID'/>
|
|
<function line='29' file='parser' name='xmlNewParserCtxt'/>
|
|
<typedef line='25' file='tree' name='xmlParserCtxtPtr'/>
|
|
<function line='35' file='parser' name='xmlCtxtReadFile'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='parse1.c'>
|
|
<synopsis>Parse an XML file to a tree and free it</synopsis>
|
|
<purpose>Demonstrate the use of xmlReadFile() to read an XML file into a tree and and xmlFreeDoc() to free the resulting tree</purpose>
|
|
<usage>parse1 test1.xml</usage>
|
|
<test>parse1 test1.xml</test>
|
|
<author>Daniel Veillard</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>Parsing</section>
|
|
<includes>
|
|
<include><libxml/tree.h></include>
|
|
<include><libxml/parser.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='26' file='parser' name='xmlReadFile'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='reader4.c'>
|
|
<synopsis>Parse multiple XML files reusing an xmlReader</synopsis>
|
|
<purpose>Demonstrate the use of xmlReaderForFile() and xmlReaderNewFile to parse XML files while reusing the reader object and parser context. (Note that the XMLReader functions require libxml2 version later than 2.6.)</purpose>
|
|
<usage>reader4 <filename> [ filename ... ]</usage>
|
|
<test>reader4 test1.xml test2.xml test3.xml > reader4.tmp ; diff reader4.tmp reader4.res ; rm reader4.tmp</test>
|
|
<author>Graham Bennett</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>xmlReader</section>
|
|
<includes>
|
|
<include><libxml/xmlreader.h></include>
|
|
</includes>
|
|
<uses>
|
|
<typedef line='54' file='xmlreader' name='xmlTextReaderPtr'/>
|
|
<function line='83' file='xmlreader' name='xmlReaderNewFile'/>
|
|
<function line='104' file='xmlreader' name='xmlFreeTextReader'/>
|
|
<function line='26' file='xmlreader' name='xmlTextReaderRead'/>
|
|
<function line='97' file='xmlreader' name='xmlTextReaderCurrentDoc'/>
|
|
<function line='72' file='xmlreader' name='xmlReaderForFile'/>
|
|
</uses>
|
|
</example>
|
|
<example filename='testWriter.c'>
|
|
<synopsis>use various APIs for the xmlWriter</synopsis>
|
|
<purpose>tests a number of APIs for the xmlWriter, especially the various methods to write to a filename, to a memory buffer, to a new document, or to a subtree. It shows how to do encoding string conversions too. The resulting documents are then serialized.</purpose>
|
|
<usage>testWriter</usage>
|
|
<test>testWriter ; for i in 1 2 3 4 ; do diff writer.xml writer$$i.res ; done ; rm writer*.res</test>
|
|
<author>Alfred Mickautsch</author>
|
|
<copy>see Copyright for the status of this software. </copy>
|
|
<section>xmlWriter</section>
|
|
<includes>
|
|
<include><libxml/encoding.h></include>
|
|
<include><libxml/xmlwriter.h></include>
|
|
</includes>
|
|
<uses>
|
|
<function line='913' file='xmlwriter' name='xmlTextWriterStartDocument'/>
|
|
<function line='1121' file='xmlwriter' name='xmlTextWriterEndDocument'/>
|
|
<variable line='1183' file='globals' name='xmlRealloc'/>
|
|
<function line='925' file='xmlwriter' name='xmlTextWriterWriteComment'/>
|
|
<function line='1156' file='encoding' name='xmlFindCharEncodingHandler'/>
|
|
<variable line='1166' file='globals' name='xmlMalloc'/>
|
|
<typedef line='341' file='tree' name='xmlBufferPtr'/>
|
|
<macro line='885' file='parser' name='XML_DEFAULT_VERSION'/>
|
|
<function line='901' file='tree' name='xmlDocSetRootElement'/>
|
|
<function line='1127' file='xmlwriter' name='xmlFreeTextWriter'/>
|
|
<function line='1096' file='xmlwriter' name='xmlTextWriterStartElement'/>
|
|
<function line='347' file='tree' name='xmlBufferCreate'/>
|
|
<function line='1111' file='xmlwriter' name='xmlTextWriterEndElement'/>
|
|
<function line='76' file='xmlwriter' name='xmlNewTextWriterFilename'/>
|
|
<function line='959' file='xmlwriter' name='xmlTextWriterWriteFormatComment'/>
|
|
<function line='1073' file='xmlwriter' name='xmlTextWriterWriteFormatElement'/>
|
|
<typedef line='1151' file='encoding' name='xmlCharEncodingHandlerPtr'/>
|
|
<typedef line='880' file='tree' name='xmlNodePtr'/>
|
|
<function line='949' file='xmlwriter' name='xmlTextWriterWriteAttribute'/>
|
|
<function line='632' file='xmlwriter' name='xmlNewTextWriterDoc'/>
|
|
<function line='894' file='tree' name='xmlNewDocNode'/>
|
|
<function line='1129' file='tree' name='xmlSaveFileEnc'/>
|
|
<function line='904' file='xmlwriter' name='xmlNewTextWriterTree'/>
|
|
<function line='355' file='xmlwriter' name='xmlNewTextWriterMemory'/>
|
|
<variable line='1180' file='globals' name='xmlFree'/>
|
|
<function line='613' file='tree' name='xmlBufferFree'/>
|
|
<typedef line='878' file='xmlwriter' name='xmlTextWriterPtr'/>
|
|
<function line='1103' file='xmlwriter' name='xmlTextWriterWriteElement'/>
|
|
<function line='885' file='tree' name='xmlNewDoc'/>
|
|
</uses>
|
|
</example>
|
|
<symbols>
|
|
<symbol name='LIBXML_TEST_VERSION'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='parse3.c'/>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io1.c'/>
|
|
<ref filename='parse4.c'/>
|
|
</symbol>
|
|
<symbol name='XML_DEFAULT_VERSION'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='XML_ELEMENT_NODE'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='tree1.c'/>
|
|
</symbol>
|
|
<symbol name='XML_NAMESPACE_DECL'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='XML_PARSE_DTDATTR'>
|
|
<ref filename='reader2.c'/>
|
|
</symbol>
|
|
<symbol name='XML_PARSE_DTDVALID'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='parse2.c'/>
|
|
</symbol>
|
|
<symbol name='XML_PARSE_NOENT'>
|
|
<ref filename='reader2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlAddChild'>
|
|
<ref filename='tree2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlBufferCreate'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlBufferFree'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlBufferPtr'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlCharEncodingHandlerPtr'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlCleanupParser'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='parse3.c'/>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io1.c'/>
|
|
<ref filename='parse4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlCreateIntSubset'>
|
|
<ref filename='tree2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlCreatePushParserCtxt'>
|
|
<ref filename='parse4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlCtxtReadFile'>
|
|
<ref filename='parse2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlDocDump'>
|
|
<ref filename='io1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
<ref filename='reader3.c'/>
|
|
</symbol>
|
|
<symbol name='xmlDocDumpFormatMemory'>
|
|
<ref filename='io2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlDocGetRootElement'>
|
|
<ref filename='tree1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlDocPtr'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='parse3.c'/>
|
|
<ref filename='io1.c'/>
|
|
<ref filename='parse4.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
<ref filename='io2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlDocSetRootElement'>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io2.c'/>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlFindCharEncodingHandler'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlFree'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='io2.c'/>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlFreeDoc'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='parse3.c'/>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io1.c'/>
|
|
<ref filename='parse4.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlFreeParserCtxt'>
|
|
<ref filename='parse4.c'/>
|
|
<ref filename='parse2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlFreeTextReader'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
<ref filename='reader3.c'/>
|
|
<ref filename='reader4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlFreeTextWriter'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlInitParser'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlMalloc'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlMemoryDump'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='parse3.c'/>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io1.c'/>
|
|
<ref filename='parse4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewChild'>
|
|
<ref filename='tree2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewDoc'>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io2.c'/>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewDocNode'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewNode'>
|
|
<ref filename='tree2.c'/>
|
|
<ref filename='io2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewParserCtxt'>
|
|
<ref filename='parse2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewProp'>
|
|
<ref filename='tree2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewText'>
|
|
<ref filename='tree2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewTextWriterDoc'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewTextWriterFilename'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewTextWriterMemory'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNewTextWriterTree'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNodePtr'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='io2.c'/>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNodeSetContent'>
|
|
<ref filename='xpath2.c'/>
|
|
<ref filename='io2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlNsPtr'>
|
|
<ref filename='xpath1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlParseChunk'>
|
|
<ref filename='parse4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlParseFile'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlParserCtxtPtr'>
|
|
<ref filename='parse4.c'/>
|
|
<ref filename='parse2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlReadFile'>
|
|
<ref filename='tree1.c'/>
|
|
<ref filename='parse1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlReadMemory'>
|
|
<ref filename='parse3.c'/>
|
|
<ref filename='io1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlReaderForFile'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
<ref filename='reader3.c'/>
|
|
<ref filename='reader4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlReaderNewFile'>
|
|
<ref filename='reader4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlRealloc'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlRegisterInputCallbacks'>
|
|
<ref filename='io1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlSaveFileEnc'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlSaveFormatFileEnc'>
|
|
<ref filename='tree2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlStrchr'>
|
|
<ref filename='xpath1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlStrdup'>
|
|
<ref filename='xpath1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlStrlen'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderConstName'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderConstValue'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderCurrentDoc'>
|
|
<ref filename='reader3.c'/>
|
|
<ref filename='reader4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderDepth'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderHasValue'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderIsEmptyElement'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderIsValid'>
|
|
<ref filename='reader2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderNodeType'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderPreservePattern'>
|
|
<ref filename='reader3.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderPtr'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
<ref filename='reader3.c'/>
|
|
<ref filename='reader4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextReaderRead'>
|
|
<ref filename='reader2.c'/>
|
|
<ref filename='reader1.c'/>
|
|
<ref filename='reader3.c'/>
|
|
<ref filename='reader4.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterEndDocument'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterEndElement'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterPtr'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterStartDocument'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterStartElement'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterWriteAttribute'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterWriteComment'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterWriteElement'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterWriteFormatComment'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlTextWriterWriteFormatElement'>
|
|
<ref filename='testWriter.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXIncludeProcess'>
|
|
<ref filename='io1.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathContextPtr'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathEvalExpression'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathFreeContext'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathFreeObject'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathNewContext'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathObjectPtr'>
|
|
<ref filename='xpath1.c'/>
|
|
<ref filename='xpath2.c'/>
|
|
</symbol>
|
|
<symbol name='xmlXPathRegisterNs'>
|
|
<ref filename='xpath1.c'/>
|
|
</symbol>
|
|
</symbols>
|
|
<sections>
|
|
<section name='InputOutput'>
|
|
<example filename='io1.c'/>
|
|
<example filename='io2.c'/>
|
|
</section>
|
|
<section name='Parsing'>
|
|
<example filename='parse3.c'/>
|
|
<example filename='parse4.c'/>
|
|
<example filename='parse2.c'/>
|
|
<example filename='parse1.c'/>
|
|
</section>
|
|
<section name='Tree'>
|
|
<example filename='tree2.c'/>
|
|
<example filename='tree1.c'/>
|
|
</section>
|
|
<section name='XPath'>
|
|
<example filename='xpath1.c'/>
|
|
<example filename='xpath2.c'/>
|
|
</section>
|
|
<section name='xmlReader'>
|
|
<example filename='reader2.c'/>
|
|
<example filename='reader1.c'/>
|
|
<example filename='reader3.c'/>
|
|
<example filename='reader4.c'/>
|
|
</section>
|
|
<section name='xmlWriter'>
|
|
<example filename='testWriter.c'/>
|
|
</section>
|
|
</sections>
|
|
</examples>
|