1 #ifndef BOOST_ARCHIVE_BASIC_BINARY_OPRIMITIVE_HPP
2 #define BOOST_ARCHIVE_BASIC_BINARY_OPRIMITIVE_HPP
4 // MS compatible compilers support #pragma once
9 /////////1/////////2/////////3/////////4/////////5/////////6/////////7/////////8
10 // basic_binary_oprimitive.hpp
12 // (C) Copyright 2002 Robert Ramey - http://www.rrsd.com .
13 // Use, modification and distribution is subject to the Boost Software
14 // License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
15 // http://www.boost.org/LICENSE_1_0.txt)
17 // See http://www.boost.org for updates, documentation, and revision history.
19 // archives stored as native binary - this should be the fastest way
20 // to archive the state of a group of obects. It makes no attempt to
21 // convert to any canonical form.
23 // IN GENERAL, ARCHIVES CREATED WITH THIS CLASS WILL NOT BE READABLE
24 // ON PLATFORM APART FROM THE ONE THEY ARE CREATE ON
27 #include <boost/assert.hpp>
29 #include <streambuf> // basic_streambuf
31 #include <cstddef> // size_t
33 #include <boost/config.hpp>
34 #if defined(BOOST_NO_STDC_NAMESPACE)
40 #include <boost/cstdint.hpp>
41 #include <boost/integer.hpp>
42 #include <boost/integer_traits.hpp>
43 #include <boost/scoped_ptr.hpp>
44 #include <boost/serialization/throw_exception.hpp>
46 //#include <boost/mpl/placeholders.hpp>
47 #include <boost/serialization/is_bitwise_serializable.hpp>
48 #include <boost/serialization/array_wrapper.hpp>
50 #include <boost/archive/basic_streambuf_locale_saver.hpp>
51 #include <boost/archive/codecvt_null.hpp>
52 #include <boost/archive/archive_exception.hpp>
53 #include <boost/archive/detail/auto_link_archive.hpp>
54 #include <boost/archive/detail/abi_prefix.hpp> // must be the last header
59 /////////////////////////////////////////////////////////////////////////
60 // class basic_binary_oprimitive - binary output of prmitives
62 template<class Archive, class Elem, class Tr>
63 class BOOST_SYMBOL_VISIBLE basic_binary_oprimitive {
64 #ifndef BOOST_NO_MEMBER_TEMPLATE_FRIENDS
65 friend class save_access;
70 std::basic_streambuf<Elem, Tr> & m_sb;
71 // return a pointer to the most derived class
73 return static_cast<Archive *>(this);
75 #ifndef BOOST_NO_STD_LOCALE
76 // note order! - if you change this, libstd++ will fail!
77 // a) create new locale with new codecvt facet
78 // b) save current locale
79 // c) change locale to new one
80 // d) use stream buffer
81 // e) change locale back to original
82 // f) destroy new codecvt facet
83 boost::archive::codecvt_null<Elem> codecvt_null_facet;
84 basic_streambuf_locale_saver<Elem, Tr> locale_saver;
85 std::locale archive_locale;
87 // default saving of primitives.
89 void save(const T & t)
91 save_binary(& t, sizeof(T));
94 /////////////////////////////////////////////////////////
95 // fundamental types that need special treatment
97 // trap usage of invalid uninitialized boolean which would
98 // otherwise crash on load.
99 void save(const bool t){
100 BOOST_ASSERT(0 == static_cast<int>(t) || 1 == static_cast<int>(t));
101 save_binary(& t, sizeof(t));
103 BOOST_ARCHIVE_OR_WARCHIVE_DECL void
104 save(const std::string &s);
105 #ifndef BOOST_NO_STD_WSTRING
106 BOOST_ARCHIVE_OR_WARCHIVE_DECL void
107 save(const std::wstring &ws);
109 BOOST_ARCHIVE_OR_WARCHIVE_DECL void
110 save(const char * t);
111 BOOST_ARCHIVE_OR_WARCHIVE_DECL void
112 save(const wchar_t * t);
114 BOOST_ARCHIVE_OR_WARCHIVE_DECL void
117 BOOST_ARCHIVE_OR_WARCHIVE_DECL
118 basic_binary_oprimitive(
119 std::basic_streambuf<Elem, Tr> & sb,
122 BOOST_ARCHIVE_OR_WARCHIVE_DECL
123 ~basic_binary_oprimitive();
126 // we provide an optimized save for all fundamental types
127 // typedef serialization::is_bitwise_serializable<mpl::_1>
128 // use_array_optimization;
129 // workaround without using mpl lambdas
130 struct use_array_optimization {
132 #if defined(BOOST_NO_DEPENDENT_NESTED_DERIVATIONS)
134 typedef typename boost::serialization::is_bitwise_serializable< T >::type type;
137 struct apply : public boost::serialization::is_bitwise_serializable< T > {};
141 // the optimized save_array dispatches to save_binary
142 template <class ValueType>
143 void save_array(boost::serialization::array_wrapper<ValueType> const& a, unsigned int)
145 save_binary(a.address(),a.count()*sizeof(ValueType));
148 void save_binary(const void *address, std::size_t count);
151 template<class Archive, class Elem, class Tr>
153 basic_binary_oprimitive<Archive, Elem, Tr>::save_binary(
157 // BOOST_ASSERT(count <= std::size_t(boost::integer_traits<std::streamsize>::const_max));
158 // note: if the following assertions fail
159 // a likely cause is that the output stream is set to "text"
160 // mode where by cr characters recieve special treatment.
161 // be sure that the output stream is opened with ios::binary
163 // boost::serialization::throw_exception(
164 // archive_exception(archive_exception::output_stream_error)
166 // figure number of elements to output - round up
167 count = ( count + sizeof(Elem) - 1) / sizeof(Elem);
168 std::streamsize scount = m_sb.sputn(
169 static_cast<const Elem *>(address),
170 static_cast<std::streamsize>(count)
172 if(count != static_cast<std::size_t>(scount))
173 boost::serialization::throw_exception(
174 archive_exception(archive_exception::output_stream_error)
177 // static_cast<const typename OStream::char_type *>(address),
180 //BOOST_ASSERT(os.good());
184 } //namespace archive
186 #include <boost/archive/detail/abi_suffix.hpp> // pop pragmas
188 #endif // BOOST_ARCHIVE_BASIC_BINARY_OPRIMITIVE_HPP