方法函数
一个可由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
参考