Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.


// Copyright Ralf W. Grosse-Kunstleve 2002-2004. Distributed under the Boost
// Software License, Version 1.0. (See accompanying
// file LICENSE_1_0.txt or copy at

    This example shows how to make an Extension Class "pickleable".

    The world class below can be fully restored by passing the
    appropriate argument to the constructor. Therefore it is sufficient
    to define the pickle interface method __getinitargs__.

    For more information refer to boost/libs/python/doc/pickle.html.

#include <boost/python/module.hpp>
#include <boost/python/def.hpp>
#include <boost/python/class.hpp>
#include <boost/python/tuple.hpp>

#include <string>

namespace boost_python_test {

  // A friendly class.
  class world
      std::string country;
      world(const std::string& country) {
        this->country = country;
      std::string greet() const { return "Hello from " + country + "!"; }
      std::string get_country() const { return country; }

  struct world_pickle_suite : boost::python::pickle_suite
    getinitargs(const world& w)
        using namespace boost::python;
        return make_tuple(w.get_country());

  // To support test of "pickling not enabled" error message.
  struct noop {};

  using namespace boost::python;
  using namespace boost_python_test;
  class_<world>("world", init<const std::string&>())
      .def("greet", &world::greet)

  // To support test of "pickling not enabled" error message.