Boost::Python- 可以从 dict 自动转换 -->标准::地图？

Question

我有一个 C++ 类，其中有一个可以接受从小到大数量的参数的成员函数。让我们将这些参数命名为 af。所有参数都有默认值。作为我正在开发的 python 项目的一部分，我想将此类公开给 python。目前，成员函数看起来像这样：

class myClass {
    public:
    // Constructors - set a-f to default values.

    void SetParameters(std::map<std::string, double> &);
    private:
    double a, b, c, d, e, f;
}

void myClass::SetParameters(std::map<std::string, double> const& params) {
    // Code to iterate over the map, and set any found key/value pairs to their
    // corresponding variable.  i.e.- "a" --> 2.0, would set myClass::a to 2.0
}

理想情况下，在Python中，我想使用字典来完成此操作：

>>> A = myModule.myClass();
>>> A.SetParameters({'a': 2.2, 'd': 4.3, b: '9.3'})

这样，用户可以按任何顺序输入值，并输入任意数量的值来覆盖。关于如何在 boost::python 中实现这一点有什么想法吗？在我看来，我可以通过将映射输入更改为 boost::python 对象并使用 extract 函数来做到这一点。但是，这需要我更改库的接口（我更愿意保留 std::map 接口，并为 python 版本提供一些中间/自动转换技术）。想法？

Answer 1

我认为有几种方法比编写自己的转换器更容易实现。您可以使用 boost::python 的 map_indexing_suite 来为您进行转换，也可以使用 python 中的关键字参数。我个人更喜欢关键字参数，因为这是更“Pythonic”的方式来做到这一点。

所以这是你的类（我为地图添加了 typedef）：

typedef std::map<std::string, double> MyMap;

class myClass {
public:
    // Constructors - set a-f to default values.

    void SetParameters(MyMap &);
private:
    double a, b, c, d, e, f;
};

使用 map_indexing_suite 的示例：

#include <boost/python/suite/indexing/map_indexing_suite.hpp>

using boost::python;

BOOST_PYTHON_MODULE(mymodule)
{
    class_<std::map<std::string, double> >("MyMap")
        .def(map_indexing_suite<std::map<std::wstring, double> >() );

    class_<myClass>("myClass")
        .def("SetParameters", &myClass::SetParameters);
}

使用关键字参数的示例。这需要使用 raw_function 包装器：

using namespace boost::python;

object SetParameters(tuple args, dict kwargs)
{
    myClass& self = extract<myClass&>(args[0]);

    list keys = kwargs.keys();

    MyMap outMap;
    for(int i = 0; i < len(keys); ++i) {
        object curArg = kwargs[keys[i]];
        if(curArg) {
            outMap[extract<std::string>(keys[i])] = extract<double>(kwargs[keys[i]]);
        }               
    }
    self.SetParameters(outMap);

    return object();
}

BOOST_PYTHON_MODULE(mymodule)
{
    class_<myClass>("myClass")
        .def("SetParameters", raw_function(&SetParameters, 1));
}

这允许您在 Python 中编写如下内容：

A.SetParameters(a = 2.2, d = 4.3, b = 9.3)

Answer 2

这篇博文有一个漂亮的清楚地描述了如何编写这些转换器。基本模式是定义一个具有以下形式的类：

struct SomeType_from_PyObject
{
    SomeType_from_PyObject();
    static void* convertible(PyObject* obj_ptr);
    static void construct(PyObject* obj_ptr,
                          converter::rvalue_from_python_stage1_data* data);
};

其中构造函数负责将此转换器添加到 Boost.Python 的注册表：

SomeType_from_PyObject::SomeType_from_PyObject()
{
    converter::registry::push_back(&convertible,
                                   &construct,
                                   type_id<SomeType>());
}

函数 convertible 告诉 Boost 此转换器是否可以转换指定的 Python对象：

void* SomeType_from_PyObject::convertible(PyObject* obj_ptr)
{
    if (PyMapping_Check(obj_ptr)) {
        return obj_ptr;
    } else {
        return NULL;
    }
}

construct函数实际上创建了一个转换类型的对象：

void SomeType_from_PyObject::construct(PyObject* obj_ptr,
                                       converter::rvalue_from_python_stage1_data* data)
{
    typedef converter::rvalue_from_python_storage<SomeType> storage_t;
    storage_t* the_storage = reinterpret_cast<storage_t*>(data);
    void* memory_chunk = the_storage->storage.bytes;
    object obj(handle<>(borrowed(obj_ptr)));
    SomeType* output = new (memory_chunk) SomeType();
    // Use the contents of obj to populate output, e.g. using extract<>
    data->convertible = memory_chunk;
}

然后在你的BOOST_PYTHON_MODULE内部，包括行

SomeType_from_PyObject();

Answer 3

我只是用 boost::python 弄湿了我的脚趾，所以无法完全回答你的问题。但我看到的第一个障碍是保证 py 字典的键都是字符串。 Python 字典也可以在元组上键入（我假设有更多类型）。