在Pybind11 2.6版本中无clear()时如何清空py::list？

在Pybind11 2.13及以上版本中，py::list内置了clear()方法，可直接清空列表，其底层实现如下：

void clear() /* py-non-const */ {
    if (PyList_SetSlice(m_ptr, 0, PyList_Size(m_ptr), nullptr) == -1) {
        throw error_already_set();
    }
}

使用时只需直接调用：

py::list myList;
// 添加数据、执行操作
myList.clear();

但在Pybind11 2.6.2这类旧版本中，py::list并未提供clear()成员方法，调用时会触发错误：error: ‘class pybind11::list’ has no member named ‘clear’。

可行解决方案 #

1. 直接调用Python C API（你的尝试是官方认可的方式） #

你尝试的代码逻辑和官方后续版本的clear()完全一致，只是旧版本没有将其封装为成员方法。可以优化代码，避免重复转换指针：

PyObject* list_ptr = myList.ptr(); // 利用py::object的ptr()方法直接获取底层指针
if (PyList_SetSlice(list_ptr, 0, PyList_Size(list_ptr), nullptr) == -1) {
    throw pybind11::error_already_set();
}

这段代码的行为和新版本的clear()完全对齐，会在操作失败时抛出Python异常，是官方预期的底层实现方式。

2. 封装工具函数复用逻辑 #

如果需要多次清空列表，可以封装一个工具函数，模拟新版本的clear()：

void clear_py_list(pybind11::list& lst) {
    PyObject* ptr = lst.ptr();
    if (PyList_SetSlice(ptr, 0, PyList_Size(ptr), nullptr) == -1) {
        throw pybind11::error_already_set();
    }
}

// 使用示例
py::list myList;
// ...执行列表操作
clear_py_list(myList);

3. 调用Python原生clear()方法（备选） #

若运行环境的Python版本在3.3及以上，可直接调用Python列表的原生clear()方法：

myList.attr("clear")();

这种方式更贴近Python原生用法，无需直接操作C API。

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