Python C API的使用详解（一）

Python C API 是 Python 提供的一组 C 语言接口，允许开发者在自己的 C/C++ 程序中嵌入 Python 解释器，实现 C/C++ 代码和 Python 代码的混合编程。下面是 Python C API 的使用详解。

1. 引入头文件

使用 Python C API 前，需要在 C 代码中引入 Python 的头文件。通常情况下，只需要引入 "Python.h" 头文件即可。

#include <Python.h>

2. 初始化 Python 解释器

在使用 Python C API 前，需要初始化 Python 解释器。Python 提供了多种初始化函数，最常用的是 Py_Initialize() 函数，该函数将初始化一个全局解释器锁，并创建一个 Python 解释器对象。

Py_Initialize();

3. 调用 Python 函数

在 Python C API 中，可以使用 PyObject_CallObject() 函数来调用 Python 中的函数。该函数接受两个参数：要调用的 Python 函数对象和函数参数。

PyObject* pModule = PyImport_ImportModule("mymodule"); // 导入 Python 模块
PyObject* pFunc = PyObject_GetAttrString(pModule, "myfunc"); // 获取 Python 函数对象
PyObject* pArgs = PyTuple_New(1); // 创建参数元组
PyObject* pArg = Py_BuildValue("i", 123); // 创建整型参数值
PyTuple_SetItem(pArgs, 0, pArg); // 将参数值加入参数元组
PyObject* pRet = PyObject_CallObject(pFunc, pArgs); // 调用函数

在调用完 Python 函数后，需要手动释放相关资源：

Py_DECREF(pModule);
Py_DECREF(pFunc);
Py_DECREF(pArgs);
Py_DECREF(pArg);
Py_DECREF(pRet);

4. 获取 Python 对象的值

在 Python C API 中，可以使用 PyLong_AsLong()、PyFloat_AsDouble() 等函数来获取 Python 对象的值。

long n = PyLong_AsLong(pObj); // 获取整型值
double d = PyFloat_AsDouble(pObj); // 获取浮点型值
char* s = PyUnicode_AsUTF8(pObj); // 获取字符串值

5. 释放 Python 解释器

在使用完 Python C API 后，需要释放 Python 解释器。

Py_Finalize();

以上就是 Python C API 的使用详解，希望对你有所帮助。