Python C-API 让 len(...) 与扩展类配合使用

Question

在Python中创建一个类时，我可以简单地定义一个 def __len__(self): 方法，这样就能让 len(InstanceOfMyClass) 这个函数正常工作。不过，我找不到如何通过C-API在扩展类中做到这一点。

我尝试添加一个 __len__ 方法，但似乎没有效果。

{"__len__",(PyCFunction)&TestClass_GetLen,METH_NOARGS,""},

Python测试代码：

def test(my_instance):
    x = len(my_instance)#exception
    return x

TypeError: object of type 'test_module.test_class' has no len()

TestClass的代码

struct TestClass;
static int TestClass_Init(TestClass *self, PyObject *args, PyObject* kwds);
static void TestClass_Dealloc(TestClass *self);
static PyObject* TestClass_GetLen(TestClass *self);

struct TestClass
{
    PyObject_HEAD;
};
static PyMethodDef TestClass_methods[] =
{
    {"__len__",(PyCFunction)&TestClass_GetLen,METH_O,""},
    {NULL}
};
static PyTypeObject TestClass_type = {PyObject_HEAD_INIT(NULL)};
bool InitTestClass(PyObject *module)
{
    TestClass_type.tp_basicsize = sizeof(TestClass);
    TestClass_type.tp_name      = PY_MODULE_NAME".TestClass";
    TestClass_type.tp_doc       = "";
    TestClass_type.tp_flags     = Py_TPFLAGS_DEFAULT;
    TestClass_type.tp_methods   = TestClass_methods;
    TestClass_type.tp_new       = PyType_GenericNew;
    TestClass_type.tp_init      = (initproc)TestClass_Init;
    TestClass_type.tp_dealloc   = (destructor)TestClass_Dealloc;
    if(PyType_Ready(TestClass_type) < 0) return false;

    Py_INCREF(TestClass_type);
    PyModule_AddObject(module, "TestClass", (PyObject*)&TestClass_type);
    return true;
};
void TestClass_Dealloc(TestClass *self)
{
    Py_TYPE(self)->tp_free((PyObject*)self);
}
int TestClass_Init(TestClass *self, PyObject *args, PyObject* kwds)
{
    return 0;
}
PyObject* TestClass_GetLen(TestClass *self)
{
    return PyLong_FromLong(55);
}

Answer 1

类型对象结构中的 tp_as_sequence 成员应该填入一个包含 sq_length 成员的东西，也就是说，这个东西需要有一个表示长度的值。

Answer 2

正如Igniacio所说，正确的方法是填充你的类型对象中的 tp_as_sequence 成员。下面是一个简单的例子：

#include <Python.h>

/**
 * C structure and methods definitions
 */

typedef struct {
    PyObject_HEAD;
} TestObject;

static Py_ssize_t
TestClass_len(TestObject* self) 
{   
    return 55;
}

/**
 * Python definitions
 */

static PySequenceMethods TestClass_sequence_methods = {
    TestClass_len,                  /* sq_length */
};

static PyTypeObject TestClass = {
    PyObject_HEAD_INIT(NULL)    
    0,                              /*ob_size*/
    "testmodule.TestClass",         /*tp_name*/
    sizeof(TestObject),             /*tp_basicsize*/
};

/**
 * Module entry point
 */
#ifndef PyMODINIT_FUNC  /* declarations for DLL import/export */
#define PyMODINIT_FUNC void
#endif
PyMODINIT_FUNC
inittestmodule(void) 
{
    PyObject* m;

    TestClass.tp_new = PyType_GenericNew;
    TestClass.tp_as_sequence = &TestClass_sequence_methods;
    TestClass.tp_flags = Py_TPFLAGS_DEFAULT;

    if (PyType_Ready(&TestClass) < 0)
        return;

    m = Py_InitModule3("testmodule", NULL, "");

    Py_INCREF(&TestClass);
    PyModule_AddObject(m, "TestClass", (PyObject *)&TestClass);
}

另一种（更复杂且速度较慢）的方法是在模块的初始化函数中，使用 PyCFunction_New、PyMethod_New 和 PyObject_SetAttr 动态地为你的类添加一个 __len__ 方法。这种方式看起来更像你粘贴的代码，只是你在C方法表中定义了 __len__，但这样是行不通的。