summaryrefslogtreecommitdiff
path: root/examples/cxx/tree/README
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2009-09-17 07:15:29 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2009-09-17 07:15:29 +0200
commitf0510d2f90467de8e8f260b47d79a9baaf9bef17 (patch)
tree0b9929946f06a9cbe9b9e8f2a7600dae4e048f79 /examples/cxx/tree/README
Start tracking XSD with git
Diffstat (limited to 'examples/cxx/tree/README')
-rw-r--r--examples/cxx/tree/README70
1 files changed, 70 insertions, 0 deletions
diff --git a/examples/cxx/tree/README b/examples/cxx/tree/README
new file mode 100644
index 0000000..16e5ce3
--- /dev/null
+++ b/examples/cxx/tree/README
@@ -0,0 +1,70 @@
+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 complex 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.
+
+xpath
+ Shows how to use the C++/Tree mapping together with XPath.
+
+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.
+ See also the messaging example.
+
+messaging
+ Shows how to handle XML vocabularies with multiple root elements
+ using the element type and element map features of the C++/Tree
+ mapping.
+
+caching
+ Shows how to parse several XML documents while reusing the
+ underlying XML parser and caching the schemas used for validation.
+
+performance
+ Measures the performance of parsing and serialization. This example
+ also shows how to structure your code to achieve the maximum
+ performance for these two operations.
+
+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/
+ A collection of examples that show how to serialize the object model
+ into a number of predefined and custom binary formats.
+
+dbxml
+ Shows how to use the C++/Tree mapping on top of the Berkeley DB
+ XML embedded XML database.