Skip to content

pxd 文件

原文： http://docs.cython.org/en/latest/src/tutorial/pxd_files.html

除了.pyx源文件之外，Cython 还使用.pxd文件，它们的工作方式类似于 C 头文件 - 它们包含 Cython 声明（有时是代码部分），仅供 Cython 模块使用。在pyx模块可以使用cimport关键字将pxd文件导入。

pxd文件有很多使用场景：

  1. 它们可用于共享外部 C 声明。

  2. 它们可以包含非常适合 C 编译器内联的函数。这些功能应标记为inline，例如：

    ```py cdef inline int int_min(int a, int b): return b if b < a else a

    ```

  3. 当附带同名的pyx文件时，它们为 Cython 模块提供了一个 Cython 接口，以便其他 Cython 模块可以使用比 Python 更高效的协议与之通信。

在我们的积分函数案例中，我们可能会将其分解为多个pxd文件，如下所示：

  1. 添加cmath.pxd，定义 C math.h头文件中可用的 C 函数，如sin。以后仅需在integrate.pyx中做from cmath cimport sin即可使用。

  2. 添加integrate.pxd，以便用 Cython 编写的其他模块可以快速的自定义积分函数。

    ```py cdef class Function: cpdef evaluate(self, double x) cpdef integrate(Function f, double a, double b, int N)

    ```

    请注意，如果您的 cdef 类具有属性，则必须在类声明pxd文件（如果使用）中声明属性，而不是pyx文件。编译器会告诉你这个。

__init__.pxd

Cython也支持使用__init__.pxd文件来在包命名空间内进行声明，就像是Python中的__init__.py文件一样。

接着积分函数这个例子说，我们可以通过如下方式将模块代码打包。

  1. 将模块文件放在一个目录树下，就像是Python中一样。 bash CyIntegration/ __init__.pyx __init__.pxd integrate.pyx integrate.pxd

  2. 在__init__.pxd文件中，使用cimport引入需要在包命名空间中可见的声明

    py from CyIntegration cimport integrate 这样，其他模块就可以通过cimport这个包来通过Cython的方式更快的访问包内容和数据。

回到顶部