Debian Codegraph @

examples/00README.txt

raw
1
2 This directory contains a number of examples which illustrate the usage
3 of "geners" package serialization and I/O facilities. Read the code
4 (it is reasonably well commented), run it, modify it and see what happens.
5
6 hello_geners.cc -- This program illustrates basic usage of "geners"
7 archives and I/O.
8
9 geners_archives.cc -- Illustrates various archives that can be used
10 for object I/O.
11
12 use_of_references.cc -- This program explains usage of archive references.
13
14 storing_arrays.cc -- This example shows how to store arrays in the archives.
15
16 storing_objects.cc -- Archive I/O of user-defined classes.
17
18 storing_user_templates.cc -- Archive I/O of user-defined templates.
19
20 storing_stl_containers.cc -- This program illustrates storage of STL
21 containers in the "geners" archives.
22
23 serializing_external_classes.cc -- This example shows how to extend the
24 "geners" package so that it can store
25 and retrieve classes which do not have
26 their own read/write methods.
27
28 serializing_external_templates.cc -- This example shows how to extend the
29 "geners" package so that it can store
30 and retrieve templates which do not
31 have their own read/write methods.
32
33 inheritance_example.cc -- This example shows how to serialize/deserialize
34 classes which belong to an inheritance hierarchy
35 using pointers and references to the base class.
36
37 external_inheritance_example.cc -- This example shows how to non-intrusively
38 serialize and deserialize classes belonging
39 to an inheritance hierarchy over which you
40 have no control (that is, you can not have
41 virtual "classId" and "write" methods).
42
43 storing_tuples.cc -- These three examples illustrate the facilities
44 optimized_tuple_io.cc provided by the "geners" package for storing
45 tuple_collections.cc tuples (heterogeneous containers introduced
46 in C++11).
47
48 To assist in serializing external templates, a boilerplate code generator
49 executable called "template_io_boilerplate" is provided in the "tools"
50 directory of this package. Run that executable without any arguments to see
51 its usage instructions.