CPython PyTupleObject分析

对象结构:

typedef struct {
    PyObject_VAR_HEAD
    PyObject *ob_item[1];
} PyTupleObject;

 

常用接口:

PyTuple_New:  创建一个Tuple对象，参数为创建大小

PyTuple_GetItem: 获取Tuple的某一个元素，参数为 ob_item的索引index

PyTuple_SetItem: 设置Tuple的某一个元素，参数为 索引index和要传入的PyObject对象

PyTuple_Pack: 将多个对象打包成一个PyTupleObject，参数为size大小和一系列打包元素...

 

注：PyTuple_GetItem不会增加引用计数，所以要持有对象，必须Py_XINCREF，Py_Tuple_SetItem会对olditem进行Py_XDECREF。

PyTuple_MAXSAVESIZE = 20: 为了防止频繁内存操作，缓存的Tuple的size大小阈值，也就是size<20的小tuple对象都被

在释放和申请时加入缓存处理。

PyTuple_MAXFREELIST=2000: 要被缓存的size的Tuple最大缓存的数目，为了占用内存小，缓存也不能过大。

 

缓存对象数据结构:

free_list: 静态缓存队列

num_free: 缓存计数器

free_list的index代表对应size的大小的缓存链表，链表通过 op->ob_item[0]指向下一个可用的PyTupleObject，num_free的index代表对应size大小的缓存链表长度。这就是为什么ob_item声明部分用了PyObject* ob_item[1] 一个元素。真正的tuple长度在PyObject_VAR_HEAD的ob_size上。