Python 性能分析原理（二）

`PyEval_SetTrace` 是 Python C API 中的一个函数，用于设置全局的跟踪函数。这个函数允许开发者在 Python 代码执行时插入自定义的跟踪逻辑，通常用于调试和性能分析。

### 函数原型
```c
void PyEval_SetTrace(Py_tracefunc func, PyObject *arg);
```

参数说明：
- `func`: `跟踪函数`。这个函数必须符合 `Py_tracefunc` 类型的定义。
- `arg`: 传递给跟踪函数的参数，可以是任意的 Python 对象。

### 跟踪函数的定义
```c
int (*Py_tracefunc)(PyObject *obj, struct _frame *frame, int what, PyObject *arg);
```
- `obj`: 传递给 `PyEval_SetTrace` 的 `arg` 参数。
- `frame`: 当前执行的帧对象。
- `what`: 表示事件类型的整数。
- `arg`: 事件相关的参数。

### 事件类型
`what` 参数可以是以下值之一：
- `PyTrace_CALL`: 函数调用。
- `PyTrace_EXCEPTION`: 异常抛出。
- `PyTrace_LINE`: 执行新的一行。
- `PyTrace_RETURN`: 函数返回。
- `PyTrace_C_CALL`: C 函数调用。
- `PyTrace_C_EXCEPTION`: C 函数抛出异常。
- `PyTrace_C_RETURN`: C 函数返回。

### 示例
以下是一个简单的示例，展示如何使用 `PyEval_SetTrace` 设置一个跟踪函数：
```c
#include <Python.h>

static int my_tracefunc(PyObject *obj, PyFrameObject *frame, int what, PyObject *arg) {
    if (what == PyTrace_CALL) {
        printf("Function call: %s\n", PyUnicode_AsUTF8(frame->f_code->co_name));
    }
    return 0;
}

int main() {
    Py_Initialize();
    PyEval_SetTrace(my_tracefunc, NULL);
    // 执行一些 Python 代码
    Py_Finalize();
    return 0;
}
```

这个示例中的 `my_tracefunc` 会在每次函数调用时打印函数的名称。