C++扩展python modules

C++扩展python modules

• 函数详情

  #<Python.h>

  C语言扩展python

  1. PyObject 所有的python扩展类型对象

     描述所有python对象再C中的对象

  2. PyMethodDef 描述扩展type方法的struct

     自定义Python 方法

     域	C 类型	含义
     ml_name	char *	name of the method
     ml_meth	PyCFunction	pointer to the C implementation
     ml_flags	整型	flag bits indicating how the call should be constructed
     ml_doc	char *	points to the contents of the docstring

     ml_flags: 可选值有 METH_VARARGS 、 METH_VARARGS | METH_KEYWORDS，如果单独使用 METH_VARARGS ，函数会接受Python tuple格式的参数，并使用 PyArg_ParseTuple() 解析。METH_KEYWORDS 表示接受关键字参数，这种情况下C函数需要接受第三个 PyObject * 对象，表示字典参数，使用 PyArg_ParseTupleAndKeywords() 解析参数。

  3. PyMODINIT_FUNC 定义返回值为void的python moudle

     声明函数的返回值为void， 在python3中返回PyObject * ，声明为python module

  4. PyArg_ParseTuple

  int PyArg_ParseTuple(PyObject *arg, char *format, ...)
  arg：元组，代表python的参数列表
  format：格式化字符串

  解析一个函数的参数，表达式中的参数按参数位置顺序存入局部变量中。成功返回true；失败返回false并且引发相应的异常

  示例：

  	int ok;
      int i, j;
      long k, l;
      char *s;
      int size;
      ok = PyArg_ParseTuple(args, "");/* No arguments */
          /* Python call: f() */
      ok = PyArg_ParseTuple(args, "s",&s); /* A string */
          /* Possible Python call: f('whoops!')*/
      ok = PyArg_ParseTuple(args,"lls", &k, &l, &s); /* Two longs and a string */
          /* Possible Python call: f(1, 2,'three') */
      ok = PyArg_ParseTuple(args,"(ii)s#", &i, &j, &s, &size);
          /* A pair of ints and a string, whosesize is also returned */
          /* Possible Python call: f((1, 2),'three') */
      {
          char *file;
          char *mode = "r";
          int bufsize = 0;
          ok = PyArg_ParseTuple(args,"s|si", &file, &mode, &bufsize);
          /* A string, and optionally anotherstring and an integer */
          /* Possible Python calls:
             f('spam')
             f('spam', 'w')
             f('spam', 'wb', 100000) */
      }
  
      {
          int left, top, right, bottom, h, v;
          ok = PyArg_ParseTuple(args,"((ii)(ii))(ii)",
                   &left, &top,&right, &bottom, &h, &v);
          /* A rectangle and a point */
          /* Possible Python call:
             f(((0, 0), (400, 300)), (10, 10)) */
      }
  
      {
          Py_complex c;
          ok = PyArg_ParseTuple(args,"D:myfunction", &c);
          /* a complex, also providing a functionname for errors */
          /* Possible Python call:myfunction(1+2j) */
  
      }
  

  3. Py_BuildValue 创建python对象为C对象
     PyObject* Py_BuildValue( const char *format, ...)
     format：格式化字符串