Boost.Python和Boost.Function

时间:2015-05-31 03:37:30

标签: python c++ function boost

我想包装一个boost::function类成员,以便它可以按以下方式使用:

using namespace boost;
using namespace boost::python;

struct gui_button_t
{
    function<void()> on_pressed;
};

class_<gui_button_t>("GuiButton", init<>())
    .def("on_pressed", &gui_button_t::on_pressed);

然后在Python中:

def callback_function():
    print 'button has been pressed'

button = GuiButton()
button.on_pressed = callback_function
button.on_pressed() # function should be callable from C++ or Python

然而,尝试这会产生关于类模板参数等的大量错误。

我做了一些搜索,但一直找不到我一直在寻找的答案。下面的文章有点接近,但他们没有直接涉及这个主题。

http://bfroehle.com/2011/07/18/boost-python-and-boost-function-ii/

我在这里做错了什么?我需要做什么才能获得此功能的所需界面?

非常感谢提前。

1 个答案:

答案 0 :(得分:5)

Boost.Python只接受指向函数的指针和指向成员函数的指针。所以我们需要做的是将我们的callable转换为函数指针。这里的主要想法是

  1. 没有捕获的lambda可以转换为函数指针(通过sorcery
  2. 函数指针的解释方式与Python中的成员函数相同:第一个参数是self
  3. 所以在你的情况下,我们需要做的是生成这个lambda:

    +[](gui_button_t* self) {
        self->on_pressed();
    }
    

    你已经可以在Boost.Python中使用它了,因为这是一个非常正常的函数指针。但是,我们需要一个适用于任何可调用成员的解决方案。为什么只是支持boost::function什么时候可以支持?

    我们将从@Columbo's closure_traits开始,但另外添加了一种拉出参数列表的方法;

    template <typename...> struct typelist { };
    
    template <typename C, typename R, typename... Args>                        \
    struct closure_traits<R (C::*) (Args... REM_CTOR var) cv>                  \
    {                                                                          \
        using arity = std::integral_constant<std::size_t, sizeof...(Args) >;   \
        using is_variadic = std::integral_constant<bool, is_var>;              \
        using is_const    = std::is_const<int cv>;                             \
                                                                               \
        using result_type = R;                                                 \
                                                                               \
        template <std::size_t i>                                               \
        using arg = typename std::tuple_element<i, std::tuple<Args...>>::type; \
                                                                               \
        using args = typelist<Args...>;                                        \
    };
    

    然后我们将为任何可调用成员编写一个包装器。由于我们的lambda可以不捕获,我们将callable作为模板参数:

    template <typename CLS, typename F, F CLS::*callable>
    class wrap { ... };
    

    我将使用C ++ 14的auto返回类型推导来节省一些输入。我们创建了一个顶级make_pointer()静态成员函数,它只转发给另一个带参数的辅助成员函数。完整wrap看起来像:

    template <typename CLS, typename F, F CLS::*callable>
    class wrap {
    public:
        static auto make_pointer() {
            return make_pointer_impl(typename closure_traits<F>::args{});
        }
    
    private:
        template <typename... Args>
        static auto make_pointer_impl(typelist<Args...> ) {
            // here is our lambda that takes the CLS as the first argument
            // and then the rest of the callable's arguments,
            // and just calls it
            return +[](CLS* self, Args... args) {
                return (self->*callable)(args...);
            };
        }
    };
    

    我们可以用来包裹你的按钮:

    void (*f)(gui_button_t*) = wrap<gui_button_t, 
                                    decltype(gui_button_t::on_pressed),
                                    &gui_button_t::on_pressed
                                    >::make_pointer();
    

    这有点冗长和重复,所以让我们做一个宏(叹息):

    #define WRAP_MEM(CLS, MEM) wrap<CLS, decltype(CLS::MEM), &CLS::MEM>::make_pointer()
    

    所以我们得到:

    void (*f)(gui_button_t*) = WRAP_MEM(gui_button_t, on_pressed);
    
    f(some_button); // calls some_button->on_pressed()
    

    由于这给了我们一个指向函数的指针,我们可以直接使用普通的Boost.Python API:

    class_<gui_button_t>("GuiButton", init<>())
        .def("on_pressed", WRAP_MEM(gui_button_t, on_pressed));
    

    Demo演示了指向成员std::function的功能指针和带有struct的成员operator()

    以上使您能够公开一个可调用的。如果你想另外能够做任务,即:

    button = GuiButton()
    button.on_pressed = callback_function
    button.on_pressed()
    

    我们需要做点别的事情。您无法在Python中以有意义的方式展示operator=,因此要支持上述功能,您必须覆盖__setattr__。现在,如果您愿意接受:

    button.set_on_pressed(callback_function)
    

    我们可以扩展上面的wrap解决方案来添加一个setter,其实现方式将如上所述:

    static auto set_callable() {
        return make_setter_impl(
            typelist<typename closure_traits<F>::result_type>{},
            typename closure_traits<F>::args{});
    }
    
    template <typename R, typename... Args>
    static auto make_setter_impl(typelist<R>, typelist<Args...> ) {
        return +[](CLS* self, py::object cb) {
            (self->*callable) = [cb](Args... args) {
                return py::extract<R>(
                    cb(args...))();
            };
        };
    }
    
    // need a separate overload just for void
    template <typename... Args>
    static auto make_setter_impl(typelist<void>, typelist<Args...> ) {
        return +[](CLS* self, py::object cb) {
            (self->*callable) = [cb](Args... args) {
                cb(args...);
            };
        };
    }
    
    #define SET_MEM(CLS, MEM) wrap<CLS, decltype(CLS::MEM), &CLS::MEM>::set_callable()
    

    然后您可以通过以下方式公开:

    .def("set_on_pressed", SET_MEM(button, on_pressed))
    

    但是,如果您坚持支持直接分配,那么您还需要另外公开类似的内容:

    static void setattr(py::object obj, std::string attr, py::object val)
    {
         if (attr == "on_pressed") {
             button& b = py::extract<button&>(obj);
             SET_MEM(button, on_pressed)(&b, val);
         }
         else {
             py::str attr_str(attr);
             if (PyObject_GenericSetAttr(obj.ptr(), attr_str.ptr(), val.ptr()) {
                 py::throw_error_already_set();
             }
         }
    }
    
    
    .def("__setattr__", &button::setattr);
    

    这样可行,但您必须为要设置的每个仿函数添加更多个案。如果每个类只有一个类似仿函数的对象,可能没什么大不了的,甚至可以编写一个更高阶的函数来为给定的属性名称生成一个特定的setattr类函数。但是如果你有倍数,那么它将比简单的set_on_pressed解决方案稳步恶化。

    如果C ++ 14不可用,我们必须明确指定make_pointer的返回类型。我们需要一些方便的类型特征。 concat

    template <typename T1, typename T2>
    struct concat;
    
    template <typename T1, typename T2>
    using concat_t = typename concat<T1, T2>::type;
    
    template <typename... A1, typename... A2>
    struct concat<typelist<A1...>, typelist<A2...>> {
        using type = typelist<A1..., A2...>;
    };
    

    然后将返回类型和typelist转换为函数指针:

    template <typename R, typename T>
    struct make_fn_ptr;
    
    template <typename R, typename... Args>
    struct make_fn_ptr<R, typelist<Args...>> {
        using type = R(*)(Args...);
    };
    
    template <typename R, typename T>
    using make_fn_ptr_t = typename make_fn_ptr<R, T>::type;
    

    然后在wrap内,我们可以将结果类型定义为:

    using R = make_fn_ptr_t<
                    typename closure_traits<F>::result_type,
                    concat_t<
                        typelist<CLS*>,
                        typename closure_traits<F>::args
                        >
                    >;
    

    并使用它代替autoC++11 Demo