关键的区别在于可以从哪里调用函数:def可以从Python和Cython调用函数,而cdef可以从Cython和C调用函数
这两种类型的函数都可以用类型化参数和非类型化参数的任意组合来声明,在这两种情况下,内部函数都由Cython编译为C(编译的代码应该非常非常类似):# A Cython class for illustrative purposes
cdef class C:
pass
def f(int arg1, C arg2, arg3):
# takes an integer, a "C" and an untyped generic python object
pass
cdef g(int arg1, C arg2, arg3):
pass
在上面的例子中,f对于Python是可见的(一旦它导入了Cython模块),并且g不会也不能从Python调用。g将转换为C签名:PyObject* some_name(int, struct __pyx_obj_11name_of_module_C *, PyObject*)
(其中struct __pyx_obj_11name_of_module_C *只是类C转换成的C结构)。例如,这允许它作为函数指针传递给C函数。相反,不能(容易地)从C调用f
对cdef函数的限制:
不能在其他函数中定义cdef函数-这是因为无法在C函数指针中存储任何捕获的变量。E、 g.下列代码是非法的:# WON'T WORK!
def g(a):
cdef (int b):
return a+b
cdef函数不能接受*args和**kwargs类型参数。这是因为它们不容易被转换成C签名。
函数的优点
cdef函数可以接受任何类型的参数,包括那些没有Python等价的参数(例如指针)。def函数不能有这些,因为它们必须可以从Python调用。
cdef函数还可以指定返回类型(如果未指定返回类型,则返回Python对象,PyObject*在C中)。def函数总是返回一个Python对象,因此不能指定返回类型:cdef int h(int* a):
# specify a return type and take a non-Python compatible argument
return a[0]
cdef函数比def函数调用更快,因为它们转换为简单的C函数调用。
cpdef函数
cpdef函数使Cython生成一个cdef函数(允许Cython快速调用函数)和一个def函数(允许您从Python调用它)。在内部,def函数只调用cdef函数。就允许的参数类型而言,cpdef函数具有cdef和def函数的所有限制。
何时使用cdef函数
一旦调用了该函数,在cdef函数和def函数中的代码运行速度就没有区别。因此,只有在以下情况下才使用cdef函数:您需要传入或传出非Python类型,或者
您需要将它作为函数指针传递给C,或者
您经常调用它(因此加速函数调用很重要),不需要从Python调用它。
当您经常调用一个cpdef函数(因此加速函数调用很重要),但您确实需要从Python调用它。