Xerces-C++ comes packaged with 13 sample applications that demonstrate salient features of the parser using simple applications written on top of the SAX and DOM APIs provided by the parser. Sample XML data files are provided in the samples/data directory.

Please refer to the Build Page for Build Instructions as per specific platform.

The sample applications are dependent on the Xerces-C++ shared library (and could also depend on the ICU library if you built Xerces-C++ with ICU). Therefore, on Windows platforms you must make sure that your PATH environment variable is set properly to pick up these shared libraries at runtime.

On UNIX platforms you must ensure that LIBPATH environment variable is set properly to pick up the shared libraries at runtime. (UNIX gurus will understand here that LIBPATH actually translates to LD_LIBRARY_PATH on Solaris and Linux, SHLIB_PATH on HP-UX and stays as LIBPATH on AIX).

To set you LIBPATH (on AIX for example), you would type:

	export LIBPATH=xerces-c2_2_0/lib:$LIBPATH

On both Windows and UNIX platforms, if the parser is built with icu message loader (like IBM XML4C binaries), or message catalog loader, then you need to set another environment variable, XERCESC_NLS_HOME to point to the directory, $XERCESCROOT/msg, where the message files reside.

	set XERCESC_NLS_HOME=$XERCESCROOT\msg or export XERCESC_NLS_HOME=$XERCESCROOT/msg setenv XERCESC_NLS_HOME=$XERCESCROOT/msg

Once you have set up the environment variables, you can run the samples by opening a command window (or your shell prompt for UNIX environments).

Xerces-C++ Samples

SAXCount SAXCount counts the elements, attributes, spaces and characters in an XML file. SAXPrint SAXPrint parses an XML file and prints it out. DOMCount DOMCount counts the elements in a XML file. DOMPrint DOMPrint parses an XML file and prints it out. MemParse MemParse parses XML in a memory buffer, outputing the number of elements and attributes. Redirect Redirect redirects the input stream for external entities. PParse PParse demonstrates progressive parsing. StdInParse StdInParse demonstrates streaming XML data from standard input. EnumVal EnumVal shows how to enumerate the markup decls in a DTD Grammar. SEnumVal SEnumVal shows how to enumerate the markup decls in a Schema Grammar. CreateDOMDocument CreateDOMDocument creates a DOM tree in memory from scratch. SAX2Count SAX2Count counts the elements, attributes, spaces and characters in an XML file. SAX2Print SAX2Print parses an XML file and prints it out.