CPython中Python魔法函数转C函数的映射及跨语言调用问询

一、Python中__gt__等比较魔法方法到tp_richcompare的转换与调用流程 #

CPython中自定义类的PyTypeObject（对应Python的类对象）默认使用通用C函数处理比较逻辑，比如PyBaseObject_Type的tp_richcompare字段指向object_richcompare这个通用处理函数，具体流程如下：

• 当你在Python代码中定义__gt__、__lt__等比较魔法方法时，这些方法会被存储为类的属性，保存在类的__dict__中。
• 触发比较运算（如a > b）时，解释器会调用对象类型的tp_richcompare函数（即通用的object_richcompare），传入左操作数对象、右操作数对象、比较类型标识（比如Py_GT对应大于操作）。
• object_richcompare会根据比较类型，通过PyObject_GetAttrString从左操作数的类中取出对应的魔法方法（比如Py_GT对应__gt__）。
• 拿到方法对象后，通过PyObject_CallFunctionObjArgs调用这个Python层面的方法，传入右操作数作为参数，将返回的Python对象转换为C层的PyObject*返回，完成整个比较逻辑。

二、跨语言（Python到C）调用魔法方法的通用机制 #

CPython的C层与Python层的交互核心依赖Python/C API，所有Python对象在C层都以PyObject*的形式存在，C层通过API间接调用Python层面的方法，而非直接将Python代码转换为C函数指针：

1. 方法查找：当C层需要调用Python定义的方法（如__hash__）时，会先通过PyObject_GetAttrString(obj, "__hash__")获取该方法的对象（本质还是PyObject*）。
2. 方法调用：使用PyObject_CallFunctionObjArgs等API执行该方法，获取返回的Python对象，再根据场景转换为C层需要的类型（比如哈希值会转换为Py_hash_t）。
3. 字节码的作用：Python代码编译为字节码后，解释器执行字节码时会触发对应的C层逻辑（比如LOOKUP_METHOD指令查找魔法方法），但最终还是通过Python/C API完成Python方法的调用。

以__hash__方法为例的具体流程 #

字典的lookdict逻辑需要计算键的哈希值时，C层会调用通用的PyObject_Hash(obj)函数：

• PyObject_Hash会先检查对象类型的tp_hash字段，自定义Python类默认的tp_hash指向object_hash通用函数。
• object_hash会查找对象的__hash__方法，若存在则调用该Python方法，将返回的整数转换为C层的Py_hash_t返回；若不存在则抛出异常或返回默认哈希值。

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