Hướng dẫn are python modules written in c? - các mô-đun python được viết bằng c?

1.1. Một ví dụ đơn giảnA Simple Example¶

Hãy tạo một mô-đun mở rộng có tên

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

>>> import spam
>>> status = spam.system("ls -l")

Bắt đầu bằng cách tạo một tệp

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

Hai dòng đầu tiên của tệp của chúng tôi có thể là:

#define PY_SSIZE_T_CLEAN
#include 

trong đó kéo trong API Python (bạn có thể thêm một nhận xét mô tả mục đích của mô -đun và thông báo bản quyền nếu bạn muốn).

Ghi chú

Vì Python có thể xác định một số định nghĩa tiền xử lý ảnh hưởng đến các tiêu đề tiêu chuẩn trên một số hệ thống, bạn phải bao gồm

static PyObject *SpamError;

Bạn nên luôn định nghĩa

static PyObject *SpamError;

static PyObject *SpamError;

Tất cả các ký hiệu có thể nhìn thấy người dùng được xác định bởi

static PyObject *SpamError;

static PyObject *SpamError;

static PyObject *SpamError;

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Điều tiếp theo chúng tôi thêm vào tệp mô -đun của chúng tôi là hàm C sẽ được gọi khi biểu thức Python

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

Có một bản dịch đơn giản từ danh sách đối số trong Python (ví dụ: biểu thức đơn

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Đối số tự chỉ vào đối tượng mô-đun cho các hàm cấp mô-đun; Đối với một phương thức, nó sẽ chỉ vào thể hiện đối tượng.

Đối số ARGS sẽ là một con trỏ tới đối tượng Python Tuple chứa các đối số. Mỗi mục của tuple tương ứng với một đối số trong danh sách đối số cuộc gọi. Các đối số là các đối tượng Python - để làm bất cứ điều gì với chúng trong hàm C của chúng ta, chúng ta phải chuyển đổi chúng thành các giá trị C. Hàm

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

1.2. Intermezzo: Lỗi và ngoại lệIntermezzo: Errors and Exceptions¶

Một quy ước quan trọng trong suốt trình thông dịch Python là như sau: khi hàm bị lỗi, nó sẽ đặt một điều kiện ngoại lệ và trả về giá trị lỗi (thường là

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

API Python xác định một số chức năng để đặt các loại ngoại lệ khác nhau.

Cái phổ biến nhất là

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

Một chức năng hữu ích khác là

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

Bạn có thể kiểm tra không phá hủy liệu một ngoại lệ đã được đặt với

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

Khi một hàm F gọi một hàm khác G phát hiện ra rằng sau đó không thành công, F chính nó sẽ tự trả về giá trị lỗi (thường là

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

. Nguyên nhân của lỗi bị mất: Hầu hết các hoạt động có thể thất bại vì nhiều lý do.)

Để bỏ qua một ngoại lệ được đặt bởi một cuộc gọi chức năng không thành công, điều kiện ngoại lệ phải được xóa rõ ràng bằng cách gọi

return PyLong_FromLong(sts);

return PyLong_FromLong(sts);

Mỗi cuộc gọi

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

return PyLong_FromLong(sts);

return PyLong_FromLong(sts);

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Cũng lưu ý rằng, ngoại trừ quan trọng là

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

Cuối cùng, hãy cẩn thận để làm sạch rác (bằng cách thực hiện các cuộc gọi

Py_INCREF(Py_None);
return Py_None;

Py_INCREF(Py_None);
return Py_None;

Sự lựa chọn ngoại lệ nào để nâng cao là hoàn toàn của bạn. Có các đối tượng C trước tương ứng với tất cả các ngoại lệ Python tích hợp, chẳng hạn như

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

Py_INCREF(Py_None);
return Py_None;

Py_INCREF(Py_None);
return Py_None;

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Py_INCREF(Py_None);
return Py_None;

Py_INCREF(Py_None);
return Py_None;

Bạn cũng có thể xác định một ngoại lệ mới là duy nhất cho mô -đun của bạn. Đối với điều này, bạn thường khai báo một biến đối tượng tĩnh ở đầu tệp của bạn:

static PyObject *SpamError;

và khởi tạo nó trong chức năng khởi tạo mô -đun của bạn (

Py_INCREF(Py_None);
return Py_None;

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Lưu ý rằng tên Python cho đối tượng ngoại lệ là

Py_INCREF(Py_None);
return Py_None;

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

Cũng lưu ý rằng biến

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Chúng tôi thảo luận về việc sử dụng

>>> import spam
>>> status = spam.system("ls -l")

Ngoại lệ

Py_INCREF(Py_None);
return Py_None;

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

1.3. Quay lại ví dụ EnBack to the Example¶

Quay trở lại chức năng ví dụ của chúng tôi, bây giờ bạn sẽ có thể hiểu câu nói này:

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

Nó trả về

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Câu lệnh tiếp theo là một cuộc gọi đến hàm UNIX

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Hàm

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

return PyLong_FromLong(sts);

return PyLong_FromLong(sts);

Trong trường hợp này, nó sẽ trả về một đối tượng số nguyên. (Vâng, ngay cả các số nguyên là đối tượng trên đống trong Python!)

Nếu bạn có hàm C trả về không có đối số hữu ích (hàm trả về

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Py_INCREF(Py_None);
return Py_None;

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

1.4. Bảng phương thức mô -đun và chức năng khởi tạoThe Module’s Method Table and Initialization Function¶

Tôi đã hứa sẽ chỉ ra cách

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Lưu ý mục thứ ba (

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Khi chỉ sử dụng

>>> import spam
>>> status = spam.system("ls -l")

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Bit

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Bảng phương thức phải được tham chiếu trong cấu trúc định nghĩa mô -đun:

>>> import spam
>>> status = spam.system("ls -l")

Cấu trúc này, đến lượt nó, phải được chuyển cho trình thông dịch trong chức năng khởi tạo mô -đun. Hàm khởi tạo phải được đặt tên

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Lưu ý rằng pymodinit_func tuyên bố hàm là loại trả về

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Khi chương trình Python nhập mô -đun

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

Py_INCREF(Py_None);
return Py_None;

>>> import spam
>>> status = spam.system("ls -l")

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

>>> import spam
>>> status = spam.system("ls -l")

Khi nhúng Python, hàm

Py_INCREF(Py_None);
return Py_None;

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Ghi chú

Loại bỏ các mục từ

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Một mô -đun ví dụ đáng kể hơn được bao gồm trong phân phối nguồn Python là

>>> import spam
>>> status = spam.system("ls -l")

Ghi chú

Loại bỏ các mục từ

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Một mô -đun ví dụ đáng kể hơn được bao gồm trong phân phối nguồn Python là >>> import spam >>> status = spam.system("ls -l") 52. Tệp này có thể được sử dụng làm mẫu hoặc đơn giản là đọc làm ví dụ.Compilation and Linkage¶

Không giống như ví dụ

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Nếu bạn có thể sử dụng tải động, hoặc nếu bạn muốn biến mô -đun của mình thành một phần vĩnh viễn của trình thông dịch Python, bạn sẽ phải thay đổi thiết lập cấu hình và xây dựng lại trình thông dịch. May mắn thay, điều này rất đơn giản trên UNIX: Chỉ cần đặt tệp của bạn (ví dụ

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    return PyLong_FromLong(sts);
}

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

và xây dựng lại thông dịch viên bằng cách chạy thực hiện trong thư mục Toplevel. Bạn cũng có thể chạy Make trong thư mục con

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

>>> import spam
>>> status = spam.system("ls -l")

Nếu mô -đun của bạn yêu cầu các thư viện bổ sung để liên kết, chúng cũng có thể được liệt kê trên dòng trong tệp cấu hình, ví dụ::

1.6. Gọi các chức năng Python từ C¶Calling Python Functions from C¶

Cho đến nay, chúng tôi đã tập trung vào việc làm cho các chức năng C có thể gọi từ Python. Điều ngược lại cũng hữu ích: gọi các hàm Python từ C. Điều này đặc biệt là trường hợp của các thư viện hỗ trợ các chức năng gọi lại của các cuộc gọi lại. Nếu giao diện C sử dụng các cuộc gọi lại, Python tương đương thường cần cung cấp cơ chế gọi lại cho lập trình viên Python; Việc triển khai sẽ yêu cầu gọi các chức năng gọi lại Python từ gọi lại C. Công dụng khác cũng có thể tưởng tượng được.

May mắn thay, trình thông dịch python dễ dàng được gọi là đệ quy và có một giao diện tiêu chuẩn để gọi hàm python. .

Gọi một chức năng Python là dễ dàng. Đầu tiên, chương trình Python bằng cách nào đó phải chuyển cho bạn đối tượng chức năng Python. Bạn nên cung cấp một chức năng (hoặc một số giao diện khác) để làm điều này. Khi hàm này được gọi, hãy lưu một con trỏ vào đối tượng chức năng Python (hãy cẩn thận với

if (!PyArg_ParseTuple(args, "s", &command))
    return NULL;

>>> import spam
>>> status = spam.system("ls -l")

Hàm này phải được đăng ký với trình thông dịch bằng cờ

>>> import spam
>>> status = spam.system("ls -l")

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

PyMODINIT_FUNC
PyInit_spam(void)
{
    PyObject *m;

    m = PyModule_Create(&spammodule);
    if (m == NULL)
        return NULL;

    SpamError = PyErr_NewException("spam.error", NULL, NULL);
    Py_XINCREF(SpamError);
    if (PyModule_AddObject(m, "error", SpamError) < 0) {
        Py_XDECREF(SpamError);
        Py_CLEAR(SpamError);
        Py_DECREF(m);
        return NULL;
    }

    return m;
}

Các macro

>>> import spam
>>> status = spam.system("ls -l")

Py_INCREF(Py_None);
return Py_None;

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}

static PyObject *
spam_system(PyObject *self, PyObject *args)
{
    const char *command;
    int sts;

    if (!PyArg_ParseTuple(args, "s", &command))
        return NULL;
    sts = system(command);
    if (sts < 0) {
        PyErr_SetString(SpamError, "System command failed");
        return NULL;
    }
    return PyLong_FromLong(sts);
}