summaryrefslogtreecommitdiff
path: root/xsd-examples/cxx/parser/library/README
blob: c0af7fc6eb88b72e202d2849154a833f32f06db9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
This example shows how to use the C++/Parser mapping to construct
a custom in-memory object model from XML instance documents.

The example consists of the following files:

library.xsd
  XML Schema which describes a library of books.

library.xml
  Sample XML instance document.

library.hxx
  Types that describe a library of books in C++. These are
  hand-written.

library.map
  Type map. It maps XML Schema types defined in library.xsd
  to the C++ types defined in library.hxx.

library-pskel.hxx
library-pskel.ixx
library-pskel.cxx
  Parser skeletons generated by the XSD compiler from library.xsd and
  library.map using the following command line:

  xsd cxx-parser --type-map=library.map library.xsd

  Or if using Expat instead of Xerces-C++ as the underlying XML parser:

  xsd cxx-parser --xml-parser=expat --type-map=library.map library.xsd

library-pimpl.hxx
library-pimpl.cxx
  Parser implementations that construct the custom in-memory
  object model from an XML instance using the types from
  library.hxx. These are hand-written implementations of
  the parser skeletons defined in library-pskel.hxx.

driver.cxx
  Driver for the example. It first constructs a parser
  instance from all the individual parsers found in
  library-pimpl.hxx. In then invokes this parser instance
  to parse the input file and produce the in-memory
  object model. Finally, it prints the contents of the
  in-memory object model to STDERR.

To compile and link the example manually from the command line we can use
the following commands (replace 'c++' with your C++ compiler name):

c++ -c library-pskel.cxx
c++ -c library-pimpl.cxx
c++ -c driver.cxx
c++ -o driver driver.o library-pskel.o library-pimpl.o -lxerces-c

Or if using Expat as the underlying XML parser:

c++ -o driver driver.o library-pskel.o library-pimpl.o -lexpat

To run the example on the sample XML instance document execute:

./driver library.xml