python调用c语言数组参数,Python调用C模块(一):C api方式

方法函数

一个可由Python解释器调用的函数，可以响应Python程序的调用。C函数接受两个Python对象作为输入，输出一个Python对象返回给解释器作为结果，或者返回NULL在脚本中触发一个异常。

在该函数中，涉及到数据转换，首先需要将 Python 类型编程 C 类型的数据，其次将C类型数据转换成 Python 类型返回。

Python到C，可以使用PyArg_Parse或PyArg_ParseTuple或PyArg_ParseTupleAndKeywords

PyArg_ParseTuple(args, ""); //无参数，调用 f()

PyArg_ParseTuple(args, "s", &s); // 字符串参数，比如调用f('hello')

PyArg_ParseTuple(args, "lls", &k, &l, &s); //f(1, 2, 'three')

PyArg_ParseTuple(args, "(ii)s#", &i, &j, &s, &size);// f((1, 2), 'three')

PyArg_ParseTuple(args, "s|si", &file, &mode, &bufsize);// f('a') f('a', 'w') f('a', 'wb', 100)

C到Python，使用Py_BuildValue或 专用的PyString_FromString一类。

Py_BuildValue("s", "hello") 'hello'

Py_BuildValue("ss", "hello", "world") ('hello', 'world')

Py_BuildValue("s#", "hello", 4) 'hell'

Py_BuildValue("()") ()

Py_BuildValue("(i)", 123) (123,)

Py_BuildValue("(ii)", 123, 456) (123, 456)

Py_BuildValue("(i,i)", 123, 456) (123, 456)

Py_BuildValue("[i,i]", 123, 456) [123, 456]

Py_BuildValue("{s:i,s:i}","abc", 123, "def", 456) {'abc': 123, 'def': 456}

结构数组

将函数名映射为函数指针。名字会成为模块的属性名，Python代码用这个名字来调用C函数。

主要是第三个参数：

METH_VARARGS 表示采用C调用约定，必须指定。

METH_VARARGS | METH_KEYWORDS 有关键词参数

0 means that an obsolete variant ofPyArg_ParseTuple()is used.

初始化函数

Python初次导入该模块时调用。这个函数调用API函数Py_InitModule读取注册表来建立新模块的属性字典，并在sys.modules表中为该C模块新建了一个表项

错误处理

分两种：

C触发的异常，return NULL 即可触发标准的Python异常

Python 的错误，检查返回值(指针返回NULL，int返回-1，PyArg_parser返回0)

引用计数

Py_INCREF(obj)增加引用计数

Py_DECREF(obj)减少引用计数

Py_XINCREF(obj)增加引用计数，但忽略NULL

Py_XDECREF(obj)减少引用计数，忽略NULL

API函数创建一个新对象并返回给C时，会先增加它们的引用计数。除非一个新对象要回传给Python，创建它的C程序应该要减少它的引用计数。

回调：c中调用Python

参考