This directory contains a number of examples that show how to use
the C++/Tree mapping. The following list gives an overview of
each example. See the README files in example directories for
more information on each example.

hello
  A simple "Hello, world!" example that shows how to parse XML
  documents.

library
  Shows hot to handle more complicated data structures, use the
  ID/IDREF cross-referencing mechanism, use the xsd:enumeration
  to C++ enum mapping, modify the object model, and serialize
  the modified object model back to XML.

polymorphism
  Shows how to use XML Schema polymorphism features such as the
  xsi:type attribute and substitution groups.

wildcard
  Shows how to use the optional wildcard mapping to parse, access,
  modify, and serialize the XML data matched by XML Schema wildcards
  (any and anyAttribute).

mixed
  Shows how to access the underlying DOM nodes to handle raw, "type-
  less content" such as mixed content models, anyType/anySimpleType,
  and any/anyAttribute.

multiroot
  Shows how to handle XML vocabularies with multiple root elements.

caching
  Shows how to parse several XML documents while reusing the
  underlying XML parser and caching the schemas used for validation.

custom/
  A collection of examples that show how to customize the C++/Tree
  mapping by using custom C++ classes instead of or in addition to
  the generated ones. See the accompanying README file for an
  overview of each example in this directory.

streaming
  Shows how to create an XML document by performing multiple
  serializations of its smaller parts. This can be useful when the
  document is too large to fit into memory or when the other end
  needs to start processing without waiting for the whole document
  (streaming).

binary
  Shows how to save/load the object model to/from CDR (Common Data
  Representation) binary format using ACE CDR streams.

dbxml
  Shows how to use the C++/Tree mapping on top of the Berkeley DB
  XML embedded XML database.
