persistence/persistent_string.hpp

#ifndef STLPLUS_PERSISTENT_STRING
#define STLPLUS_PERSISTENT_STRING
////////////////////////////////////////////////////////////////////////////////

//   Author:    Andy Rushton
//   Copyright: (c) Southampton University 1999-2004
//              (c) Andy Rushton           2004 onwards
//   License:   BSD License, see ../docs/license.html

//   Persistence for STL strings

////////////////////////////////////////////////////////////////////////////////
#include "persistence_fixes.hpp"
#include "persistent_contexts.hpp"
#include <string>

////////////////////////////////////////////////////////////////////////////////

namespace stlplus
{

  // basic_string

  // exceptions: persistent_dump_failed
  template<typename charT, typename traits, typename allocator, typename D>
  void dump_basic_string(dump_context&, const std::basic_string<charT,traits,allocator>& data, D dump_fn);

  // exceptions: persistent_restore_failed
  template<typename charT, typename traits, typename allocator, typename R>
  void restore_basic_string(restore_context&, std::basic_string<charT,traits,allocator>& data, R restore_fn);

  // string

  // exceptions: persistent_dump_failed
  void dump_string(dump_context&, const std::string& data);

  // exceptions: persistent_restore_failed
  void restore_string(restore_context&, std::string& data);


  // Note: persistence of wstring not supported because it is too weakly defined and messy
  //       decide on a byte-wide encoding of wide strings (e.g. UTF8) and use the string persistence on that

} // end namespace stlplus

  ////////////////////////////////////////////////////////////////////////////////
#include "persistent_string.tpp"
#endif