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

Click here to view the latest version of this page.

C++ Boost


Header <boost/python/copy_non_const_reference.hpp>


Class copy_non_const_reference
Class copy_non_const_reference synopsis
Class copy_non_const_reference metafunctions


Class copy_non_const_reference

copy_non_const_reference is a model of ResultConverterGenerator which can be used to wrap C++ functions returning a reference-to-non-const type such that the referenced value is copied into a new Python object.

Class copy_non_const_reference synopsis

namespace boost { namespace python
    struct copy_non_const_reference
        template <class T> struct apply;

Class copy_non_const_reference metafunctions

template <class T> struct apply
Requires: T is U& for some non-const U.
Returns: typedef to_python_value<T> type;


C++ code:

#include <boost/python/module.hpp>
#include <boost/python/class.hpp>
#include <boost/python/copy_non_const_reference.hpp>
#include <boost/python/return_value_policy.hpp>

// classes to wrap
struct Bar { int x; }

struct Foo {
   Foo(int x) : { b.x = x; }
   Bar& get_bar() { return b; }
   Bar b;

// Wrapper code
using namespace boost::python;

     class_<Foo>("Foo", init<int>())
        .def("get_bar", &Foo::get_bar
            , return_value_policy<copy_non_const_reference>())
Python Code:
>>> from my_module import *
>>> f = Foo(3)         # create a Foo object
>>> b = f.get_bar()    # make a copy of the internal Bar object

Revised 13 November, 2002

© Copyright Dave Abrahams 2002. All Rights Reserved.