ossrv_pub/boost_apis/boost/serialization/serialization.hpp
changeset 0 e4d67989cc36
equal deleted inserted replaced
-1:000000000000 0:e4d67989cc36
       
     1 #ifndef BOOST_SERIALIZATION_SERIALIZATION_HPP
       
     2 #define BOOST_SERIALIZATION_SERIALIZATION_HPP
       
     3 
       
     4 // MS compatible compilers support #pragma once
       
     5 #if defined(_MSC_VER) && (_MSC_VER >= 1020)
       
     6 # pragma once
       
     7 #endif
       
     8 
       
     9 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
       
    10 #  pragma warning (disable : 4675) // suppress ADL warning
       
    11 #endif
       
    12 
       
    13 #include <cstddef> // size_t
       
    14 #include <boost/config.hpp>
       
    15 #if defined(BOOST_NO_STDC_NAMESPACE)
       
    16 namespace std{ 
       
    17     using ::size_t; 
       
    18 } // namespace std
       
    19 #endif
       
    20 
       
    21 #include <boost/strong_typedef.hpp>
       
    22 #include <boost/pfto.hpp>
       
    23 #include <boost/throw_exception.hpp>
       
    24 #include <boost/serialization/nvp.hpp>
       
    25 
       
    26 // incremented for each "release"
       
    27 #define BOOST_SERIALIZATION_LIBRARY_VERSION 19
       
    28 
       
    29 /////////1/////////2/////////3/////////4/////////5/////////6/////////7/////////8
       
    30 // serialization.hpp: interface for serialization system.
       
    31 
       
    32 // (C) Copyright 2002 Robert Ramey - http://www.rrsd.com . 
       
    33 // Use, modification and distribution is subject to the Boost Software
       
    34 // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
       
    35 // http://www.boost.org/LICENSE_1_0.txt)
       
    36 
       
    37 //  See http://www.boost.org for updates, documentation, and revision history.
       
    38 
       
    39 //////////////////////////////////////////////////////////////////////
       
    40 // public interface to serialization. 
       
    41 
       
    42 /////////////////////////////////////////////////////////////////////////////
       
    43 // layer 0 - intrusive verison
       
    44 // declared and implemented for each user defined class to be serialized
       
    45 //
       
    46 //  template<Archive>
       
    47 //  serialize(Archive &ar, const unsigned int file_version){
       
    48 //      ar & base_object<base>(*this) & member1 & member2 ... ;
       
    49 //  }
       
    50 
       
    51 /////////////////////////////////////////////////////////////////////////////
       
    52 // layer 1 - layer that routes member access through the access class.
       
    53 // this is what permits us to grant access to private class member functions
       
    54 // by specifying friend class boost::serialization::access
       
    55 
       
    56 #include <boost/serialization/access.hpp>
       
    57 
       
    58 /////////////////////////////////////////////////////////////////////////////
       
    59 // layer 2 - default implementation of non-intrusive serialization.
       
    60 //
       
    61 // note the usage of function overloading to compensate that C++ does not
       
    62 // currently support Partial Template Specialization for function templates 
       
    63 // We have declared the version number as "const unsigned long".  
       
    64 // Overriding templates for specific data types should declare the version
       
    65 // number as "const unsigned int". Template matching will first be applied
       
    66 // to functions with the same version types - that is the overloads.  
       
    67 // If there is no declared function prototype that matches, the second argument
       
    68 // will be converted to "const unsigned long" and a match will be made with 
       
    69 // one of the default template functions below.
       
    70 
       
    71 namespace boost {
       
    72 namespace serialization {
       
    73 
       
    74 BOOST_STRONG_TYPEDEF(unsigned int, version_type)
       
    75 
       
    76 // default implemenation - call the member function "serialize"
       
    77 template<class Archive, class T>
       
    78 inline void serialize(
       
    79     Archive & ar, T & t, const BOOST_PFTO unsigned int file_version
       
    80 ){
       
    81     access::serialize(ar, t, static_cast<unsigned int>(file_version));
       
    82 }
       
    83 
       
    84 // save data required for construction
       
    85 template<class Archive, class T>
       
    86 inline void save_construct_data(
       
    87     Archive & /*ar*/, 
       
    88     const T * /*t*/, 
       
    89     const BOOST_PFTO unsigned int /*file_version */
       
    90 ){
       
    91     // default is to save no data because default constructor
       
    92     // requires no arguments.
       
    93 }
       
    94 
       
    95 // load data required for construction and invoke constructor in place
       
    96 template<class Archive, class T>
       
    97 inline void load_construct_data(
       
    98     Archive & ar, 
       
    99     T * t, 
       
   100     const BOOST_PFTO unsigned int /*file_version*/
       
   101 ){
       
   102     // default just uses the default constructor.  going
       
   103     // through access permits usage of otherwise private default
       
   104     // constructor
       
   105     access::construct(ar, t);
       
   106 }
       
   107 
       
   108 /////////////////////////////////////////////////////////////////////////////
       
   109 // layer 3 - move call into serialization namespace so that ADL will function
       
   110 // in the manner we desire.
       
   111 //
       
   112 // on compilers which don't implement ADL. only the current namespace
       
   113 // i.e. boost::serialization will be searched.
       
   114 // 
       
   115 // on compilers which DO implement ADL
       
   116 // serialize overrides can be in any of the following
       
   117 // 
       
   118 // 1) same namepace as Archive
       
   119 // 2) same namespace as T
       
   120 // 3) boost::serialization
       
   121 //
       
   122 // Due to Martin Ecker
       
   123 
       
   124 template<class Archive, class T>
       
   125 inline void serialize_adl(
       
   126     Archive & ar, 
       
   127     T & t, 
       
   128     const unsigned int file_version
       
   129 ){
       
   130     // note usage of function overloading to delay final resolution
       
   131     // until the point of instantiation.  This works around the two-phase
       
   132     // lookup "feature" which inhibits redefintion of a default function
       
   133     // template implementation. Due to Robert Ramey
       
   134     //
       
   135     // Note that this trick generates problems for compiles which don't support
       
   136     // PFTO, suppress it here.  As far as we know, there are no compilers
       
   137     // which fail to support PFTO while supporting two-phase lookup.
       
   138     #if ! defined(BOOST_NO_FUNCTION_TEMPLATE_ORDERING)
       
   139         const version_type v(file_version);
       
   140         serialize(ar, t, v);
       
   141     #else
       
   142         serialize(ar, t, file_version);
       
   143     #endif
       
   144 }
       
   145 
       
   146 template<class Archive, class T>
       
   147 inline void save_construct_data_adl(
       
   148     Archive & ar, 
       
   149     const T * t, 
       
   150     const unsigned int file_version
       
   151 ){
       
   152     // see above
       
   153     #if ! defined(BOOST_NO_FUNCTION_TEMPLATE_ORDERING)
       
   154         const version_type v(file_version);
       
   155         save_construct_data(ar, t, v);
       
   156     #else
       
   157         save_construct_data(ar, t, file_version);
       
   158     #endif
       
   159 }
       
   160 
       
   161 template<class Archive, class T>
       
   162 inline void load_construct_data_adl(
       
   163     Archive & ar, 
       
   164     T * t, 
       
   165     const unsigned int file_version
       
   166 ){
       
   167     // see above comment
       
   168     #if ! defined(BOOST_NO_FUNCTION_TEMPLATE_ORDERING)
       
   169         const version_type v(file_version);
       
   170         load_construct_data(ar, t, v);
       
   171     #else
       
   172         load_construct_data(ar, t, file_version);
       
   173     #endif
       
   174 }
       
   175 
       
   176 } // namespace serialization
       
   177 } // namespace boost
       
   178 
       
   179 #endif //BOOST_SERIALIZATION_SERIALIZATION_HPP