如何通过pybind11实现用字面量调用含自定义C++类型参数的函数？

问题背景 #

在C中嵌入Python解释器后，需要从Python调用参数为复杂自定义类型的C函数：

void func_i_like_to_use(CustomType a, AnotherCustomType b);

这些自定义类型存在深度继承、模板与typedef层级（如typedef CustomTemplate<float> CustomType），完整包装类型树成本极高。但C++中可通过字面量（如5.7、"My string literal"）直接调用该函数，因为自定义类型支持从POD类型隐式构造/转换。但直接用pybind11绑定原函数后，Python无法传递字面量参数，尝试强制转换函数签名也无法编译。

解决方案 #

方法1：编写适配函数（最直接） #

写一个中间Lambda函数，接收Python可直接传递的POD类型，在内部利用C++的构造/转换逻辑生成自定义类型实例，再调用原函数：

PYBIND_EMBEDDED_MODULE(example, m) {
    m.def("func_i_like_to_use", 
          [](float a_val, const std::string& b_val) {
              // 利用C++隐式构造/转换生成自定义类型
              func_i_like_to_use(a_val, b_val);
          }, 
          "调用C++函数，支持字面量参数",
          pybind11::arg("a"), pybind11::arg("b"));
}

这个方法无需包装任何自定义类型，仅针对目标函数做适配，Python端可直接用字面量调用：

import example
example.func_i_like_to_use(5.8, 'hello world')

方法2：最小化绑定类型+注册隐式转换 #

如果多个函数都需要用到这些自定义类型的转换，可以给类型做最小化绑定（无需包装所有成员），再注册隐式转换规则，让pybind11自动处理类型转换：

PYBIND_EMBEDDED_MODULE(example, m) {
    // 最小化绑定CustomType：仅声明类型并暴露构造函数
    pybind11::class_<CustomType>(m, "CustomType")
        .def(pybind11::init<float>()); // 对应C++中从float构造CustomType的逻辑

    // 同理绑定AnotherCustomType
    pybind11::class_<AnotherCustomType>(m, "AnotherCustomType")
        .def(pybind11::init<const std::string&>());

    // 注册隐式转换：Python的float自动转为CustomType，字符串转为AnotherCustomType
    pybind11::implicitly_convertible<float, CustomType>();
    pybind11::implicitly_convertible<std::string, AnotherCustomType>();

    // 直接绑定原函数
    m.def("func_i_like_to_use", &func_i_like_to_use, 
          "调用C++函数",
          pybind11::arg("a"), pybind11::arg("b"));
}

Python端同样可以直接用字面量调用原函数，同时还能在Python中显式创建CustomType实例（如果需要）。

方法3：自定义类型转换器（复杂场景） #

如果隐式转换无法满足需求（比如需要处理多种Python类型输入、自定义错误逻辑），可以编写pybind11自定义类型转换器：

// 为CustomType编写自定义转换器
namespace pybind11 { namespace detail {
    template <> struct type_caster<CustomType> {
    public:
        PYBIND11_TYPE_CASTER(CustomType, _("CustomType"));

        // 实现从Python对象到C++ CustomType的转换
        bool load(handle src, bool) {
            if (src.is_none()) return false;
            try {
                // 尝试将Python对象转为float，再构造CustomType
                float val = pybind11::cast<float>(src);
                value = CustomType(val);
                return true;
            } catch (const pybind11::cast_error&) {
                // 转换失败时的自定义处理（可选）
                return false;
            }
        }

        // 可选：实现从C++ CustomType到Python对象的转换
        static handle cast(CustomType src, return_value_policy, handle) {
            return pybind11::cast(static_cast<float>(src)).release();
        }
    };
}} // namespace pybind11::detail

// 同理为AnotherCustomType编写转换器

PYBIND_EMBEDDED_MODULE(example, m) {
    // 直接绑定原函数，转换器会自动处理类型转换
    m.def("func_i_like_to_use", &func_i_like_to_use, 
          "调用C++函数",
          pybind11::arg("a"), pybind11::arg("b"));
}

这个方法灵活性最高，适合处理非标准的转换逻辑。

总结 #

• 单函数适配优先用方法1，实现简单，无额外类型绑定成本；
• 多函数复用类型转换逻辑用方法2，一次绑定多次使用；
• 复杂转换场景用方法3，完全自定义转换规则。

内容的提问来源于stack exchange，提问作者Chaos_99