Serialization

Contents

Release Notes

Requirements
Differences from version 1.32
Pending Issues

Requirements
Other Implementations

A Very Simple Case
Non Intrusive Version
Serializable Members
Derived Classes
Pointers
Arrays
STL Collections
Class Versioning
Splitting serialize into save/load
Archives
List of Examples

Archive Concepts

Saving Archive Concept
Loading Archive Concept
Archive Models
Exceptions
Character Sets

Serializable Concept

Primitive Types

Class Types

Member Function

Free Function

Namespaces for Free Function Overrides

Class Members

Base Classes
const Members
Templates

Splitting serialize into save/load

Non-Default Constructors

Pointers to Objects of Derived Classes

Registration
Instantiation
Selective Tracking
Runtime Casting

Serialization Wrappers

Binary Objects
strong_type
Name-Value Pairs
Composition

Class Serialization Traits

Version
Implementation Level
Object Tracking
Export Key
Abstract
Type Information Implementation
Template Serialization Traits

Models - Serialization Implementations Included in the Library

Special Considerations

Object Tracking

Exporting Class Serialization

Class Information

Archive Portability

Numerics
Traits

Binary Archives

XML Archives

Archive Exceptions

unregistered_class
invalid_signature
unsupported_version
pointer_conflict
incompatible_format
array_size_too_short
stream_error
invalid_class_name
unregistered_cast
xml_archive_parsing_error
xml_archive_tag_mismatch
xml_archive_tag_name_error

Exception Safety

Archive Class Reference

Implementation
Usage
Testing
Polymorphic Archives

Implementation Notes

Partial Function Template Ordering
Character Encoding
Template Invocation syntax
Partial Template Specialization
Specific Compiler/Library Issues GCC 3.X,4.X GCC 2.95 Intel 8.0 Visual C++ 8.0 Visual C++ 7.1 Visual C++ 7.0 Visual C++ 6.0 Borland 5.64 and 5.51 Comeau 4.3.3 Code Warrior 8.3 TRU64 Dinkumware Library STLPort 4.5.3
Code Structure Files Included by User Programs Archive Implementations Serialization Declarations Serialization Implementations Files Which Implement the Library Archive Development Archive Internals Archive Library Code Modules Dataflow Iterators

Case Studies

Template serialization - shared_ptr<class T>
shared_ptr<class T>Revisited
PIMPL
Derivation from an Existing Archive Class

Miscellaneous

extended_type_info

Motivation
Runtime Interface
Requirements
Models

void_cast

utf-8 code_cvt

BOOST_STRONG_TYPEDEF

state_saver

Dataflow Iterators

smart_cast

BOOST_STATIC_WARNING

The term "serialization" is preferred to "persistence"
Archives are not streams
typeid information is not included in archives
Compile time trap when saving a non-const value

Bibliography

Acknowledgments